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

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

前往 Gemini 產品

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

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

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

建立索引。為了更快生成程式碼建議及查詢，這項功能須使用索引來分析及剖析存放區。

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

   • 選取在 Google 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

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

gcloud components update 

建立索引。為了更快生成程式碼建議及查詢，這項功能須使用索引來分析及剖析存放區。

1. 如要建立索引，請在 Shell 環境中使用 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：在 Google Cloud 專案的 Developer Connect 中設定的區域。

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

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

使用存放區群組控管索引存取權。存放區群組是索引設定的容器，包括存放區及其分支模式。存放區群組專為精細的 IAM 控制機制而設計，可讓開發人員存取這些群組的索引資料，前提是他們具備 cloudaicompanion.repositoryGroups.use 權限。

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

管理員會執行下列動作：

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

如要建立存放區群組，請在 Shell 環境中使用 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 repositories」頁面，然後在「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 檔案建立存放區群組，請在 Shell 環境中使用 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:[email protected]     - user:[email protected]     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 

確認您已設定開發人員連線，並連線至存放區：

• 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：在 Google 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 存放區」頁面，然後在「存放區」分頁中，尋找表格「連線」欄下方的連線 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 檔案建立存放區群組，請在 Shell 環境中使用 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 = ["[email protected]"]     }   }    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 = ["[email protected]"]   } 

前往 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：在 Google 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 

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

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

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