This is the documentation for Bamboo 5.8. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

このページでは、ジョブの要件を設定する方法について説明します。

A requirement is specified in a job or a task. A requirement specifies a capability that an agent must have for it to build that job or task. A job inherits all of the requirements specified in its tasks.

Together, capabilities and requirements control which agents can execute builds for particular jobs. Each job can only be built by agents whose capabilities match the job's requirements.

Bamboo には、ジョブやタスクの要件によって指定できる 4 種類の機能があります。

ジョブの要件を指定する前に、まず Bamboo システムでその機能を定義する必要があります。

ジョブの追加要件を指定する

既定では、ジョブはそのタスクの要件を継承します。ただし、ジョブには、そのタスクの要件に加えて、追加要件を指定することもできます。


ジョブの追加要件を指定するには、次の手順に従います。

  1. Navigate to the desired job's configuration pages, as described on Configuring jobs.
  2. Click the Requirements tab (see screenshot below). This page shows a list of all the job's current requirements and the number of 'Matching Agents' and 'Matching Images' (i.e. agents/elastic images which meet the job's requirements and can run a build for this job). See Viewing current capable agents below for more information.
  3. If you have previously set up an agent capability, you can select it from the Requirement list in the 'Add Extra Requirement' section. If you are setting up a new custom requirement, select New custom requirement from that list instead.
  4. 要件のフォームに次の情報を入力します。
    1. Key (キー) (新しいカスタム要件のみ) — 新しい機能のキーを入力します。
    2. リストから要件の値を選択します。
      • exists (存在する) — このジョブは、同じキーを持つ機能を備えたすべてのエージェントがビルドできます。
      • equals (等しい) — このジョブは、同じキーと値を持つ機能を備えたすべてのエージェントがビルドできます。
      • matches — this job can be built by any agent that has a capability with the same key, and the value matches the regular expression.  For more information about regular expressions, see Oracle's tutorial on regular expressions.
  5. [Add (追加)] をクリックします。指定した新しいカスタム要件を満たす機能を備えたエージェントのみがプランをビルドできるようになったため、「一致するエージェント」と「一致するイメージ」の数が更新されます。

スクリーンショット: ジョブの要件の指定


現在対応可能なエージェントを表示する

現在ジョブをビルドできるエージェントまたはエラスティック イメージの詳細を表示するには、次の手順に従います。

  1. On the job's Requirements tab (described above), click the name of the requirement in the table (e.g. 'Maven 2').
  2. The summary page for the capability will be displayed, showing the agents and elastic images that have the capability. See Viewing a capability's agents and jobs for more information.