TeamCity On-Premises 2026.2 Help

SSH アップロード

SSH アップロードビルドランナーでは、SSH 経由でファイルまたはディレクトリをアップロードできます(SCP または SFTP プロトコルを使用)。

すべてのランナーに共通する設定については、 ビルドステップの構成で説明しています。このページでは SSH デプロイヤー設定について詳しく説明します。

以下のフィールドでは パラメーター参照を使用できます。パーセント記号 (%) で囲まれたテキストは、TeamCity によってプロパティへの参照と見なされます。 TeamCity がパーセント記号で囲まれたテキストをプロパティへの参照として扱わないようにするには、パーセント記号を二重にしてエスケープします。たとえば、 %Y%\m%d%\H%M%S をビルドに渡す場合は、 %%\Y%%\m%%\d%%\H%%\M%%S に変更します。

オプション

説明

ステップ名

省略可 TeamCity UI に表示されるビルドステップの名前。

ステップ ID

このビルドステップの ID。この構成内のすべてのステップで一意である必要があります。 URL、REST API、DSL、サーバーへの HTTP リクエスト、TeamCity データディレクトリの構成設定で使用されます。

ステップ実行

デフォルトのビルド条件を変更したり、オプションで ビルド条件を追加したりできます。

デプロイターゲット

ターゲット

ファイルのアップロード先となる SSH サーバーの場所。フォーマットは次のとおりです:

{hostname|IP_address}[:targer_dir[/sub_path]]

ここで、 ターゲット_dir は絶対的または相対的であり、 サブ_パス は任意の深さを有することができます。

転送プロトコル

SSH 経由でデータを転送するプロトコルを選択します。 使用可能なオプションは次のとおりです: SCP と SFTP

ポート

オプションのポート。 デフォルトはポート 22 です。

タイムアウト

オプションの接続のタイムアウト (秒単位)。 デフォルトは 0 です。

デプロイ資格情報

認証方式

認証方法を選択します。

  • アップロード済みの鍵 — プロジェクトにアップロードされたキーを使用します。 詳細については、 SSH 鍵管理を参照してください。

  • デフォルトの秘密鍵~/.ssh/config ファイル 設定を使用して秘密鍵認証を実行します。設定ファイルが存在しない場合は、 ~/.ssh/id_rsa 秘密鍵ファイルを使用します。

  • カスタム秘密鍵 — 指定された秘密鍵ファイルとパスフレーズを使用して秘密鍵認証を実行します。

  • パスワード - 単純なパスワード認証を使用します。

  • SSH エージェント — 認証に SSH エージェントを使用します。この場合、 SSH-Agent ビルド機能を有効化する必要があります。

デプロイソース

ソースへのパス

デプロイソースを、ファイルまたはディレクトリへのパスの改行またはコンマ区切りリストとして指定します。

このフィールドでは Ant スタイルのワイルドカードパターンを使用できます (例: dir/**/*.zip)。
また、 ファイル => ディレクトリ パターンを使用して、作成するターゲットディレクトリを指定することもできます (たとえば、 *.zip => winFiles、unix/distro.tgz => linuxFilesWindows ファイル ディレクトリと Linux ファイル ディレクトリを作成し、宣言されたファイルをそれぞれその中に配置します)。

サンプル

例: Java パッケージを SSH サーバー (ssh.example.com ホスト上) にアップロードするために SSH アップロードビルドステップを追加する必要がある場合を考えてみましょう。 ホームディレクトリ /jdoe を持つ SSH サーバー上で jdoe アカウントを使用し、SSH サーバーが認証に SSH キーを使用するように構成されているとします。

  1. 生成された SSH 鍵の手順に従って、プロジェクトで新しい SSH 鍵ペアを生成します。 キーペアを パッケージアップロードキー と呼びます。

  2. パッケージアップロードキー キーペアから公開鍵をコピーします。

  3. SSH サーバー上の jdoe アカウントにログインし、SSH サーバープロバイダーの指示に従って、 パッケージアップロードキー 公開鍵をこのアカウントに追加します。

  4. プロジェクトのビルド構成で、 ビルドステップ ページに移動し、 ビルドステップを追加 をクリックします。

  5. 新しいビルドステップ ページで、 SSH アップロード ランナーを選択します。

  6. 新しいビルドステップ: SSH アップロード ページで、次のようにフィールドに入力します。

    • ステップ名Java パッケージのアップロード を入力

    • ターゲットssh.example.com:/jdoe を入力

    • 認証方式アップロードされたキーを選択してください

    • ユーザー名jdoe と入力 (SSH サーバー上のアカウントのユーザー名)

    • 鍵を選択 — ドロップダウンリストから パッケージアップロードキー を選択します

    • ソースへのパス — 次のパスを入力します。

      ch-simple/simple/target/*.jar => packages
  7. 保存 」をクリックしてビルドステップを作成します。

2026 年 9 月 11 日