GitLab Duo 概念 - Amazon Q Developer
設定 GitLab Duo with Amazon Q加入 AWS 資源和許可政策GitLab 快速動作

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

GitLab Duo 概念

以下是 GitLab Duo with Amazon Q 使用時，需要了解的一些概念和術語。

設定 GitLab Duo with Amazon Q

您必須先完成先決條件並建立 AWS 資源，才能在 GitLab Duo 中使用 Amazon Q 人工智慧 (AI) 功能。如需詳細資訊，請參閱 GitLab 文件中的設定 GitLab Duo with Amazon Q。

加入 AWS 資源和許可政策

在 GitLab Duo 上線過程中，您需要透過 Amazon Q Developer 主控台建立 Amazon Q Developer 設定檔。設定檔可讓您為身分提供者中的所有或一部分使用者建立自訂和控制設定。建立設定檔後，您需要 OpenID Connect (OIDC) 身分提供者 (IdP) 以及 IAM 服務角色，才能在 GitLab Duo和 AWS 您的帳戶之間建立信任。若要了解如何建立所需的資源並設定 GitLab Duo with Amazon Q，請參閱 GitLab 文件中的設定 GitLab Duo with Amazon Q。

建立新的 IAM 角色時，也會一併建立具有必要許可的必要信任政策。角色信任政策是在 IAM 中連接至角色的以資源為基礎的必要政策。

您需要新增許可政策，以授與和 Amazon Q 連線的能力，並利用 GitLab Duo with Amazon Q 整合中的功能。建立 IAM 角色時，必須新增政策。若要進一步了解許可政策提供的許可，請參閱 GitLabDuoWithAmazonQPermissionsPolicy。

或者，您可以建立內嵌政策並新增必要的許可。如果您想要自訂存取控制，可以選擇建立內嵌政策。如需詳細資訊，請參閱《IAM 使用者指南》中的受管政策和內嵌政策及 AWS Identity and Access Management 中的政策和許可。

信任政策

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "sts:AssumeRoleWithWebIdentity",
            "Principal": {
                "Federated": "arn:aws:iam::111122223333:oidc-provider/auth.token.gitlab.com/cc/oidc/instance-id"
            },
            "Condition": {
                "StringEquals": {
                    "auth.token.gitlab.com/cc/oidc/instance-id:aud": "gitlab-cc-instance-id"
                }
            }
        }
    ]
}

許可政策

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "GitLabDuoUsagePermissions",
      "Effect": "Allow",
      "Action": [
        "q:SendEvent",
        "q:CreateAuthGrant",
        "q:UpdateAuthGrant",
        "q:GenerateCodeRecommendations",
        "q:SendMessage",
        "q:ListPlugins",
        "q:VerifyOAuthAppConnection"
      ],
      "Resource": "*"
    },
    {
      "Sid": "GitLabDuoManagementPermissions",
      "Effect": "Allow",
      "Action": [
        "q:CreateOAuthAppConnection",
        "q:DeleteOAuthAppConnection"
      ],
      "Resource": "*"
    },
    {
      "Sid": "GitLabDuoPluginPermissions",
      "Effect": "Allow",
      "Action": [
        "q:CreatePlugin",
        "q:DeletePlugin",
        "q:GetPlugin"
      ],
      "Resource": "arn:aws:qdeveloper:*:*:plugin/GitLabDuoWithAmazonQ/*"
    }
  ]
}

或者，如果您想要完全控制金鑰的生命週期和使用，您也可以使用客戶自管金鑰 (CMK) 來加密資源。kms:ViaService 條件金鑰可限制誰能使用 CMK 來加密和解密內容。如需詳細資訊，請參閱管理對 Amazon Q Developer 的存取權以進行第三方整合。

GitLab 快速動作

調用時，快速動作會在 GitLab 問題和合併請求中為您執行任務。若要了解如何在 GitLab 中調用快速動作，請參閱 GitLab 文件。

合併請求產生和迭代

  • /q dev - 可讓您從 GitLab 問題中擷取的高階構想開始著手，進展到讓 Amazon Q 使用建議的程式碼實作產生就緒可檢閱的合併請求。這有助於簡化將概念轉化成可行程式碼的程序。合併請求會在新分支中建立，而 Amazon Q 會將問題建立者指派為合併請求檢閱者。您也會收到合併請求摘要。如需詳細資訊，請參閱將構想轉化成合併請求。

  • /q dev (修訂) - 可讓您對 Amazon Q 提供的提議程式碼實作進行迭代，而不需從問題重新開始。Amazon Q 會檢閱您的意見回饋，並更新最初產生的程式碼。您也會收到每項變更的遞交訊息。每次迭代後的描述都會更新，且迭代中會納入描述意見回饋的註解。接著您就可以檢閱建議並將其合併到程式碼中。如需詳細資訊，請參閱根據意見回饋進行程式碼變更。

程式碼轉換

  • /q transform - 可讓您初始化從 Java Maven 8 或 Java Maven 11 升級至 Java Maven 17 專案的升級程序。Amazon Q 會從 GitLab 問題開始分析程式碼，以判斷必要的 Java 升級或現代化、更新問題、自動開啟包含提議變更的合併請求，並將問題建立者指派為檢閱者。您需要 GitLab Runner 設定才能建置，且其需要針對程式碼轉換加以自訂。如需詳細資訊，請參閱 自訂 CI/CD 管道以進行程式碼轉換 和升級 Java。

    注意

    您必須先識別 Maven 專案的來源版本，才能轉換程式碼，所以您的編譯器設定必須在 pom.xml 檔案內設定。因此，您的 pom.xml 檔案必須具有來源和目標。

單元測試產生

  • /q test - 可讓您在合併請求中，為新增的原始程式碼行產生單元測試。Amazon Q 會加上包含單元測試建議的註解，您可將這些建議新增至測試檔案中。您可以一次套用產生的測試，或在套用之前，個別檢閱每一項測試。如果在合併請求中找不到測試檔案，Amazon Q 會提供單元測試讓您手動新增至測試檔案中。如需詳細資訊，請參閱建立測試涵蓋範圍。

程式碼檢閱

  • /q review - 可讓您在 GitLab Duo with Amazon Q 中初始化合併請求檢閱。系統會針對新的合併請求初始化自動程式碼檢閱。身為 GitLab 管理員，您也可以設定 Amazon Q 以關閉自動檢閱。自動化程式碼檢閱會在 Amazon Q 產生時識別和修正潛在問題，並對您的合併請求建議程式碼修正。檢閱會提供品質檢查、分析問題、邏輯錯誤、反模式、程式碼重複等。

    Amazon Q 會提供包含註解的程式碼分析，且每一項註解都會提供個別的問題清單。此快速動作適用於所有語言。當您開啟新的合併請求或重新開啟先前關閉的合併請求時，就會初始化自動程式碼檢閱。不過，在現有合併請求內的後續遞交並不會觸發自動程式碼檢閱。您可以使用 /q review 快速動作手動觸發程式碼檢閱。

    您可以設定程式碼檢閱在 GitLab 執行個體或群組內，針對每個新的合併請求自動執行。如需詳細資訊，請參閱檢閱合併請求。

Web UI 和 IDE 中的聊天工作階段

  • GitLab Duo Chat and Code Suggestions 可搭配 Amazon Q 運作，以支援 CI/CD 組態、錯誤說明和解決問題。您可以在聊天工作階段中使用斜線命令，以調用 GitLab Duo with Amazon Q 聊天功能叫。如需詳細資訊，請參閱詢問 GitLab Duo Chat。