TeamCity 2020.1ヘルプ

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の既知のホストデータベースにリモートホストのフィンガープリントを追加するかどうかを確認します。

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

  • either for all connections by adding something like this in ~/.ssh/config :

    Host * StrictHostKeyChecking no
  • or for an individual command by running an SSH client with the -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no options.

See more information in the man pages for ssh (英語) , ssh-agent (英語) and ssh-add (英語) commands.

1つのビルドで複数のキーを使用する

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

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

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

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

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

最終更新日: 2020年7月23日