リポジトリのクローン

ジョブ実行中にリポジトリを複製するリポジトリの複製ジョブ ステップの概要。

ジョブ ステップ設定 (図 1 ) では、ジョブ ステップに関する次のような情報をカスタマイズできます。

• カスタムステップ名を定義できます。定義しない場合は、デフォルトのステップ名が使用されます。
• 次のいずれかを選択してください リポジトリ ジョブ実行中にクローンされるリポジトリです。リポジトリの値は「なし」に設定できます。リポジトリを選択した場合、追加のクローン作成オプションが利用可能になります。
  注： Windowsマシンでリポジトリをクローンする際、パスが長いと問題が発生する場合がありますのでご注意ください。その場合は、Gitクローンのトラブルシューティングガイドのページをご覧ください。

  

• ジョブ実行中にクローンされるブランチを定義できます。ヒント：ブランチはジョブパラメータとして使用できます。例はこちらでご覧いただけます。
• 追加のクローン リポジトリ構成のクローン オプション:
  1. クローン作成に使用する深さを定義できます (つまり、深さはクローン作成のサイズを最後のnコミットに制限します)。
  2. アクションが失敗した場合に、git clone または pull アクションの最大再試行回数を定義できます。
  3. リポジトリのクローン先を、エージェントの作業ディレクトリ内の相対ディレクトリパスで指定できます。空白のままにすると、リポジトリはエージェントの作業ディレクトリ内にクローンされます。
  4. エージェントのリポジトリが最初にクローン化されるとき、 役員 リポジトリのコピーをキャッシュに保存します。新しいジョブが開始されると、リポジトリを最初からクローンするのではなく、可能な限りキャッシュからリポジトリを取得します。 キャッシュをクリアする このフィールドがマークされている場合、このジョブ ステップの前にすべてのリポジトリ データが削除され、リポジトリ全体が強制的に複製されます。
     注意: 「キャッシュをクリア」フィールドを使用すると、実行パフォーマンスが低下する可能性があります。
  5. スパースチェックアウトオプションを使用すると、大規模なGitリポジトリ内の特定のファイルまたはディレクトリのサブセットを操作できます。このアプローチは、リポジトリ全体をチェックアウトする必要がないため、ディスク使用量を削減し、操作を高速化します。特にモノリポジトリで作業する場合に便利です。スパースチェックアウトオプションの詳細については、 Gitドキュメントスパースチェックアウトを実行する場合は、下の図に示すように、リポジトリ全体をチェックアウトするのではなく、チェックアウトする必要があるディレクトリを示すスパースパスを定義する必要があります。

     

     注: Git sparse はバージョン2.25.0で初めて導入されました。インストールされている Git がそれより古い場合は、この機能を使用するにはアップデートする必要があります。古いバージョンの Git で TestHub の sparse オプションを使用すると、リポジトリのクローン作成中にエラーが発生します。
• 各ステップには、ステップを管理するための詳細オプションがあります。ステップの実行に失敗した場合、ジョブの実行は継続されます。「ステップ失敗時にジョブを中止する」オプションが選択されている場合、このステップが失敗するとジョブの実行が停止し、それ以降のステップは実行されません。スキップ条件については、条件が満たされた場合に現在のステップをスキップできます。