ジョブの実行フロー

ジョブの実行フローでは、GitLab RunnerがCI/CDジョブを最初から最後までどのように処理するかを説明します。

GitLab Runnerは、ジョブを受信し、Vaultからシークレット (設定されている場合) を取得し、executorを準備した後、CI/CDジョブを実行します。すべてのCI/CDジョブは、一連の連続したステップとして実行され、各ステップは個別のShellコンテキストで実行されます。Runnerは次の処理を行います:

1. ジョブのコードのソースを準備します:

   • 変数をShellコンテキストにエクスポートします
   • 設定で定義されている場合は、pre_get_sources_scriptを実行します
   • git fetchおよびその他のソース処理コマンドを実行します（none戦略が設定されていない場合）。
   • サブモジュールが存在する場合は、サブモジュールを更新するコマンドを実行します
   • 設定で定義されている場合は、post_get_sources_scriptを実行します

2. キャッシュが設定されていて、前のステップが成功した場合は、キャッシュされたファイルシステムをダウンロードします:

   • 変数をShellコンテキストにエクスポートします
   • 以前のジョブの実行からキャッシュされたファイルシステムをダウンロードするコマンドを実行します

3. アーティファクトのダウンロードが設定されていて、前のステップが成功した場合は、以前のジョブからアーティファクトをダウンロードします:

   • 変数をShellコンテキストにエクスポートします
   • 以前のジョブからアーティファクトファイルをダウンロードするコマンドを実行します

4. 前のステップが成功した場合は、メインのジョブスクリプトを実行します:

   • 変数をShellコンテキストにエクスポートします
   • 設定で定義されている場合は、pre_build_scriptを実行します
   • 定義されている場合は、before_scriptコマンドを実行します
   • メインのscriptコマンドを実行します
   • 設定で定義されている場合は、post_build_scriptを実行します

5. 以前のステップが失敗したかどうかに関係なく、定義されている場合は、after_scriptコマンドを実行します:

   • 変数を新しいShellコンテキストにエクスポートします
   • after_scriptコマンドを実行します
   • これらのコマンドが失敗しても、ジョブステータス全体には影響しません

6. キャッシュのアップロードが設定されている場合は、前のステップが失敗したかどうかに関係なく、キャッシュにファイルをアップロードします:

   • 変数をShellコンテキストにエクスポートします
   • キャッシュストレージに指定されたファイルをアップロードするコマンドを実行します
   • このステップが失敗すると、ジョブステータス全体に影響する可能性があります

7. アーティファクトのアップロードが設定されている場合は、前のステップが失敗したかどうかに関係なく、アーティファクトをアップロードします:

   • 変数をShellコンテキストにエクスポートします
   • 指定されたファイルをジョブアーティファクトとしてアップロードするコマンドを実行します
   • このステップが失敗すると、ジョブステータス全体に影響する可能性があります

8. レフェリーのアップロードが設定されている場合は、前のステップが失敗したかどうかに関係なく、レフェリーデータをアップロードします:

   • 変数をShellコンテキストにエクスポートします
   • レフェリー情報をアップロードするコマンドを実行します
   • これらのコマンドが失敗しても、ジョブステータス全体には影響しません

9. 前のステップが失敗したかどうかに関係なく、設定されている場合は、クリーンアップ操作を実行します:

   • 変数をShellコンテキストにエクスポートします
   • ファイルベースの変数を作業ディレクトリから削除するコマンドを実行します
   • これらのコマンドが失敗しても、ジョブ全体には影響しません

%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart TD
    accTitle: GitLab CI/CD Job Execution Flow
    accDescr: Shows the complete 9-step job execution sequence from source preparation through cleanup operations.

    Start([Job Starts]) --> Source[1. Source preparation<br/><small>Export variables, runs <code>pre_get_sources_script</code>,</small><br/><small><code>git fetch</code>, submodules, <code>post_get_sources_script</code>.</small>]

    Source --> Cache[2. Download cache<br/><small>If configured and previous step succeeds.</small>]

    Cache --> Artifacts[3. Download artifacts<br/><small>If configured and previous step succeeds.</small>]

    Artifacts --> MainExec[4. Main execution<br/><small>Export variables, <code>pre_build_script</code>,</small><br/><small><code>before_script</code>, <code>script</code>, <code>post_build_script</code>.</small>]

    MainExec --> AfterScript[5. <code>after_script</code><br/><small>Always runs if defined.</small><br/><small>Files created here are included.</small>]

    AfterScript --> Critical[⚠️ CRITICAL: <code>after_script</code> runs BEFORE upload stages.]

    Critical --> UploadCache[6. Upload cache<br/><small>Always runs if configured.</small><br/><small>Failure may affect job status.</small>]

    Critical --> UploadArtifacts[7. Upload artifacts<br/><small>Always runs if configured.</small><br/><small>Failure may affect job status.</small>]

    UploadCache --> UploadReferees[8. Upload referees<br/><small>Always runs if configured.</small><br/><small>Failure doesn't affect job status.</small>]

    UploadArtifacts --> UploadReferees

    UploadReferees --> Cleanup[9. Cleanup operations<br/><small>Always runs if configured.</small><br/><small>Delete file-based variables.</small>]

    Cleanup --> End([Job Complete])

Shellコンテキストの分離

各Shellコンテキストは、設計上分離されています。コンテキスト間の唯一の接続は、共有の作業ディレクトリファイルシステムです。

• 1つのコンテキストでの手動変数のエクスポート（export my_variable=$(date)など）は、他のコンテキストでは使用できません
• 各スクリプトは、最初のエラーで早期に失敗するように、set -eo pipefail (Shell用) で実行されます
• 各ステップの結果は、後続のステップが実行されるかどうか、および全体的なジョブステータスに影響します