Elastic Bamboo の使用を開始する

1. 重要なドキュメントを読む

Elastic Bamboo を最初に使用する場合は、まず次の重要なドキュメントを読むところから始めることを強くお勧めします。

• About Elastic Bamboo — This high-level overview explains the key concepts behind the Elastic Bamboo feature.
• Elastic Bamboo Security — We strongly recommend that you read this document to understand the security implications of enabling Elastic Bamboo. This includes important information on securing your version control system (VCS) for use with Elastic Bamboo.
• Elastic Bamboo Costs — Elastic Bamboo sources resources from the Amazon Elastic Compute Cloud (EC2) which are charged separately to your Bamboo license fee. We recommend that you read this document to understand how you will be charged for using Elastic Bamboo.

2. Elastic Bamboo を有効化して設定する

Elastic Bamboo の概念、セキュリティへの影響、コストを理解したら、Bamboo インストールで Elastic Bamboo を有効化して設定します。また、Elastic Bamboo を正しく動作させるために、バージョン管理システム (VCS) を Amazon で利用できるようにする必要があります。

2.1. Elastic Bamboo を有効化する

Elastic Bamboo を有効化する方法は次のとおりです。

1. Bamboo でリモート エージェント サポートを有効化します。リモート エージェント サポートを無効にしている場合は、Elastic Bamboo を有効化する前に、リモート エージェント サポートを有効にする必要があります。 

   The Disabling and enabling remote agents support documentation also contains instructions on how to enable remote agent support.
2. Bamboo で、上部メニュー バーの [管理] をクリックします。
3. 左側のナビゲーション パネルの [設定] ([Elastic Bamboo] の下) をクリックします。"Elastic Bamboo の設定" 画面が表示されます。
4. [有効化] をクリックします。

2.2) にアップグレードする場合に大変便利です。Elastic Bamboo の設定

Elastic Bamboo を使用するには、「Elastic Bamboo の設定」ドキュメントに記載されている説明に沿って設定する必要があります。これは次のとおり、3 ステップの簡単なプロセスです。

1. アマゾン ウェブ サービスのアカウントの詳細を入力します。
2. Elastic Bamboo のグローバル設定を構成します。
3. エラスティック インスタンス設定を構成します。

• Read the Configuring Elastic Bamboo document.

2.3. VCS へのアクセスを提供する

Elastic Bamboo を使用してジョブ ビルドを実行するには、Amazon でバージョン管理システムを利用できるようにする必要があります。これは、特に VCS がファイアウォール内にある場合に、セキュリティに影響を及ぼします。

• Read the Elastic Bamboo Security document for further instructions, if you have not read it already.

3. エラスティック インスタンスを起動する

これで、Bamboo インストールの Elastic Bamboo を有効化して設定が完了したので、Elastic Bamboo を使って計画の構築を試すことができます。Bamboo 管理コンソールを使用して、エラスティック インスタンスを手動で起動できます。エラスティック インスタンスを起動すると、そのインスタンスでエラスティック エージェント プロセスが自動的に開始されます。

• Read about starting an elastic instance

4. 計画ビルドを実行する

To run a plan build on your elastic agent, you must set up a plan with its Default Job (plus any other optional jobs) all of whose requirements can meet your elastic agent's capabilities. Elastic agents inherit the capabilities of the image they are started from. We recommend that you use the Bamboo default image to start with.

• Read about the capabilities of the default image.

For the purposes of this guide, you should set up your plan so that its jobs' requirements can only be met by the elastic agent's capabilities. This will ensure that the jobs' builds run on your elastic agent. If you cannot set up your jobs' requirements to meet your elastic agent's capabilities, you can customise your elastic agent's capabilities to add a unique custom capability, e.g. 'elastic=true').

• Read about configuring the capabilities of elastic agents.

Job builds on elastic agents are run just like job builds on any other agent. You will see the progress of your build on your dashboard and can view the build result when it has completed.

Tip: You can significantly reduce the costs and time taken to run a job build by configuring Elastic Bamboo to use Amazon's Elastic Block Store (EBS).

5. エラスティック インスタンスをシャットダウンする

When your job builds successfully, shut down your elastic instance. As described in Elastic Bamboo Costs, the bulk of your Elastic Bamboo costs are from instance uptime. We strongly recommend that you shut down your elastic instances when not in use.

• Read about shutting down an elastic instance.

エラスティック インスタンスをシャットダウンすると、実行中のエージェント プロセスが終了することにご注意ください。つまり、エラスティック エージェントは、オンラインでない限り、Bamboo の "エージェント" ページに表示されません。終了されたエラスティック エージェントに関する情報を表示する場合は、エラスティック エージェントの使用履歴でそのエージェントを確認できます。

• Read about viewing your elastic agent usage history.

おめでとうございます。Elastic Bamboo を使ったジョブ ビルドのセットアップと実行が正常に完了しました。

更に詳しい情報

Elastic Bamboo のジョブ ビルド処理の管理と改善に役立つ、次の関連トピックを参照することをお勧めします。

• Managing your elastic images, Managing your elastic instances, Managing your elastic agents — information hubs for managing Elastic Bamboo images, instances and agents.
• Running job builds using Elastic Bamboo — general questions about running builds using Elastic Bamboo.
• Configuring elastic instances to use the EBS — information on configuring Elastic Bamboo to use the Amazon Elastic Block Store (EBS) to improve job build times.