Create an executable object

  • Published on Feb 12, 2026
Prev Next

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