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

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

Elastic Bamboo allows you to use computing resources from the Amazon Elastic Compute Cloud (EC2) to run builds. Elastic Bamboo uses a remote agent AMI (Amazon Machine Image) to create instances of remote agents in the Amazon EC2. 

Builds run on these 'elastic agents' in a similar way to how they run on local and remote agents.

(warning) If you have disabled remote agent support, you must enable it before you can enable Elastic Bamboo. Refer to Disabling and enabling remote agents support for instructions on how to enable remote agent support.

 

Amazon Web Services （AWS）アカウント詳細または Elastic Bamboo の設定を設定する方法：

  1. Click the  icon and select Overview.
  2. 左側のナビゲーション パネルの [設定] ([Elastic Bamboo] の下) をクリックします。

  3. 編集をクリックします。

  4. 以下のセクションの説明に従って設定します。
  5. 終了したら [保存] をクリックします。

On this page:

関連ページ

AWS アカウント設定

Before you use Elastic Bamboo for the first time in your Bamboo instance, you must enter your Amazon Web Services (AWS) account details into the Bamboo application. If you do not have an AWS account, you must register for one on the AWS registration page before you can enable Elastic Bamboo.

始める前に

  • Please note, Elastic Bamboo dynamically creates and runs remote agents in the Amazon Elastic Compute Cloud (EC2). Hence, if you choose to use Elastic Bamboo, you will be charged by Amazon for your EC2 compute usage (separately to your Bamboo license fee). These charges will be billed to the AWS account that you provide. Please read Elastic Bamboo Costs for more details.
  • AWS アカウントの詳細を変更すると、Bamboo は現在実行中のエラスティック エージェントをすべて停止します。

AWS アカウントの詳細を設定する方法は次のとおりです。

  1. Enter or update your AWS Access Key ID (you can get the "AWS Access Key ID" and "AWS Secret Access Key" if you go to your account: "My Account/Console" > Security Credentials).
  2. To enter or update your AWS Secret Access Key, select the Change AWS Secret Access Key? checkbox, and enter or update AWS Secret Access Key.
  3. 保存をクリックします。

Note that your AWS Access Key ID and AWS Secret Access Key are used together to identify you when accessing Amazon EC2 services. If you are unsure what your AWS Account ID and AWS Secret Access Key are, please refer to the Amazon documentation on AWS access identifiers.

グローバル設定

Elastic Bamboo provides you with a number of global configuration options to help you optimise EC2 usage for your Bamboo job builds. These settings control how the Bamboo server operates and how it manages its elastic instances and agents.

エラスティック インスタンスの最大数一度に実行できるエラスティック インスタンスの数。EC2 のコンピューティング コストが心配で、非エラスティック エージェントではサポートできない同時実行ジョブのビルドが多数ある場合は、この値を小さくすることをお勧めします。
エラスティック エージェント プロセスの終了時に自動的にエラスティック インスタンスを終了する

エラスティック インスタンスで実行されているエラスティック エージェントのプロセスが終了した後に、エラスティック インスタンスが自動的にシャットダウンするかどうかを制御します。

  • シャットダウンの遅延 — エラスティック エージェントのプロセスが終了した後、エラスティック インスタンスがシャットダウンするまでの待機時間を制御します。

 

EC2 スポット インスタンス

Elastic Bamboo provides support for Amazon EC2 Spot Instances. Amazon spot instances allow you to bid on unused EC2 capacity and use it, as long as your bid exceeds the current "Spot price". You can configure Elastic Bamboo to bid for a spot instance of a particular type, and fall back to a regular instance after a set amount of time if no instances are available.

スポット インスタンスのサポートを有効化スポット インスタンスのサポートを有効にするには、このチェックボックスを選択します。
後で通常のインスタンスにフォールバックスポット インスタンスが使用できなくなった場合に、Elastic Bamboo が通常のインスタンスの使用にフォールバックするまでの時間 (分単位)。
現在の価格レベル (1 時間あたり)Fill out this table with your bids. The bids are categorised by EC2 instance type and operating system.

AWS 設定

These settings allow you to specify your AWS configuration settings in Bamboo so that Bamboo can operate elastic instances through your AWS account. This section includes settings that are used to configure elastic instances to work with the Amazon Elastic Block Store (EBS).

Using EBS with your elastic instances can significantly reduce the amount of data transfer required to run a job build, compared with starting a clean elastic instance. To find out more about this feature and how to set it up in Elastic Bamboo, read Configuring elastic instances to use the EBS.

AWS アカウント識別子を新しいエラスティック インスタンスにアップロードSelect to upload the AWS Account Private Key File and Account Certificate File to all new elastic instances started. This is mandatory if you wish to use EBS to store job build information in a snapshot. However, you can also check this option if you are not using EBS (e.g. if you wish upload the AWS account identifiers in order to use Amazon's AWS command line tools).
キー ファイルの場所非公開キーと証明書の提供方法を選択します。
アカウント非公開キー ファイル

Elastic Bamboo と共に Amazon EBS を使用するには、このファイルの場所を指定する必要があります。このファイルは Amazon によって生成されます。

アカウント証明書ファイルElastic Bamboo と共に Amazon EBS を使用するには、このファイルの場所を指定する必要があります。このファイルは Amazon によって生成されます。

(info) If you haven't downloaded an AWS private key file or certificate file to your Bamboo server yet, please see Generating your AWS Private Key File and Certificate File for instructions.

自動エラスティック インスタンス管理

The Automatic Elastic Instance Management feature allows Bamboo to start and shut down elastic instances automatically (based on build queue demands), so that you do not have to perform these action manually. This feature reduces Bamboo administration overhead and can help minimise your overall elastic instance usage costs.

利用可能なオンライン エージェントでジョブの要件を満たせない場合、この機能により、ジョブを実行する機能を備えたエラスティック エージェントを持つすべてのエラスティック インスタンスが起動し、ジョブのビルドを生成できます。エラスティック インスタンスの起動方法にかかわらず、すべてのエラスティック インスタンスは以下に指定された設定に基づいてシャットダウンされます。

Choose from the following elastic instance management presets. Each of these presets define values for the five criteria described in the 'Custom' user-defined options (below). (Bear in mind that both the 'Aggressive' and 'Passive' presets have trade-offs.)

  • 初期設定 — ビルド キューのクリアランス率とエラスティック インスタンスの使用コストのバランスを保ちます。
  • Aggressive — Favours higher build queue clearance rates but with higher elastic instance usage costs.
  • Passive — Favours lower instance usage costs but with lower build queue clearance rates.
  • カスタム — 以下に説明するように独自の設定を選択します。
  • 無効 — Bamboo の自動エラスティック インスタンス管理機能を無効にします。
アイドル状態のエージェントのシャットダウン遅延Specify the number of minutes that an elastic agent must be idle before Bamboo shuts down the elastic instance running that agent.
(info) Elastic instances running in the Amazon EC2 compute cloud are charged in hourly blocks from the time they are started. To maximise usage of elastic instances in a cost-effective manner, Bamboo only performs these checks just prior to the expiry of each hourly block.
許可された Bamboo 以外のインスタンスこの Bamboo インスタンスによって制御されない AWS アカウントで許可されるエラスティック インスタンスの最大数です。この制限を超えた場合、Bamboo は新しいインスタンスを起動できなくなります。
一度に起動できるインスタンスの最大数Bamboo が一度に起動できるエラスティック インスタンスの最大数。Bamboo で「1 分あたり」にエラスティック インスタンスのこの最大数のみが起動されます。
キュー内のビルド数のしきい値キュー内にあるビルドの総数。このしきい値と他のしきい値すべてに到達すると、新しいエラスティック インスタンスが起動します。
キュー内のエラスティック ビルド数のしきい値エラスティック インスタンスで実行できるキュー内のビルドの数。このしきい値と他のしきい値すべてに到達すると、新しいエラスティック インスタンスが起動します。
平均キュー時間しきい値ジョブ ビルドがキューで待機している平均分数。このしきい値と他のしきい値すべてに到達すると、新しいエラスティック インスタンスが起動します。
  • ラベルなし

 

 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.