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
      • Create a service
      • View service details
      • Python virtual environments
      • Configure dependency registries
      • Validate service inputs with decorators
      • Inject secrets into services
      • Add services to workflows
    • Inventory Manager
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • How it works
  • Create a gateway service
  • Examples
Itential Automation GatewayGateway services

Create gateway services

Was this page helpful?
Previous

View service details

Next
Built with

Itential Automation Gateway (IAG) provides a powerful framework for transforming your existing automation content into reusable services that can be orchestrated across your organization. By importing automation content from Git repositories, IAG packages your scripts, playbooks, and infrastructure-as-code into standardized services that integrate seamlessly with the Itential Platform.

Supported service types

  • Ansible playbooks
  • Python scripts
  • OpenTofu plans

If you need to run a Python script as part of a single workflow without creating a reusable service, consider using the runCode task directly in Studio. The runCode task lets you write and execute inline Python code directly on the canvas—no Git repository or service registration required. For more information, see runCode.

How it works

  1. Repository integration: IAG connects to your Git repositories containing automation content
  2. Service creation: Define services that reference specific automation assets
  3. Gateway Manager registration: Services are automatically discovered and advertised to the Itential Platform
  4. Workflow execution: Itential Platform can invoke these services as part of larger automation workflows

Create a gateway service

Use the iagctl create service command to create gateway services. For more information, see iagctl create service in the command reference.

Examples

The following examples create gateway services that reference automation assets configured in a repository called gateway-resources.

The gateway-resources repository has the following structure:

├── README.md
├── ansibleplaybooks
│   ├── hello-world.yml
│   ├── requirements.txt
│   └── requirements.yml
├── pythonscripts
│   ├── main.py
│   └── requirements.txt
└── opentofuplans
    └── main.tf
Ansible
Python
OpenTofu

Use iagctl create service ansible-playbook to create an Ansible Playbook service.

The following example creates an Ansible playbook service called simple-ansible.

$iagctl create service ansible-playbook simple-ansible --repository gateway-resources --working-dir ansibleplaybooks --playbook hello-world.yml

For more information, see iagctl create service ansible-playbook in the command reference.