Defining a new custom capability

Custom capabilities can be used to control which jobs will be built by a particular agent, since agent capabilities are required to match job requirements. For example, if the builds for a particular job should only run in a Windows environment, you could create a custom capability 'operating.system=WindowsXP' for the appropriate agent(s), and specify it as a requirement for this job.(See Configuring a job's requirements.)You can define a custom capability that is:

(info) Note that the value of an agent-specific capability overrides the value of a shared capability of the same name (if one exists).

On this page:


Defining an agent-specific custom capability

To define a new agent-specific custom capability:

  1. Navigate to the desired agent.
  2. From the Agent-specific capabilities section select Add capability.
  3. Select Capability type > Custom.
  4. Specify values for Key and Value.
  5. Select Add.

Agent-specific custom capability configuration

Defining a local server custom capability

Local server capabilities are inherited by all local agents.

To define a new local server custom capability:

  1. From the top navigation bar select cogwheel icon > Build resources > Server capabilities.
  2. Specify values for Key and Value.
  3. Select Add.

Defining a shared remote custom capability

Shared remote custom capabilities are not shared with elastic agents.

To define a new shared remote custom capability:

  1. From the top navigation bar select cogwheel icon > Build resources > Agents.
  2. In the Remote agents section select Shared remote capabilities.
  3. In the Add capability section select Capability typeCustom.
  4. Specify values for Key and Value.
  5. Select Add.
Last modified on Mar 5, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.