Elastic Bamboo の使用を開始する
このページの内容
1. 重要なドキュメントを読む
Elastic Bamboo を最初に使用する場合は、まず次の重要なドキュメントを読むところから始めることを強くお勧めします。
- 「Elastic Bamboo について」 — この概要では、Elastic Bamboo の機能を支える重要な概念について説明します。
- 「Elastic Bamboo のセキュリティ」 — Elastic Bamboo の有効化によるセキュリティへの影響を理解するには、このドキュメントを読むことを強くお勧めします。このドキュメントには、Elastic Bamboo で使用されるバージョン管理システム (VCS) のセキュリティ保護に関する重要な情報が記載されています。
- 「Elastic Bamboo のコスト」 — Elastic Bamboo は、Amazon Elastic Compute Cloud (EC2) からリソースを調達します。こうしたリソースは、Bamboo のライセンス料金とは別に請求されます。Elastic Bamboo を使用する場合の請求について理解するには、このドキュメントを読むことをお勧めします。
2. Elastic Bamboo を有効化して設定する
Elastic Bamboo の概念、セキュリティへの影響、コストを理解したら、Bamboo インストールで Elastic Bamboo を有効化して設定します。また、Elastic Bamboo を正しく動作させるために、バージョン管理システム (VCS) を Amazon で利用できるようにする必要があります。
2.1. Elastic Bamboo を有効化する
Elastic Bamboo を有効化する方法は次のとおりです。
Enable remote agent support in Bamboo — if you have disabled remote agent support, you must enable it before you can enable Elastic Bamboo. The Disabling and enabling remote agents support documentation also contains instructions on how to enable remote agent support.
- From the Bamboo top navigation bar select
> Elastic Bamboo > Configuration. - [有効化] を選択します。
2.2) にアップグレードする場合に大変便利です。Elastic Bamboo の設定
Before you can use Elastic Bamboo, you must configure it as detailed in the Configuring Elastic Bamboo document. This is a simple three-step process:
- Provide your Amazon Web Services account details.
- Configure your Elastic Bamboo global settings.
- Configure your elastic instance settings.
- Read the Configuring Elastic Bamboo document.
2.3. VCS へのアクセスを提供する
Elastic Bamboo を使用してジョブ ビルドを実行するには、Amazon でバージョン管理システムを利用できるようにする必要があります。これは、特に VCS がファイアウォール内にある場合に、セキュリティに影響を及ぼします。
- まだ読んでいない場合は、「Elastic Bamboo のセキュリティ」に関するドキュメントで詳しい説明をご確認ください。
3. エラスティック インスタンスを起動する
これで、Bamboo インストールの Elastic Bamboo を有効化して設定が完了したので、Elastic Bamboo を使って計画の構築を試すことができます。Bamboo 管理コンソールを使用して、エラスティック インスタンスを手動で起動できます。エラスティック インスタンスを起動すると、そのインスタンスでエラスティック エージェント プロセスが自動的に開始されます。
- Read about starting an elastic instance.
4. 計画ビルドを実行する
エラスティック エージェントで計画ビルドを実行するには、既定のジョブ (およびその他のオプション ジョブ) のある計画をセットアップして、そのジョブの要件すべてが自分のエラスティック エージェントの機能を満たしている必要があります。エラスティック エージェントは、起動元のイメージの機能を継承します。最初は、Bamboo の既定イメージを使用することをお勧めします。
- Read about the capabilities of the default image.
このガイドの目的として、エラスティック エージェントの機能によってのみジョブの要件を満たすことができるように、計画を設定する必要があります。これにより、ジョブのビルドがエラスティック エージェントで動作するようになります。自分のエラスティック エージェントの機能を満たすようにジョブの要件を設定できない場合は、エラスティック エージェントの機能をカスタマイズして、独自のカスタム機能を追加できます。たとえば「elastic=true」などです。
- Read about configuring the capabilities of elastic agents.
エラスティック エージェントでのジョブ ビルドは、他のエージェントのジョブ ビルドと同じように実行されます。ダッシュボードにビルドの進行状況が表示され、完了するとビルド結果を確認できます。
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. エラスティック インスタンスをシャットダウンする
ジョブが正常に構築されたら、エラスティック インスタンスをシャットダウンします。「Elastic Bamboo のコスト」で説明されているように、Elastic Bamboo のコストの大部分はインスタンスのアップタイムによるものです。使用していないときはエラスティック インスタンスをシャットダウンすることを強くお勧めします。
- 「エラスティック インスタンスをシャットダウンする」をご確認ください。
エラスティック インスタンスをシャットダウンすると、実行中のエージェント プロセスが終了することにご注意ください。つまり、エラスティック エージェントは、オンラインでない限り、Bamboo の "エージェント" ページに表示されません。終了されたエラスティック エージェントに関する情報を表示する場合は、エラスティック エージェントの使用履歴でそのエージェントを確認できます。
- 「エラスティック エージェントの使用履歴の表示」をご確認ください。
おめでとうございます。Elastic Bamboo を使ったジョブ ビルドのセットアップと実行が正常に完了しました。
更に詳しい情報
Elastic Bamboo のジョブ ビルド処理の管理と改善に役立つ、次の関連トピックを参照することをお勧めします。
- エラスティック イメージの管理、エラスティック インスタンスの管理、エラスティック エージェントの管理 — Elastic Bamboo のイメージ、インスタンス、エージェントを管理するための情報ハブ
- Elastic Bamboo に関するよくある質問 — Elastic Bamboo を使ったビルドの実行に関する一般的な質問
- EBS を使用するようにエラスティック インスタンスを設定する — Amazon エラスティック ブロック ストア (EBS) を使用してジョブ ビルドの時間を改善するように Elastic Bamboo を設定する方法に関する情報