GitLab Duo with Amazon Q 故障排查

若在使用 GitLab Duo with Amazon Q 时遇到常见入驻问题，可参考以下部分进行排查。

GitLab 实例阻止入站请求

问题描述：我的 GitLab 实例阻止了入站请求，导致 Amazon Q 无法回调到我的 GitLab 实例。

解决方案：确定阻止入站请求的因素，并进行修改以接受来自 Amazon Q 的入站请求。可能的阻止因素包括：

您需要重新入驻 GitLab 实例以实现同步。有关更多信息，请参阅《GitLab 文档》中的配置 GitLab Duo with Amazon Q。

GitLab 与 Amazon Q 之间的连接不同步

问题描述：我修改了 GitLab Duo with Amazon Q 应用程序，现在 GitLab 与 Amazon Q 之间的连接不同步。

解决方案：GitLab 与 Amazon Q 连接不同步可能导致以下问题：凭证无效、无法刷新凭证，以及 Amazon Q 回调 GitLab 时收到未授权响应。

实例域名无法解析

问题描述：入驻后我修改了 GitLab 实例的 URL，现在 GitLab 与 Amazon Q 之间的连接不同步，Amazon Q 无法成功调用 GitLab 实例。

解决方案：需确保域名可正常解析，并重新入驻 GitLab 实例。有关更多信息，请参阅《GitLab 文档》中的配置 GitLab Duo with Amazon Q。

IAM 角色与身份提供商（IdP）配置错误

问题描述：我的 IAM 角色未向 GitLab Duo with Amazon Q 所需的 API 提供正确权限。

解决方案：确保身份提供商（IdP）和 IAM 角色配置正确。有关更多信息，请参阅《GitLab 文档》中的配置 GitLab Duo with Amazon Q。

Amazon Q 开发者版配置文件不存在

问题描述：我尝试入驻 GitLab Duo with Amazon Q，却遇到以下问题：Application could not be craeted by the AI Gateway: Error 400 - {"detail":"An error occured (ValidationException) when calling the CreateOAuthAppConnection operation: ProfileDoesNotExist"}

解决方案：需先通过 Amazon Q 开发者版控制台创建 Amazon Q 开发者版配置文件。有关更多信息，请参阅《GitLab 文档》中的配置 GitLab Duo with Amazon Q。