Add capabilities to chains

Use capabilities in a chain to restrict which agents can run the chain.

Prerequisite: Add capabilities to agents

Capabilities describe an agent's environment, for example, a specific operating system or high memory. You can add one or more capabilities to a chain. As a result, the chain runs only on those agents whose capabilities match the chain's capabilities.

Example: If a chain requires Windows Server 2019 and 64 GB of memory, add WindowsServer2019 and 64gbMemory as capabilities on the chain. When the chain runs, it matches its capabilities with those of available agents. The chain can run only on the agents that have both WindowsServer2019 and 64gbMemory capabilities.

To add capabilities to a chain:

  1. On the top navigation bar, select a space from the spaces list.

  2. On the Products page, select the product or Git repository where the chain is located.

  3. On the sidebar, select Chains.

  4. In the chain list, click a chain's name to open the chain.

  5. On the chain page, click Edit.

  6. In the chain's editing window, select the Options tab.

  7. In the Required Capabilities field, enter one or more capabilities. Separate each label with a comma. Leave empty to run the chain on any agent.

    Note: When using mandatory agent capabilities, enter labels without a plus sign (+). For example, to reference an agent's +WindowsServer2019 mandatory capability, enter WindowsServer2019.

  8. Click Save.

Back to top

See also: