TeamCity On-Premises 2026.2 Help

SSH エージェント

SSH エージェント ビルド機能は、ビルド中に、 アップロードされた SSH キーを選択して SSH エージェントを実行します。 ビルドスクリプトが SSH クライアントを実行すると、読み込まれたキーを使用して SSH エージェントが使用されます。

SSH 鍵のアップロードに関する注意事項については、 SSH 鍵管理を確認してください。

エージェントのセットアップ

TeamCity SSH エージェントは、Linux および macOS に含まれる OpenSSH のネイティブ SSH エージェントを使用するため、これらの OS ではこの機能はすぐに使える状態です。 Windows の場合、OpenSSH をインストールする必要があります (たとえば、CygWin、MinGW の一部として、または Windows 用の Git ディストリビューションの一部として)。

SSH エージェントは、Unix ライクな OS では $PATH に、Windows では %PATH% に追加する必要があります。

TeamCity ビルドエージェントごとに個別の SSH エージェントが起動されるため、同じマシンに複数のビルドエージェントがインストールされている場合、この機能を使用できます。

SSH ホスト鍵チェックの無効化

リモートホストに初めて接続するとき、SSH クライアントは、 ~/.ssh/known_hosts ファイル の既知のホストデータベースにリモートホストのフィンガープリントを追加するかどうかを確認します。

ビルド中にこのようなプロンプトを回避するには、事前に既知のホストデータベースを構成する必要があります。 接続しているホストを信頼する場合、既知のホストチェックを無効にできます。

  • ~/.ssh/config ファイル に次のような内容を追加して、 すべての接続用 実行します。

    Host * StrictHostKeyChecking no
  • または、 -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no オプションを使用して SSH クライアントを実行し、 個別のコマンド用

SSH (英語)SSH エージェント (英語)ssh-add コマンド (英語) コマンドの詳細については、man ページを参照してください。

単一のビルドで複数の鍵を使用する

ビルドが複数の外部システムで認証する必要がある場合、複数の SSH キーを使用できます。

ビルドで複数の SSH キーを使用するには:

  • プロジェクトレベルで: SSH キー ページでキーを追加します。

  • ビルド構成レベル: キーごとに 1 つずつ、複数の SSH エージェント ビルド機能を追加します。

ビルドが開始されると、サーバーから SSH キーをダウンロードし、他のビルドステップの要求に応じてキーを配布する SSH エージェントを実行します。

2026 年 9 月 11 日