設定 Gemini Code Assist 程式碼自訂功能

前往 Google Cloud 控制台的「程式碼自訂」頁面。

前往 Gemini Code Assist 的程式碼自訂功能

系統會載入「Gemini Code Assist 的程式碼自訂功能」頁面。

建立索引。程式碼自訂功能會使用索引來分析及剖析存放區，使查詢與生成程式碼建議的速度更快。

1. 按一下「建立」，然後設定索引詳細資料：

   • 選取 Cloud 專案中 Developer Connect 設定的區域。
   • 輸入索引名稱。請記下索引名稱。本文中的多個步驟都需要用到這個 ID。

2. 按一下「建立」。

建立索引通常需要 30 分鐘，但最久可能需要一小時。索引作業完成後，您會在 Google Cloud 控制台收到通知。

Google 限制每個專案和機構只能有一個程式碼存放區索引。

使用存放區群組控管索引的存取權。

存放區群組是一種索引設定容器，內容包含存放區及其分支版本模式。存放區群組能提供精細的 IAM 控管機制，讓開發人員只能存取這些群組中已編入索引的資料，且必須具備 cloudaicompanion.repositoryGroups.use 權限。

存放區群組包含來自相同專案和位置的 Developer Connect 存放區或連結。

在「Gemini Code Assist 的程式碼自訂功能」頁面中，按一下「新增存放區」，然後選取「新增來源存放區」。

系統會顯示 Developer Connect 中現有的存放區清單，這些存放區位於您在上一個步驟中設定的區域，可建立索引。

如要將新存放區新增至存放區群組，請按一下「連結存放區」，然後按照 Google Cloud 控制台中的步驟操作。

此外，您也可以選取一或多個存放區，然後進行編輯，新增分支。

選取要新增存放區的存放區群組。 或者，按一下「建立新的存放區群組」，建立並設定新的存放區群組。

如要開始為所選存放區建立索引，請按一下「建立索引」。

建立索引的時間長短會因存放區大小而異。

• GitHub.com
• GitLab.com
• Bitbucket.org

在殼層環境中執行 gcloud components update 指令，確認您已將所有已安裝的 gcloud 元件更新至最新版本。在這個步驟中，您可以安裝並初始化 gcloud，也可以使用 Cloud Shell 編輯器。

gcloud components update

建立索引。程式碼自訂功能會使用索引來分析及剖析存放區，使查詢與生成程式碼建議的速度更快。

1. 如要建立索引，請在殼層環境中使用 gemini code-repository-indexes create 指令：

   gcloud gemini code-repository-indexes create INDEX_NAME \
       --project=PROJECT_ID \
       --location=REGION
   

   更改下列內容：

   • INDEX_NAME：索引名稱。重要事項： 請記下索引名稱。本文件中的多個步驟都需要這項資訊。
   • PROJECT_ID：您的 Google Cloud 專案 ID。
   • REGION：在 Cloud 專案的 Developer Connect 中設定的區域。如要成功執行指令，您必須指定支援的區域。

   建立索引通常需要 30 分鐘，但最久可能需要一小時。

   Google 限制每個專案和機構只能有一個程式碼存放區索引。

使用存放區群組控管索引的存取權。存放區群組是一種索引設定容器，內容包含存放區及其分支版本模式。存放區群組能提供精細的 IAM 控管機制，讓開發人員只能存取這些群組中已編入索引的資料，且必須具備 cloudaicompanion.repositoryGroups.use 權限。

存放區群組包含來自相同專案和位置的 Developer Connect 存放區或連結。

管理員會執行下列動作：

• 建立程式碼存放區索引資源。
• 在相同專案和位置中，設定新的 Developer Connect 連線。
• 連結連線中的 Git 存放區。
• 取得連結的資源名稱、為每個連結選擇要建立索引的分支模式，然後將連結放入一或多個存放區群組。

如要建立存放區群組，請在殼層環境中使用 gemini code-repository-indexes repository-groups create 指令：

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories='[{"resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "BRANCH_NAMES"}]'

更改下列內容：

• REPOSITORY_GROUP：存放區群組名稱，例如 default。
• REPOSITORY_RESOURCE_NAME：Developer Connect 連線中的存放區名稱。如要找出存放區名稱，請前往 Google Cloud 控制台的「Git 存放區」頁面，然後在「存放區」分頁中，尋找表格「連線」欄底下的連線 ID。如要複製資源名稱，請按一下「更多選項」more_vert 選單，然後選取「複製資源路徑」。
• BRANCH_NAMES：要建立索引的分支名稱，例如 main|dev。

您也可以使用 JSON (或 YAML) 檔案中定義的存放區建立存放區群組，格式如下：

[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev

如要根據 JSON 或 YAML 檔案建立存放區群組，請在殼層環境中使用 gemini code-repository-indexes repository-groups create 指令：

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml

如要加密及控管資料，您也可以透過 Cloud Key Management Service，使用客戶管理的加密金鑰 (CMEK)。如要進一步瞭解如何使用 CMEK，請參閱「使用客戶管理的加密金鑰加密資料」。

在專案中將 IAM 角色授予存放區群組。

系統只會根據索引中的存放區內容，為您提供建議。每個存放區都屬於一或多個存放區群組。如要存取建議，您必須透過下列其中一種方式，將「Cloud AI Companion 存放區群組使用者」IAM 角色 (roles/cloudaicompanion.repositoryGroupsUser) 授予存放區群組，當中包含必要的 cloudaicompanion.repositoryGroups.user IAM 權限：

• 授予主體整個索引的存取權。

• 授予主體索引部分內容的存取權。

  bindings:
  - members:
    - group:my-group@example.com
    - user:test-user@example.com
    role: roles/cloudaicompanion.repositoryGroupsUser

  gcloud gemini code-repository-indexes repository-groups set-iam-policy GROUP_NAMEPOLICY_FILE \
      --project=PROJECT_ID \
      --location=REGION \
      --code-repository-index=INDEX_NAME

確認您已設定 Developer Connect 並連線至存放區：

• GitHub.com
• GitLab.com
• Bitbucket.org

建立索引。程式碼自訂功能會使用索引來分析及剖析存放區，使查詢與生成程式碼建議的速度更快。

resource "google_gemini_code_repository_index" "example" {
  location = "REGION"
  code_repository_index_id = "INDEX_NAME"
}

更改下列內容：

• INDEX_NAME：索引名稱。重要事項： 請記下索引名稱。您需要這個 ID 才能完成本文中的幾個步驟。
• PROJECT_ID：您的 Google Cloud 專案 ID。
• REGION：在 Cloud 專案的 Developer Connect 中設定的區域。如要成功執行指令，您必須指定支援的區域。

建立索引通常需要 30 分鐘，但最久可能需要一小時。

Google 限制每個專案和機構只能有一個程式碼存放區索引。

使用存放區群組控管索引的存取權。存放區群組是一種索引設定容器，內容包含存放區及其分支版本模式。存放區群組能提供精細的 IAM 控管機制，讓開發人員只能存取這些群組中已編入索引的資料，且必須具備 cloudaicompanion.repositoryGroups.use 權限。

存放區群組包含來自相同專案和位置的 Developer Connect 存放區或連結。

管理員會執行下列動作：

• 建立程式碼存放區索引資源。
• 在相同專案和位置中，設定新的 Developer Connect 連線。
• 連結連線中的 Git 存放區。
• 取得連結的資源名稱、為每個連結選擇要建立索引的分支模式，然後將連結放入一或多個存放區群組。

resource "google_gemini_repository_group" "example" {
  location = "REGION"
  code_repository_index = "INDEX_NAME"
  repository_group_id = "REPOSITORY_GROUP"
  repositories {
    resource = "REPOSITORY_RESOURCE_NAME"
    branch_pattern = "BRANCH_NAMES"
  }
}

更改下列內容：

• REPOSITORY_GROUP：存放區群組名稱，例如 default。
• REPOSITORY_RESOURCE_NAME：Developer Connect 連線中的存放區名稱。如要找出存放區名稱，請前往 Google Cloud 控制台的「Git repositories」(Git 存放區) 頁面，然後在「Repositories」(存放區) 分頁中，找出表格「Connection」(連線) 欄下方的連線 ID。如要複製資源名稱，請按一下「更多」more_vert 選單，然後選取「複製資源路徑」。
• BRANCH_NAMES：要建立索引的分支名稱，例如 main|dev。

您也可以使用 JSON (或 YAML) 檔案中定義的存放區建立存放區群組，格式如下：

[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev

如要根據 JSON 或 YAML 檔案建立存放區群組，請在殼層環境中使用 gemini code-repository-indexes repository-groups create 指令：

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json

gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml

如要加密及控管資料，您也可以透過 Cloud Key Management Service，使用客戶管理的加密金鑰 (CMEK)。如要進一步瞭解如何使用 CMEK，請參閱「使用客戶管理的加密金鑰加密資料」。

在專案中將 IAM 角色授予存放區群組。

系統只會根據索引中的存放區內容，為您提供建議。每個存放區都屬於一或多個存放區群組。如要存取建議，您必須透過下列其中一種方式，將「Cloud AI Companion 存放區群組使用者」IAM 角色 (roles/cloudaicompanion.repositoryGroupsUser) 授予存放區群組，當中包含必要的 cloudaicompanion.repositoryGroups.user IAM 權限：

• 授予主體整個索引的存取權。

• 授予主體索引部分內容的存取權。

  data "google_iam_policy" "foo" {
    binding {
      role = "roles/cloudaicompanion.repositoryGroupsUser"
      members = ["test-user@example.com"]
    }
  }

  resource "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    policy_data = data.google_iam_policy.foo.policy_data
  }

  data "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    depends_on = [
      google_gemini_repository_group_iam_policy.foo
    ]
  }

  resource "google_gemini_repository_group_iam_binding" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    role = "roles/cloudaicompanion.repositoryGroupsUser"
    members = ["test-user@example.com"]
  }

前往 Google Cloud 控制台的「Gemini Products」頁面。

前往 Gemini 產品頁面

系統會載入「Gemini 產品」頁面。

在導覽選單中，按一下「程式碼自訂」。

系統會載入「程式碼自訂」頁面。

如要刪除索引，請按一下「刪除」。

系統隨即會顯示警告訊息。如要繼續刪除索引，請輸入索引名稱，然後按一下「Delete」(刪除)。

如要列出目前索引的所有存放區群組，請在殼層環境中使用 gemini code-repository-indexes repository-groups list 指令：

gcloud gemini code-repository-indexes repository-groups list --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME --uri

更改下列內容：

• REGION：在 Cloud 專案的 Developer Connect 中設定的區域。如要成功執行指令，您必須指定支援的區域。
• PROJECT_ID：您的 Google Cloud 專案 ID。
• INDEX_NAME：您在上一個步驟中建立的索引名稱，用於建立索引。

如要從目前的索引刪除存放區群組，請使用 gemini code-repository-indexes repository-groups delete 指令：

gcloud gemini code-repository-indexes repository-groups delete REPOSITORY_GROUP \
    --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME

針對每個存放區群組重複上述步驟，直到從索引中刪除所有存放區群組為止。

選用：如要刪除索引，請在殼層環境中使用 gemini code-repository-indexes delete 指令：

gcloud gemini code-repository-indexes delete INDEX_NAME \
    --location=REGION \
    --project=PROJECT_ID