JetBrains Account で TeamCity ビルドエージェントを管理する
以下の手順は Organization 管理者を対象としています。 個人アカウントを使用する個人として TeamCity サーバーライセンスを購入した場合は、エージェントライセンスを手動で割り当てる必要はありません。 同じアカウントで購入したエージェントは自動的にあなたのサーバーに割り当てられます。
バージョン 2024.7 より、TeamCity は JetBrains Account ポータル経由でのオンラインライセンス認証をサポートしています。 オフラインライセンスキーをダウンロードして TeamCity サーバーに手動入力する必要はなくなりました。 サーバーで Get license key（ライセンスキーの取得）ボタンをクリックして JetBrains Account にログインするだけで、ライセンス認証を行えるようになっています。 ライセンス認証手順については、TeamCity ドキュメントをご覧ください。
これは 1 回限りの作業です。 TeamCity サーバーのインターネット接続が有効である限り、ビルドエージェントの追加などのライセンスへの変更は自動的に TeamCity インスタンスに配信されます。
ただし、このプロセスを円滑に進めるために、ビルドエージェントライセンスが会社の JetBrains Account であなたの TeamCity サーバーに正しく割り当てられていることを確認する必要があります。
Team でライセンスを管理する
TeamCity サーバーとビルドエージェントのライセンスは、JetBrains Account の Team を使って管理できます。 Team は会社のアカウント内の部門を指し、会社のライセンスのサブセットを個別に管理することができます。 これまでに JetBrains Account Team を使用したことがない場合は、詳細についてこちらの記事をご覧ください。
ビルドエージェントを TeamCity サーバーに割り当てるには、サーバーライセンスが含まれる Team にエージェントライセンスを格納する必要があります。 これは、購入時または購入後にいつでも行えます。
購入プロセス中に新しいエージェントをサーバーに割り当てる
通常あなたが会社のライセンス購入する場合は、購入プロセス中にチェックアウトページで正しいチームを選択して、ビルドエージェントをサーバーに割り当てることができます。 次のように行ってください。
- 必要な数量のビルドエージェントをカートに入れてチェックアウトに進みます。
- チェックアウトページの上部にある Team ドロップダウンリストを開き、サーバーライセンスを含むチームを選択します。 この Team は、Team 名の後に TeamCity with X agents を追加してリストに示されます。
異なる Team に複数の TeamCity サーバーライセンスがあり、どの Team を選択すればよいか不確かな場合は、このページの下にある手順に従って、適切な Team を特定してください。 - 購入を完了します。
これだけです！ 新しいエージェントがあなたのサーバーに割り当てられました。 サーバーライセンスがすでに認証されており、TeamCity サーバーがインターネットに接続されている場合は、自動的にエージェントライセンスが配布されます。 そうでない場合は、ライセンス認証手順に従って、エージェントの使用を開始する必要があります。
エージェントは、以下の手順によって、購入後にいつでも割り当て直すことができます。
既存のエージェントをサーバーに割り当てる
| この手順を完了するには、Organization 管理者権限が必要です。法人のプロファイルに対する Organization 権限の取得に支援が必要な場合は、弊社営業チームまでお問い合わせください。 |
既存のエージェントをサーバーに割り当てるには、エージェントライセンスを対応する Team に移管する必要があります。 以下のようにしてください。
- JetBrains Account にログインします。
- サーバーライセンスが属する Team の名前を書き留めます。
どの Team かわからない場合は、このページの下にある手順に従って特定してください。 - こちらの手順に従って、サーバーを含む Team にエージェントライセンスを移管します。
以上です！ 新しいエージェントがあなたのサーバーに割り当てられました。 サーバーライセンスがすでに認証されており、TeamCity サーバーがインターネットに接続されている場合は、自動的にエージェントライセンスが配布されます。 そうでない場合は、ライセンス認証手順に従って、エージェントの使用を開始する必要があります。
特定のライセンスを含む Team を見つける
- Organization 管理者権限で JetBrains Account にログインします。
- 左のメニューにある会社名をクリックします。
- ページの上部にある View licenses をクリックします。
- ライセンスが表示されるページでライセンスを見つけます。 ライセンス ID で検索することも、ページの上部にあるフィルターを使用することもできます。
- ライセンステーブル内でライセンスを特定したら、ライセンステーブルの Team 列で Team 名を探します。
それがライセンスを含む Team です。 別の人にこのライセンスへのアクセス権を付与するには、その人を管理者としてこの Team に招待します。