For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationCommand referenceRelease notes
DocumentationCommand referenceRelease notes
  • Itential Automation Gateway
    • Overview
    • Execution engine
    • Concepts
    • Feature comparison
    • IAG secret store
      • Overview
      • Create an executable object
      • Manage executable objects
      • Use executable objects with services
    • Inventory Manager
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Prerequisites
  • Create an executable object with basic settings
  • Create an executable object with a description
  • Additional examples
  • Next steps
Itential Automation GatewayExecutable objects and services

Create an executable object

Was this page helpful?
Previous

Manage executable objects

Next
Built with

You can create an executable object to define a reusable execution command for services. Executable objects allow you to specify the full path to an executable file and configure security settings like allowed arguments and path validation.

Prerequisites

  • The executable file must exist on your system at the specified path
  • You must know the full path to the executable file

Create an executable object with basic settings

Use the iagctl create executable-object command to create a new executable object.

Syntax:

$iagctl create executable-object <name> \
> --exec-command <path-to-executable>

Parameters:

  • <name>: A unique name for the executable object
  • --exec-command: The full path to the executable file on your system

Example:

Create an executable object for Python 3.11:

$iagctl create executable-object python311-standard \
> --exec-command /usr/bin/python3.11

Create an executable object with a description

Add a description to help operators understand the purpose of the executable object.

Syntax:

$iagctl create executable-object <name> \
> --exec-command <path-to-executable> \
> --description "<description-text>"

Example:

$iagctl create executable-object python311-standard \
> --exec-command /usr/bin/python3.11 \
> --description "Python 3.11 interpreter with standard configuration"

Additional examples

Create an executable object for Terraform:

$iagctl create executable-object terraform-latest \
> --exec-command /usr/local/bin/terraform \
> --description "Terraform for infrastructure automation"

Create an executable object for a custom script interpreter:

$iagctl create executable-object node-v18 \
> --exec-command /usr/local/bin/node \
> --description "Node.js version 18 runtime"

Create an executable object for Python with conda:

$iagctl create executable-object python-conda \
> --exec-command /opt/conda/bin/python \
> --description "Python from conda environment"

Next steps

After you create an executable object, you can:

  • View the executable object to confirm its configuration
  • Use the executable object to create an executable service
  • Use the executable object to create a Python service with a custom interpreter