カスタム エラスティック イメージの作成 - Windows
Atlassian doesn't provide support for customized images. Bamboo provides flexibility to use customized machine images, but it's impossible for us to support all individual configurations.
Use Bamboo stock images as the base for all image customizations to ensure a minimal level of consistency of your Elastic Bamboo setup.
次にリストされたタスクを実行するには、リモート デスクトップ クライアントを使用して管理者アカウントでインスタンスにログインします。
ユーザー アカウントを設定する
Bamboo エージェントが使用するユーザー アカウントを作成します。アカウント名は自由に指定ください。次の例では Bamboo を使用しています。お使いのマシンで実行中のすべてのビルドが、このアカウントを使用します。一般ユーザーでかまいません (つまり、ビルドで必要な場合を除き、パワー ユーザーや管理者である必要はありません)。そのユーザーのパスワードを設定します。Windows イメージの既定のユーザーは、ユーザー名は Bamboo、パスワードは Atlassian1 です。
重要: 既定では、新たに作成されたユーザーに対しては、リモート ログイン権利を拒否する必要があります (それが望ましいからです)。念のため、そのユーザーの資格情報を使用してログインできないことを確認してください (資格情報を既定以外のものに変更していない限り)。
Bamboo アカウントへの自動ログインを設定する必要があります (リモート ユーザーはログインできませんのでご安心ください)。これを行うには、control userpasswords2 を実行して、[User must enter a user name and password to enter this computer (このコンピュータにアクセスするにはユーザー名とパスワードを入力する必要があります)] を選択解除します。
ファイアウォールを設定する
ポート 26224 で TCP 接続を受け入れるように Windows ファイアウォールを再設定します。Bamboo にはその他のインバウンド接続は必要ありません。
このポートの EC2 セキュリティ グループ設定の変更について心配する必要はありません。Bamboo が自動的にセットアップします。
必要なソフトウェアをインストールする
Install a supported Oracle Java version. See Supported platforms
- こちらの場所からエージェント インストーラー zip の最新バージョンをダウンロードします(このガイドが作成された時点では、最新バージョンはこちらでした)。任意の場所に展開します。Bamboo で配布しているストック イメージに合わせて
C:\opt\bamboo-elastic-agentを使用することをおすすめします。 - 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:
The task manager will warn you that the account needs to be able to log in as a batch job. Make sure the Log on as batch job policy is set for the user. This policy is accessible by opening the Control Panel > Administrative Tools > Local Security Policy. In the Local Security Policy window, select Local Policies > User Rights Assignment > Log on as a batch job:
インスタンスで EBS の使用量を有効にする
Starting with Bamboo 5, you'll be able to use custom Elastic Block Storage with your Windows instances. To do that, you need to change the SAN policy on your instance, otherwise the disks will be attached in Offline state with status text the disk is offline because of policy set by an administrator.
Diskpart ユーティリティを使用して SAN ポリシーを変更できます。Diskpart を実行して以下を入力します。
san policy=OnlineAll
Enter を押します。Diskpart; を終了します。これで新しいポリシーが有効になります。
テスト
すべてが正しく設定されているかどうかを確認する最も簡単な方法は、Windows タスク スケジューラ ([スタート] > [管理ツール]> [タスク スケジューラ]) を使用して定義したタスクを実行することです。タスクを右クリックして [実行] を選択します。必ずタスク スケジューラを使用してスクリプトをテストしてください。スクリプトを手動で実行すると、管理者アカウントを使用することになりますが、これは正しい方法ではありません。
%USERPROFILE%/bamboo-elastic-agent.out ファイルを探します。このファイルがあり、Bamboo Server によって起動された EC2 インスタンス内でエージェントが実行されなかったというエラー メッセージが含まれていれば、カスタマイズは正常に完了しています。
c:\opt\bamboo-elastic-agent\bin\prepareInstanceForSaving.bat を実行します。
インスタンスをバンドルします。新しいイメージの AMI ID をメモしておきます。
Bamboo からのイメージの起動
40 分以内に次の手順を完了しないと Bamboo によってインスタンスがシャット ダウンされるため、時間がなくなった場合は忘れずに作業内容を保存してください (つまり、中間イメージを作成します)。
Bamboo で、先ほど作成したイメージのイメージ構成を定義し、Bamboo から起動します。すべてうまくいけば、エージェントがインスタンスと一緒に起動します。次のステップが実行されます。
- 追加のディレクトリを作成して、/create /opt/bamboo-elastic-agent のディレクトリ構造を更新します。表示されれば、Java がそのマシンで適切に動作しており、S3 への接続が機能していることになります。
- エージェントを起動すると、Bamboo エージェント ホーム ディレクトリが作成され、Bamboo サーバーから取得されたデータが反映されます。
すべてうまくいけば、エージェントが Bamboo インスタンス リストに表示されます。これで Bamboo エージェントの起動は完了です。
エージェントは Bamboo サーバーと同期したばかりであるため (サーバーにあるものと完全に一致する jar ファイルをすべてダウンロードしたため)、追加の手順として、その状態を保存して、将来のインスタンスの起動を早め、帯域幅の使用量を減らすことをおすすめします。
そのためには、以下を実行します。
c:\opt\bamboo-elastic-agent\bin\prepareInstanceForSaving.bat
イメージを保存し、新しいイメージ構成を定義し、インスタンスを強制終了して Bamboo から実行してみてください。