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

GitLab Duo Agent Platformのトラブルシューティング

GitLab Duo Agent Platformを使用している場合、次の問題が発生する可能性があります。

ログを表示する

フローの作成後、自動化 > セッションに移動すると、フローのセッションを確認できます。

詳細タブには、CI/CDジョブログへのリンクが表示されます。これらのログには、トラブルシューティング情報が含まれている場合があります。

UIにフローが表示されない

フローを実行しようとしてもGitLab UIに表示されない場合、次のことを確認してください:

  1. プロジェクトのデベロッパーロール以上を持っている。

  2. GitLab Duoがオンになっており、フローの実行が許可されている。

  3. あなたがいるグループがフローを使用する許可を与えられていることを確認してください。

  4. トップレベルグループが正しく設定されているにもかかわらず、個々のプロジェクトでフローが表示されない場合:

    1. プロジェクトに移動します。
    2. 自動化 > フローを選択します。
    3. 右上隅で、グループからのフローを有効にするを選択します。
    4. フローを選択し、有効を選択します。

  5. それでも動作しない場合は、次の手順を試してください:

    1. トップレベルグループで該当するフローを無効にし、設定を保存します。
    2. トップレベルグループで該当するフローを有効にし、設定を保存します。
    3. 設定がグループ全体に反映されるまで、数分待ちます。

インポートされたプロジェクト用の新しいパイプラインを作成する権限が不十分です

インポートされたプロジェクトまたはテンプレートから作成されたプロジェクトで基本フローを実行しようとすると、次のエラーが表示されることがあります: Error in creating workload: Insufficient permissions to create a new pipeline

この問題を解決するには:

  1. トップレベルグループに移動します。
  2. 設定 > 一般を選択します。
  3. GitLab Duoの機能を展開します。
  4. フローの実行で、有効にしたい基本フローを特定します。
  5. トップレベルグループでフローを無効にし、設定を保存します。
  6. トップレベルグループで同じフローを有効にし、設定を保存します。
  7. グループ内のプロジェクト全体に設定が反映されるまで数分待ちます。

エラー: Your request was valid but Workflow failed to complete it

フローには、プロジェクトリポジトリに少なくとも1つのコミットが必要です。コミットがないプロジェクトでフローを実行すると、次のエラーが表示されます: Your request was valid but Workflow failed to complete it. Please try again.

このエラーは、フローがコミットのないリポジトリでデフォルトブランチを見つけられないために発生します。

この問題を修正するには、フローを実行する前に初期コミットをプロジェクトにプッシュする必要があります。たとえば、README.mdファイルを追加します。

セッションが作成済みステータスで停止している

フローのセッションが開始されない場合、次のことを確認してください:

  • プッシュルールが設定されていること。

サービスアカウントを許可するようにプッシュルールを設定する

GitLab UIでは、基本フローは次の操作を行うサービスアカウントを使用します:

前提条件:

  • 管理者アクセス権が必要です。

プロジェクトのプッシュルールを設定するには:

  1. サービスアカウントに関連付けられたメールアドレスを見つけます:

    1. 右上隅で、管理者を選択します。
    2. 概要 > ユーザーを選択し、フローに関連付けられたアカウントを検索します。アカウントはduo-[flow-name]-[top-level-group-name]のパターンに従います。
    3. サービスアカウントのユーザーを見つけ、メールアドレスをコピーします。

  2. メールアドレスによるプロジェクトへのプッシュを許可します:

    1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
    2. 設定 > リポジトリを選択します。
    3. プッシュルールを展開します。
    4. コミットの作成者のメールで、先ほどコピーしたメールアドレスを許可する正規表現を追加します。
    5. プッシュルールを保存を選択します。

  3. duo/feature/ブランチプレフィックスを許可します:

    1. プッシュルールセクションで、ブランチ名を見つけます。
    2. ^duo/(fix|feature|refactor|docs/).* で始まるブランチを許可する正規表現を追加します。例: ^(duo/feature)/.*$
    3. プッシュルールを保存を選択します。

インスタンスのプッシュルールを作成するには:

  1. 右上隅で、管理者を選択します。
  2. 左サイドバーで、プッシュルールを選択します。
  3. 前の手順に従って、コミットの作成者のメールとブランチ名を許可します。
  4. プッシュルールを保存を選択します。