Gemini Code Assist のコード カスタマイズを構成する

Google Cloud コンソールで、[コード カスタマイズ] ページに移動します。

Gemini Code Assist のコード カスタマイズに移動します

[Gemini Code Assist のコード カスタマイズ] ページが読み込まれます。

インデックスを作成します。コード カスタマイズでは、インデックスを使用してリポジトリを分析および解析し、コード生成の候補と検索を迅速に行います。

1. [作成] をクリックして、インデックスの詳細を構成します。

   • Cloud プロジェクトの Developer Connect で構成されているリージョンを選択します。
   • インデックスの名前を入力します。インデックス名をメモします。このドキュメントのいくつかの手順で必要になります。

2. [作成] をクリックします。

インデックスの作成は通常 30 分で完了しますが、最長で 1 時間ほどかかることがあります。インデックス登録が完了すると、Google Cloud コンソールに通知が届きます。

コード リポジトリのインデックスの数は、プロジェクトごとに 1 つ、組織ごとに 1 つに制限されています。

リポジトリ グループを使用してインデックスへのアクセスを制御する

リポジトリ グループは、リポジトリとそのブランチ パターンを含むインデックス構成のコンテナです。リポジトリ グループは、きめ細かい IAM 制御を目的としており、デベロッパーは cloudaicompanion.repositoryGroups.use 権限を持つグループのインデックス登録されたデータにアクセスできます。

リポジトリ グループには、同じプロジェクトとロケーションの Developer Connect リポジトリまたはリンクが含まれます。

[Gemini Code Assist のコード カスタマイズ] ページで、[リポジトリを追加] をクリックし、[ソース リポジトリを追加] を選択します。

前の手順でインデックスの作成用に構成したリージョンの Developer Connect にある既存のリポジトリのリストが表示されます。

リポジトリ グループに新しいリポジトリを追加する必要がある場合は、[リポジトリをリンク] をクリックして、Google Cloud コンソールの手順に沿って操作します。

また、1 つ以上のリポジトリを選択して編集し、新しいブランチを追加することもできます。

新しいリポジトリを追加するリポジトリ グループを選択します。または、[新しいリポジトリ グループを作成] をクリックして、新しいリポジトリ グループを作成して構成します。

選択したリポジトリのインデックス登録を開始するには、[インデックス登録] をクリックします。

インデックス作成時間は、リポジトリのサイズによって異なります。

• 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 分で完了しますが、最長で 1 時間ほどかかることがあります。

   コード リポジトリのインデックスの数は、プロジェクトごとに 1 つ、組織ごとに 1 つに制限されています。

リポジトリ グループを使用してインデックスへのアクセスを制御するリポジトリ グループは、リポジトリとそのブランチ パターンを含むインデックス構成のコンテナです。リポジトリ グループは、きめ細かい IAM 制御を目的としており、デベロッパーは cloudaicompanion.repositoryGroups.use 権限を持つグループのインデックス登録されたデータにアクセスできます。

リポジトリ グループには、同じプロジェクトとロケーションの Developer Connect リポジトリまたはリンクが含まれます。

管理者は次の操作を行います。

• Code Repository Index リソースを作成します。
• 同じプロジェクトとロケーションで、新しい Developer Connect 接続を構成します。
• 接続で Git リポジトリをリンクします。
• リンクのリソース名を取得し、リンクごとにインデックス登録するブランチ パターンを選択して、1 つ以上のリポジトリ グループに配置します。

リポジトリ グループを作成するには、シェル環境で 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 ロールを付与する

インデックス内のリポジトリからの候補のみが提示されます。各リポジトリは 1 つ以上のリポジトリ グループに属します。候補にアクセスするには、次のいずれかの方法で、必要な cloudaicompanion.repositoryGroups.user IAM 権限を含む Cloud AI コンパニオン リポジトリ グループ ユーザーの IAM ロール（roles/cloudaicompanion.repositoryGroupsUser）をリポジトリ グループに付与する必要があります。

• プリンシパルにインデックス全体へのアクセス権を付与する。

• プリンシパルにインデックスのサブセットへのアクセス権を付与する。

  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: インデックス名。重要: インデックス名をメモします。このドキュメントのいくつかの手順で必要になります。
• PROJECT_ID: Google Cloud プロジェクト ID。
• REGION: Cloud プロジェクトの Developer Connect で構成されているリージョン。コマンドを成功させるには、サポートされているリージョンを指定する必要があります。

インデックスの作成は通常 30 分で完了しますが、最長で 1 時間ほどかかることがあります。

コード リポジトリのインデックスの数は、プロジェクトごとに 1 つ、組織ごとに 1 つに制限されています。

リポジトリ グループを使用してインデックスへのアクセスを制御するリポジトリ グループは、リポジトリとそのブランチ パターンを含むインデックス構成のコンテナです。リポジトリ グループは、きめ細かい IAM 制御を目的としており、デベロッパーは cloudaicompanion.repositoryGroups.use 権限を持つグループのインデックス登録されたデータにアクセスできます。

リポジトリ グループには、同じプロジェクトとロケーションの Developer Connect リポジトリまたはリンクが含まれます。

管理者は次の操作を行います。

• Code Repository Index リソースを作成します。
• 同じプロジェクトとロケーションで、新しい Developer Connect 接続を構成します。
• 接続で Git リポジトリをリンクします。
• リンクのリソース名を取得し、リンクごとにインデックス登録するブランチ パターンを選択して、1 つ以上のリポジトリ グループに配置します。

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 ファイルに基づいてリポジトリ グループを作成するには、シェル環境で 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 ロールを付与する

インデックス内のリポジトリからの候補のみが提示されます。各リポジトリは 1 つ以上のリポジトリ グループに属します。候補にアクセスするには、次のいずれかの方法で、必要な cloudaicompanion.repositoryGroups.user IAM 権限を含む Cloud AI コンパニオン リポジトリ グループ ユーザーの IAM ロール（roles/cloudaicompanion.repositoryGroupsUser）をリポジトリ グループに付与する必要があります。

• プリンシパルにインデックス全体へのアクセス権を付与する。

• プリンシパルにインデックスのサブセットへのアクセス権を付与する。

  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 プロダクト] ページに移動します。

[Gemini プロダクト] に移動

[Gemini プロダクト] ページが読み込まれます。

ナビゲーション メニューで [コード カスタマイズ] をクリックします。

[コード カスタマイズ] ページが読み込まれます。

インデックスを削除するには、[削除] をクリックします。

警告メッセージが表示されます。続行してインデックスを削除する場合は、インデックス名を入力して [削除] をクリックします。

現在のインデックスのすべてのリポジトリ グループを一覧表示するには、シェル環境で 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