25.5. ジョブブランチの上書き

実行されるすべてのジョブには独自のプライベートデータディレクトリーがあります。このディレクトリーには、ジョブが実行されている特定の scm_branch のプロジェクトソースツリーのコピーが含まれています。ジョブはプロジェクトフォルダーに自由に変更を加え、実行中にその変更を利用できます。このフォルダーは一時的なフォルダーであり、ジョブの実行の終了時に削除されます。

Clean オプションをオンにすると、変更されたファイルは Automation controller のリポジトリーのローカルコピーから削除されます。対応の Ansible モジュールで、git または Subversion に関連する Force パラメーターを使用することで削除します。

プロジェクトの更新中、デフォルトブランチ (プロジェクトの SCM Branch フィールドで指定) のリビジョンが更新時に保存されます。ジョブにデフォルト以外の SCM Branch (コミットハッシュやタグではない) を指定すると、ジョブが開始される直前に、最新のリビジョンがソースコントロールリモートから取得されます。このリビジョンは、ジョブとそのプロジェクトの更新の Source Control Revision フィールドに表示されます。

その結果、デフォルト以外のブランチではオフラインジョブを実行できません。ジョブがソースコントロールからの静的バージョンを実行していることを確認するには、タグまたはコミットハッシュを使用します。プロジェクトの更新ではすべてのブランチが保存されるのではなく、プロジェクトのデフォルトブランチのみが保存されます。

SCM Branch フィールドは検証されていないため、プロジェクトを更新して有効であることを確認する必要があります。このフィールドが指定されたり、要求されたりした場合には、ジョブテンプレートの Playbook フィールドは検証されず、ジョブテンプレートを起動して、必要とされる Playbook が存在するかを確認する必要があります。

SCM Refspec フィールドは、更新がリモートからダウンロードする必要がある追加の参照を指定します。以下に例を示します。例としては次のようなものがあります。

プロジェクトの規模が大きく、先ほどの 1 例目と 2 例目を使用する場合には、パフォーマンスへの影響を考慮する必要があります。

SCM Refspec パラメーターはプロジェクトブランチの可用性に影響を与え、他の方法では利用できない参照へのアクセスを可能にすることができます。前の例では、SCM Branch からプルリクエストを提供できますが、これは SCM Refspec フィールドがなければ不可能です。

Ansible git モジュールは、デフォルトで refs/heads/ をフェッチします。これは、SCM Refspec が空白の場合、プロジェクトのブランチ、タグ、コミットハッシュを SCM ブランチ として使用できます。SCM Refspec フィールドに指定された値により、どの SCM Branch フィールドをオーバーライドとして使用できるかが左右されます。プロジェクトの更新 (タイプを問わず) は、追加の git fetch コマンドを実行して、その refspec をリモートからプルします。