正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください。

CI/CDパイプライン修正フロー

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

CI/CDパイプライン修正フローは、GitLab CI/CDパイプラインの問題を診断し、修正を提案します。失敗を診断するために、フローは次の情報を調べます:

  • エラーメッセージ、失敗したジョブの出力、終了コードなどのパイプラインログ。
  • 失敗の原因となった可能性のあるマージリクエストの変更。
  • 構文エラー、Lintエラー、またはインポートエラーを特定するためのリポジトリの内容。
  • コマンドの失敗、実行可能ファイルの欠落、権限の問題などのスクリプトエラー。

フローが修正を適用する方法は、パイプラインのコンテキストによって異なります:

  • パイプラインがマージリクエストに関連付けられている場合、フローはソースブランチにインラインコード提案を適用します。提案は、マージリクエストから直接レビューして適用できます。
    • 修正のため、現在のマージリクエストの差分に含まれていないファイルを変更する必要がある場合、フローは代わりに新しいマージリクエストを作成します。
  • パイプラインがマージリクエストに関連付けられていない場合、フローは修正を含む新しいマージリクエストを作成します。

場合によっては、フローは修正を試みる代わりに、失敗および実行可能な次のステップについて説明するコメントを投稿します。たとえば、パイプラインがマージリクエストに関連付けられている場合、次のような状況でこの処理が行われます:

  • 信頼性の高い修正を特定するためのコンテキストが不足している。
  • 失敗がセキュリティに関係するため、人によるレビューが必要である。
  • 失敗のカテゴリが、フローで対処可能なものではない。

セッションが開始および完了すると、フローはセッションへのリンクを含むシステムノートをマージリクエストに投稿します。このフローはGitLab UIでのみ使用できます。

GitLab Duo Agent Platformを使用しており、失敗したパイプラインを自動的に修正する場合は、このフローの使用をおすすめします。このフローは、単一ジョブの失敗についてトラブルシューティングを行うためのGitLab Duo Chat機能である根本原因分析とは別の機能です。

前提条件

マージリクエストでパイプラインを修正する

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。

マージリクエストでCI/CDパイプラインを修正するには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを開きます。

  3. パイプラインを修正するには、次のいずれかの方法を使用します:

    • 概要タブを選択し、失敗しているパイプラインの下にあるDuoでパイプラインを修正を選択する。
    • パイプラインタブを選択し、右端の列にあるDuoでパイプラインを修正（ tanuki-ai ）を選択する。
    • GitLab Duoサイドバーで、新規または既存のAgentic Chatの会話を開き、Agentic Chatにパイプラインの修正を依頼する。

  4. 進捗状況を監視するには、左側のサイドバーでAI > セッションを選択します。

    Agentic Chatを使用している場合、次の操作もできます:

    • Chatの会話で進捗状況を確認する。
    • 会話でエージェントセッションを表示を選択する。

セッションが完了すると、フローはマージリクエストにコード提案を追加するか、実行可能な次のステップについて説明するコメントを投稿します。

他のCI/CDパイプラインを修正する

マージリクエストに関連付けられていないCI/CDパイプラインを修正するには:

  1. ビルド > パイプラインを選択します。
  2. 失敗しているパイプラインを選択します。
  3. 右上隅で、Duoでパイプラインを修正を選択します。
  4. 進捗状況を監視するには、AI > セッションを選択します。

AGENTS.mdを使用してフローをカスタマイズする

フローは、リポジトリ内のAGENTS.mdファイルからリポジトリ固有の指示を読み取ります。AGENTS.mdを使用して、次のような動作をカスタマイズできます:

  • フローがコミットする変更のコミットメッセージ形式。
  • フローが作成するマージリクエストのラベルや説明などのメタデータ。
  • 特定の種類の失敗を分類して処理する方法。
  • 同じフローが複数回失敗しないように、同じ種類の繰り返しの失敗をどのように処理するか。

例:

markdown
## Fix pipeline merge requests

When opening a merge request as part of the Fix Pipeline flow (the title contains [FixPipeline]),
apply labels based on the following failed pipeline scenarios:

- Pipeline failed on merge_request: apply "pipeline::tier-1". This runs the cheaper tier-1
  pipeline instead of the full default pipeline.
- Pipeline failed on the default_branch (main): apply both "pipeline::expedited" and
  "main:broken". Do not apply pipeline::tier-1 in this case.
- Pipeline failed on other branches: apply "pipeline::tier-1". Same treatment as the
  merge_request case.

例えば、移行の失敗を処理するには:

markdown
## Migration failures

If a pipeline fails because of a database migration:

- Run `bin/rails db:migrate:status` to check the current migration state before attempting
  a fix.
- Do not edit or delete past migration files.
- If the migration cannot be safely reversed, post a comment describing the issue instead
  of attempting a fix.

既知の問題

  • AIゲートウェイは、ジョブログの末尾150 KiBのみを処理します。ジョブから大量の出力が生成される場合、ログの前半にある関連性の高い失敗情報をフローが取得できない可能性があります。回避策については、次のセクションを参照してください。
  • フローは、サンドボックス化されたランタイム環境でパッケージのインストールを常に検証できるとは限りません。依存関係が不足している場合、デフォルトのフローイメージをカスタマイズできます。デフォルトのDockerイメージを変更するを参照してください。
  • AGENTS.mdに記載されているリポジトリの指示はフローの動作に影響を与えますが、すべての場合でそれに従うことを保証するものではありません。

トラブルシューティング

CI/CDパイプライン修正フローを使用する際に、次の問題が発生する可能性があります。

フローが失敗の根本原因を特定できない

フローがパイプラインの失敗の根本原因を特定できない場合があります。

この問題は、ジョブログが150 KiBを超える場合に発生します。AIゲートウェイはジョブログの末尾150 KiBのみを処理するため、ログの前半にある関連性の高い失敗情報を取得できない可能性があります。

この問題を回避するには、次の方法を試してください:

  • デバッグログや進捗インジケーターを削除して、詳細な出力を減らす。
  • Shellリダイレクト（> /dev/null）を使用して、重要でない出力をリダイレクトする。
  • スクリプトの最後にサマリーステップを追加し、主要なエラーメッセージを出力する。
  • after_scriptを使用して、メインスクリプトの完了後に診断情報を出力する。
  • 出力の多いジョブを、ログがより簡潔かつ小規模で目的を絞ったジョブに分割する。

Duoでパイプラインを修正ボタンが表示されない

前提条件を満たしているにもかかわらず、Duoでパイプラインを修正ボタンが表示されません。

この問題は、ボタンが3つの別々のページ（GitLab Duo、Duo Agent Platform、および基本フロー）の設定に依存しているために発生します。あるレベルで有効になっている設定が、その下にあるすべてのレベルで有効であることを保証するものではありません。

この問題を解決するには、各要件を再確認してください:

フィードバックを提供する

チームは、CI/CDパイプライン修正フローの改善に積極的に取り組んでいます。問題を報告したり改善を提案したりするには、フィードバックイシュー601991にフィードバックを投稿してください。