TeamCity 2023.05 の新機能

ラウンドロビン

バージョン 2023.05 では、TeamCity ノード間で負荷をより効果的に分散し、計画されたメンテナンスや予期しないフェールオーバーによってノードがダウンしたときに悪影響を受けるユーザーの数を最小限に抑える新しいリクエスト分散ロジックが導入されています。

この新しいロジックは、UI アクションの処理とユーザーリクエストの負荷分散責任を持つランダムノードに新しいリクエストを送信することに基づいています。この最初の描画の後、TeamCity はどのノードが選択されたかを記憶し、後続のリクエストを同じノードに委譲します。

詳細: ラウンドロビン。

VCS ポーリング責任を複数のノードに割り当てる

バージョン 2023.05 より前では、「VCS リポジトリポーリング」責任 (ノードがリポジトリをポーリングして新しいコミットを確認し、変更を検出できるようにする) は、クラスター全体の 1 つのノードでのみ使用可能でした。このバージョン以降では、この責任を複数のノードに割り当てることができます。この機能強化により、ノード間で負荷を均等に分散し、新しいビルドをトリガーするまでの遅延を減らすことができます。

現在のリクエストをどのノードが処理するかを指定するには (たとえば、新しいビルドをビルドキューに追加する場合)、TeamCity UI の右下隅にあるノードセレクターを使用します。現在選択されているノードは、ノード構成ページ上で星のアイコンでマークされます。

詳細: VCS リポジトリのポーリング。

メインノードの責任を無効にする

以前は、TeamCity クラスターにそのような責任を持つノードがない場合、メインの TeamCity ノードは、「ビルドの実行によって生成されたデータの処理」、「VCS リポジトリのポーリング」、および「ビルドトリガーの処理」の責任を自動的に再取得していました。さらに、「メインの TeamCity ノード」の責任を別のノードに切り替えると、この新しいノードは他のすべての責任を自動的に継承しました。

バージョン 2023.05 以降、メインノードは「不足している」責任を自動的に受け入れません。この変更により、メインノードをより細かく制御できるようになり、負荷と CPU/ メモリの消費量を削減できます。TeamCity UI で無効にできないメインノードの責任は、「メイン TeamCity ノード」(この責任を別のノードで有効にすることによってのみ、このチェックボックスをオフにできます) と「UI アクションの処理とユーザー要求の負荷分散」のみです。

任意のノードから TeamCity バックアップとクリーンアップを起動

UI アクションの処理とユーザーリクエストの負荷分散責任を持つ任意のノードでバックアップを作成できるようになりました。

この責任を持つ任意のノードからクリーンアップをスケジュールすることもできるようになりました。ただし、クリーンアップは常にメインノードで実行されます。このタスクは、セカンダリノードが通常のタスクを実行している間に実行できます。

GitHub アプリ経由で GitHub に接続する

このリリース以降、TeamCity は、GitHub アプリ(英語)を利用した接続を介して、GitHub および GitHub Enterprise インスタンスと連携できます。GitHub アプリは、個人および組織のリポジトリへのアクセスを提供する優れた方法です。きめ細かい権限を誇り、アプリがアクセスできるリポジトリをより細かく制御でき、OAuth アクセストークンを生成するために専用の「サービス」ユーザーを維持する必要がありません。

GitHub アプリ接続を使用すると、GitHub.com および GitHub Enterprise リポジトリをチェックアウトし、GitHub がリポジトリの変更について TeamCity に通知するために使用する Webhook を設定し、関連する認証モジュールを有効にすることができます。

詳細: 接続を構成。

GitHub のドラフトプルリクエストを無視する

このバージョン以降、ビルド機能設定で下書きを無視ボックスをオンにすることで、GitHub ドラフトプルリクエスト(英語)を無視するようにプルリクエストビルド機能を構成できます。TeamCity はステータスが変わるまでドラフトプルリクエストを無視します。

デフォルトでは、プルリクエストビルド機能は GitHub ドラフトプルリクエスト情報を読み込み、ドラフトプルリクエストに対してビルドを実行します。ビルドページには、プルリクエスト番号の横に「ドラフト」ステータスとグレー表示のアイコンが表示されます。

GitHub でドラフトプルリクエストのステータスが「レビュー準備完了」に変更されると、ビルドページにその変更が反映されます。

VCS ルートのリフレッシュ可能なトークンを再発行する

VCS ルートが TeamCity 接続を介して、Bitbucket サーバー、Bitbucket クラウド、または GitLab でホストされている Git リポジトリにアクセスするように構成されている場合、このルートの設定の「認証設定」セクションに新規取得ボタンが表示されるようになりました。このボタンを使用すると、VCS ルートが使用するリフレッシュ可能なトークンを、現在のユーザーに発行された新しいトークンに即座に置き換えることができます。

有効期間の短いリフレッシュ可能なトークンは、TeamCity サーバーが関連データをエージェントと共有せずに自動的にリフレッシュするため、パスワードや個人アクセストークンと比較してセキュリティが強化されます。

詳細: リフレッシュ可能なトークン。

Bitbucket サーバーおよびデータセンターとの統合

Bitbucket クラウドに加えて、TeamCity は Bitbucket サーバーとデータセンターをサポートするようになりました。対応するオプションは、接続タイプのリストおよびプロジェクトの作成ページで利用できます。

詳細: 接続を構成 | プロジェクトの作成と編集

Let's Encrypt 経由で HTTPS 証明書を取得する

暗号化しましょう(英語)は、最新のすべてのブラウザーによって信頼される TLS 証明書を提供する非営利の認証局 (CA) です。バージョン 2020.05 以降、TeamCity はこの CA に接続して、有効な証明書を自動的に発行および設定できます。

Let's Encrypt によって発行された証明書は有効期限の 30 日前に自動的に更新され、TeamCity サーバードメインと、構成されている場合はアーティファクト分離ドメインの両方が対象になります。

詳細: HTTPS サーバー設定。

HTTPS 接続に必要な暗号化プロトコルを指定する

TeamCity サーバーが HTTPS 経由のアクセスを許可している場合、クライアントと通信するためのサーバーのデフォルトプロトコルは現在 TLS バージョン 1.2 です。バージョン 2023.05 以降では、使用可能な暗号化プロトコルのリストを指定したり、TeamCity に 1 つの特定のプロトコルを使用させることができます。

詳細: 使用可能な暗号化プロトコルの指定。

サービスメッセージ経由で Slack メッセージとメールを送信する

TeamCity サービスメッセージを使用すると、ビルドスクリプトに特別なメッセージを追加することで、ビルドに関するさまざまな情報をレポートできます。利用可能なサービスメッセージのリストには、メール、Slack ダイレクトメッセージを送信し、Slack チャネルに更新を投稿する ##teamcity[notification ...] メッセージが含まれるようになりました。

組み込みのセキュリティ機能により、メッセージが間違った受信者に送信されることがなくなり、信頼できるものとして構成されていない外部 Web リソースへのリンクを含めることができなくなります。

詳細: Slack メッセージ | メール。

サービスメッセージを介したビルドタグの追加と削除

TeamCity サービスメッセージを送信して、ビルドタグを追加および削除できるようになりました。

タグを追加または削除するには、次のメッセージを送信します。

詳細: サービスメッセージ。

EC2 インスタンスメタデータサービス v2 のサポート

IMDSv2 は、Amazon EC2 インスタンスメタデータサービスの多数の IMDSv1 脆弱性に対処する(英語)の新しいバージョンです。

TeamCity 2023.05 は、EC2 インスタンスと Amazon マシンイメージ (AMI) を、「オプション」と「必須」の両方の IMDSv2 設定でサポートします。TeamCity は常に最初に IMDSv2 の使用を試行しますが、古い AMI もサポートします。

EC2 起動テンプレートのカスタマイズ

このバージョンから、TeamCity では Amazon EC2 起動テンプレートをカスタマイズできるようになりました。同じ起動テンプレートを使用して、一部のパラメーターのみが異なるさまざまなインスタンスを実行できるようになりました。起動テンプレートのカスタマイズボックスをオンにし、必要に応じて起動テンプレートの値を変更します。

詳細: Amazon EC2 用の TeamCity のセットアップ。

重要な設定の追加検証

バージョン 2023.05 以降、2 要素認証に合格したユーザーは、2FA の無効化、ユーザーのパスワードやメールの変更、アクセストークンの生成などのセキュリティ関連のアクションを実行する時間が 1 時間与えられます。この期間が終了すると、ユーザーはこれらのアクションを続行する前に、自分の ID を再確認し、新しい 2FA 検証に合格する必要があります。

この新しい動作により、TeamCity サーバーの保護層が追加されます。

詳細: 重要な設定の保護。

特定のユーザーグループに 2FA を強制する

グローバル 2 要素認証モードが「オプション」の場合、個々のユーザーグループに 2FA の使用を強制できるようになりました。これを行うには、teamcity.2fa.mandatoryUserGroupKey 内部プロパティを追加し、その値を必要なグループキーに設定します。

詳細: 個々のユーザーグループに 2FA を強制します。

SSH キーの管理

バージョン 2023.05 以降では、プロジェクトの SSH キーに対するあらゆる操作を REST API 経由で実行できます。つまり、新しいキーのアップロードと生成、VCS 認証設定の変更、暗号化キーのパスフレーズの設定、アップロードされたキーの参照と削除です。これを行うには、必要なリクエストを /app/rest/projects/<project_locator>/sshKeys エンドポイントに送信します。

詳細: SSH 鍵管理。

バージョン管理された設定の管理

REST API を使用して、VCS へのプロジェクト設定の保存に関連する設定を管理できるようになりました。この新しい API を使用して、これらの設定を変更し、変更を確認し、関連する VCS との間で変更をロード / コミットできます。/app/rest/projects/{locator}/versionedSettings/ エンドポイントを調べて、利用可能なリクエストを表示します。

詳細: VCS 設定の管理。

ユーザーロールの管理

新しい /app/rest/roles エンドポイントを使用すると、既存のロールを取得、変更、削除できるだけでなく、新しいロールを作成することもできます。

詳細: ロールと権限の管理。

サーバー認証設定の管理

GET および PUT リクエストを /app/rest/server/authSettings エンドポイントに送信して、サーバー認証設定を管理できるようになりました。

詳細: サーバー認証設定の管理。

ビルド構成の「チェーン」タブ

ビルド構成ページに「チェーン」タブが表示されるようになりました。このページでは、ビルドチェーンにリンクされたビルドの Sankey のようなダイアグラムを参照できます。

以前は、このページはクラシック UI でのみ利用可能でした。

ビルドの並べ替え

Sakura UI 内の目的の位置にビルドをドラッグすることで、ビルドキュー内のビルドを手動で並べ替えることができるようになりました。

変更の可視性の向上

• 変更ログタブがプロジェクトとビルド構成で使用できるようになりました。

• グラフの表示オプションは、変更に関連するすべてのページとタブに実装されます。このオプションを有効にすると、変更は関連する VCS ルートへのコミットのグラフとして表示されます。

ビルド結果ページの「パラメーター」タブを更新

ビルド結果ページのパラメータータブをオーバーホールしました。検索ボックスを使用して必要なパラメーターを検索したり、カスタムビルド中に追加 / 変更されたパラメーターのみを表示したり、依存ビルドによって報告されたパラメーターを非表示にしたりできるようになりました。

詳細: パラメータータブ。

アーカイブされたプロジェクトの健全性レポート

アーカイブされたプロジェクトに対してサーバー健全性レポートを生成できるようになりました。これを行うには、<Archived Projects> スコープを選択します。

サーバーのステータスを確認するための新しいエンドポイント

GET リクエストを送信して現在のサーバーのステータスを取得することで確認できる 2 つの新しいエンドポイントが追加されました。

• サーバーがまだ初期化中またはメンテナンスモードであっても、サーバーが実行中の場合は <server_URL>/healthCheck/healthy エンドポイントは「200」を返します。

• サーバーが完全に初期化され、ユーザー要求を受け入れる準備ができている場合、<server_URL>/healthCheck/ready エンドポイントは「200」を返します。サーバーがまだ初期化中であるか、データのアップグレードを待機している場合、エンドポイントは「503」を返します。