Itential Automation GatewayExecutable objects and services

Create an executable object

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: