カスタム エラスティック イメージの作成 - Windows

次にリストされたタスクを実行するには、リモート デスクトップ クライアントを使用して管理者アカウントでインスタンスにログインします。

ユーザー アカウントを設定する

Bamboo エージェントが使用するユーザー アカウントを作成します。アカウント名は自由に指定ください。次の例では Bamboo を使用しています。お使いのマシンで実行中のすべてのビルドが、このアカウントを使用します。一般ユーザーでかまいません (つまり、ビルドで必要な場合を除き、パワー ユーザーや管理者である必要はありません)。そのユーザーのパスワードを設定します。Windows イメージの既定のユーザーは、ユーザー名は Bamboo、パスワードは Atlassian1 です。

ファイアウォールを設定する

ポート 26224 で TCP 接続を受け入れるように Windows ファイアウォールを再設定します。Bamboo にはその他のインバウンド接続は必要ありません。

必要なソフトウェアをインストールする

1. Install a supported Oracle Java version.
2. Download the latest version of agent installer zip from this this location (at the time this guide was written, the latest version was this). Unpack it to a desired location, we suggest using C:\opt\bamboo-elastic-agent to match stock images distributed with Bamboo.
3. A batch file should launch with your Windows instance startup. In order to do this, use the Windows Task Scheduler (Start > Administrative Tools > Task Scheduler), and set up a new Action task of “Start a program" with the <PATH TO YOUR BATCH FILE> as the Details:
   
   
   
   Remember to select Run whether user is logged on or not in the “General” tab: 
   
    
   And appropriately define the Trigger task so that the agent starts up only after the network connection is up and running:
   
    

アカウントがバッチ ジョブとしてログインできる必要があるという警告がタスク マネージャーに表示されます。ユーザーに対して「Log on as batch job (バッチ ジョブとしてログオン)」ポリシーが設定されていることを確認してください。[コントロール パネル] > [管理ツール] > [ローカル セキュリティ ポリシー] の順に移動することでこのポリシーにアクセスできます。[ローカル セキュリティ ポリシー] ウィンドウで、[ローカル ポリシー] > [ユーザー権利の割り当て] > [Log on as batch job (バッチ ジョブとしてログオン)] をクリックします。

インスタンスで EBS の使用量を有効にする

Bamboo 5 以降では、Windows インスタンスでカスタム エラスティック ブロック ストレージを使用できるようになります。そのためには、インスタンスで SAN ポリシーを変更する必要があります。変更しないと、ディスクは「オフライン」状態で接続され、「the disk is offline because of policy set by an administrator (管理者が設定したポリシーにより、ディスクがオフラインになっています)」というステータス テキストが表示されます。

Diskpart ユーティリティを使用して SAN ポリシーを変更できます。Diskpart を実行して以下を入力します。

san policy=OnlineAll

and press Enter. You can then quit Diskpart; the new policy will now be active.

 

テスト

すべてが正しく設定されているかどうかを確認する最も簡単な方法は、Windows タスク スケジューラ ([スタート] > [管理ツール]> [タスク スケジューラ]) を使用して定義したタスクを実行することです。タスクを右クリックして [実行] を選択します。必ずタスク スケジューラを使用してスクリプトをテストしてください。スクリプトを手動で実行すると、管理者アカウントを使用することになりますが、これは正しい方法ではありません。

Look for the %USERPROFILE%/bamboo-elastic-agent.out file. If it exists and contains an error message stating that agent was not run within an EC2 instance started by Bamboo Server, you’ve successfully completed the customisation.

c:\opt\bamboo-elastic-agent\bin\prepareInstanceForSaving.bat を実行します。 

インスタンスをバンドルします。新しいイメージの AMI ID をメモしておきます。

Bamboo からのイメージの起動

Bamboo で、先ほど作成したイメージのイメージ構成を定義し、Bamboo から起動します。すべてうまくいけば、エージェントがインスタンスと一緒に起動します。次のステップが実行されます。

• 追加のディレクトリを作成して、/create /opt/bamboo-elastic-agent のディレクトリ構造を更新します。表示されれば、Java がそのマシンで適切に動作しており、S3 への接続が機能していることになります。
• エージェントを起動すると、Bamboo エージェント ホーム ディレクトリが作成され、Bamboo サーバーから取得されたデータが反映されます。

すべてうまくいけば、エージェントが Bamboo インスタンス リストに表示されます。これで Bamboo エージェントの起動は完了です。