Automation endpoints are servers or containers that are capable and responsible for executing a workflow.
They contain the automation scripts and their corresponding orchestration tools (for example Ansible, Terraform, Packer, Powershell,…).
Automation handlers are related to a single automation tool and contain the instructions required for the proxy agent to invoke commands to the automation endpoint. Automation handlers are written in python.
The following type objects exist within the configuration store. Each type object is constructed and stored as a JSON document and requires the following mandatory key/value pairs:
Type: defines the types of the object
Name: defines the name of the object. The name property must be unique within the tree structure.
Description: defined the description of the object
The purpose of an object type is to describes its uniqueness in terms of configuration data.
The proxy agent maintains a connection over https port 8888 to the STACKL.IO platform and listens to instructions it receives from the process queue. The proxy agent’s primary reason is to forward CRUD operations to the automation endpoints for execution.
The proxy agent can have a tag associated with it ( see Clients Endpoint.
The purpose of this tag is control which proxy agent picks up events generated by STACKL.IO. The proxyTag key ( see section Special Key/Value Pairs for more information) can then be used within the tree structure to define which proxy agent is responsible for processing instructions.
Special Key/Value Pairs
STACKL.IO has several key with a specific meaning and purpose, the following table details the key/value pairs and their purpose.
Key Type Default Description proxyTag string none every proxy agent at registration time can register a tag. This way we you can granular control which proxy agent picks up the instructions from the queue. The proxyTag can be specified on any object within the tree structure and can be used multiple times automationHandler string none controls the automation handler plugin the proxy agent will use.