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
  • Build a workflow with gateway services
  • Step 1: Add the Run Service task to your canvas
  • Step 2: Configure the Run Service task
  • Set input parameters
  • Define gateway cluster and service variables
Itential Automation GatewayGateway services

Add gateway services to workflows

Was this page helpful?
Previous

Git repositories in IAG

Next
Built with

With IAG configured and your gateway services registered, you can now use the Itential Platform to orchestrate these services through intuitive workflows that simplify complex network operations.

Build a workflow with gateway services

The following procedures provide a high-level overview for adding a service to a new workflow. For additional guidance, see the following topics:

  • For more information on variable sources, see Variable types.
  • For more information on workflows, see Create and run workflows.
  • For more information on tasks, see Configure and manage tasks.

Step 1: Add the Run Service task to your canvas

1

Open Itential Platform in your browser.

2

Select Studio from the Design collection in the left-side navigation menu.

3

Click the plus (+) icon on the Studio homepage.

4

Select Workflow in the type dropdown in the Create dialog.

5

Enter a name for your new workflow.

6

Click Create. The workflow opens in the Canvas.

7

In the Task Palette, expand the GatewayManager section and find the Run Service task.

8

Drag the Run Service task onto the canvas between the Start and End nodes.

9

Create connections by drawing transitions from Start to the Run Service task, and from the Run Service task to End.

Step 2: Configure the Run Service task

Double-click the Run Service task to open the task panel.

From the Run Service task panel, you can specify the gateway cluster and gateway service on that cluster that you want to include in your workflow.

When you select a service with decorators attached, the task extracts the expected input variables from the decorator and lists them as input parameters. For more information on decorators, see Using Decorators.

Set input parameters

You can supply input parameters through a key-value form or as a JSON code block.

Key-value form (default): The task panel displays input parameters in a key-value form where you configure each variable defined in your decorator individually. You can configure the variable source (static, job, or task) and specify static key-value pairs.

Key-value form in task configuration panel

JSON code block: To define input parameters as a single JSON code block, select JSON Code Block under Parameters in the task panel.

JSON code block in task configuration panel

Define gateway cluster and service variables

You can use the Gateway Cluster ID and Service Name fields to specify which gateway cluster and service you want to run, or you can define the Gateway Cluster ID and service as input variables that receive data from elsewhere in the workflow.

To use as variables:

  1. Enable the Gateway Cluster ID & Service: Use as Variable toggle at the top of the task panel.
  2. Define the source for the gateway cluster ID and service variables as static, job, or task to determine how these values will be passed to the Run Service task.
Use as Variable toggle in task configuration panel