Elastic Bamboo の使用を開始する
エラスティック Bamboo では、Amazon Elastic Compute Cloud (EC2)のコンピューティング リソースを使用してビルドを実行することができます。エラスティック Bamboo は、リモート エージェント AMI (Amazon Machine Image)を使用して、Amazon EC2 にリモート エージェントのインスタンスを作成します。
このページの内容
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 を有効化する方法は次のとおりです。
Bamboo でリモート エージェント サポートを有効化します。リモート エージェント サポートを無効にしている場合は、Elastic Bamboo を有効化する前に、リモート エージェント サポートを有効にする必要があります。
- Bamboo で、上部メニュー バーの [管理] をクリックします。
- 左側のナビゲーション パネルの [設定] ([Elastic Bamboo] の下) をクリックします。"Elastic Bamboo の設定" 画面が表示されます。
- [有効化] をクリックします。
2.2) にアップグレードする場合に大変便利です。Elastic Bamboo の設定
Elastic Bamboo を使用するには、「Elastic Bamboo の設定」ドキュメントに記載されている説明に沿って設定する必要があります。これは次のとおり、3 ステップの簡単なプロセスです。
- 「Elastic Bamboo の設定」に関するドキュメントをご確認ください。
2.3. VCS へのアクセスを提供する
Elastic Bamboo を使用してジョブ ビルドを実行するには、Amazon でバージョン管理システムを利用できるようにする必要があります。これは、特に VCS がファイアウォール内にある場合に、セキュリティに影響を及ぼします。
- まだ読んでいない場合は、「Elastic Bamboo のセキュリティ」に関するドキュメントで詳しい説明をご確認ください。
3. エラスティック インスタンスを起動する
これで、Bamboo インストールの Elastic Bamboo を有効化して設定が完了したので、Elastic Bamboo を使って計画の構築を試すことができます。Bamboo 管理コンソールを使用して、エラスティック インスタンスを手動で起動できます。エラスティック インスタンスを起動すると、そのインスタンスでエラスティック エージェント プロセスが自動的に開始されます。
- 「エラスティック インスタンスを起動する」をご確認ください。
4. 計画ビルドを実行する
エラスティック エージェントで計画ビルドを実行するには、既定のジョブ (およびその他のオプション ジョブ) のある計画をセットアップして、そのジョブの要件すべてが自分のエラスティック エージェントの機能を満たしている必要があります。エラスティック エージェントは、起動元のイメージの機能を継承します。最初は、Bamboo の既定イメージを使用することをお勧めします。
- 既定イメージの機能についてご確認ください。
このガイドの目的として、エラスティック エージェントの機能によってのみジョブの要件を満たすことができるように、計画を設定する必要があります。これにより、ジョブのビルドがエラスティック エージェントで動作するようになります。自分のエラスティック エージェントの機能を満たすようにジョブの要件を設定できない場合は、エラスティック エージェントの機能をカスタマイズして、独自のカスタム機能を追加できます。たとえば「elastic=true」などです。
- 「エラスティック エージェントの機能の設定」をご確認ください。
エラスティック エージェントでのジョブ ビルドは、他のエージェントのジョブ ビルドと同じように実行されます。ダッシュボードにビルドの進行状況が表示され、完了するとビルド結果を確認できます。
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 を設定する方法に関する情報