Configurer la personnalisation du code Gemini Code Assist

Dans la console API, accédez à la page Personnalisation du code.

Accéder à la personnalisation du code pour Gemini Code Assist

La page Personnalisation du code pour Gemini Code Assist se charge.

Créer un index. La personnalisation du code s'appuie sur un index pour analyser votre dépôt afin de générer des suggestions de code et des recherches plus rapidement.

1. Cliquez sur Créer et configurez les détails de l'index :

   • Sélectionnez la région configurée dans Developer Connect dans votre projet Cloud.
   • Saisissez un nom pour votre index. Notez le nom de votre index. Vous en aurez besoin à plusieurs étapes de ce document.

2. Cliquez sur Créer.

La création d'un index prend généralement 30 minutes, mais peut durer jusqu'à une heure. Une fois l'indexation terminée, vous recevez une notification dans la console Google APIs.

Google limite le nombre d'index de dépôt de code à un par projet et par organisation.

Contrôlez l'accès à votre index à l'aide de groupes de dépôts.

Un groupe de dépôts est un conteneur pour la configuration de l'indexation, qui inclut les dépôts et leurs modèles de branche. Les groupes de dépôts sont conçus pour un contrôle IAM précis. Ils permettent aux développeurs d'accéder aux données indexées de ces groupes, où ils disposent de l'autorisation cloudaicompanion.repositoryGroups.use.

Les groupes de dépôts contiennent des dépôts ou des liens Developer Connect provenant du même projet et du même emplacement.

Sur la page Personnalisation du code pour Gemini Code Assist, cliquez sur Ajouter des dépôts, puis sélectionnez Ajouter des dépôts sources.

Une liste des dépôts existants dans Developer Connect s'affiche pour la région que vous avez configurée à l'étape précédente afin de créer l'index.

Si vous devez ajouter des dépôts au groupe de dépôts, cliquez sur Associer un dépôt, puis suivez la procédure dans la console Google APIs.

Vous pouvez également sélectionner un ou plusieurs dépôts, puis les modifier pour ajouter une branche.

Sélectionnez le groupe de dépôts auquel vous souhaitez ajouter des dépôts. Vous pouvez également cliquer sur Créer un groupe de dépôts pour créer et configurer un groupe de dépôts.

Pour commencer à indexer les dépôts sélectionnés, cliquez sur Indexer.

Le temps d'indexation varie en fonction de la taille des dépôts.

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

Dans un environnement de shell, exécutez la commande gcloud components update pour vérifier que tous les composants installés de gcloud ont été mis à jour vers la dernière version. Pour cette étape, vous pouvez installer et initialiser gcloud, ou utiliser l'éditeur Cloud Shell.

gcloud components update

Créer un index. La personnalisation du code s'appuie sur un index pour analyser votre dépôt afin de générer des suggestions de code et des recherches plus rapidement.

1. Pour créer l'index, dans un environnement de shell, utilisez la commande gemini code-repository-indexes create :

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

   Remplacez les éléments suivants :

   • INDEX_NAME : nom de votre index. Important : Notez le nom de votre index. Vous en aurez besoin à plusieurs étapes de ce document.
   • PROJECT_ID : ID de votre projet Google Cloud.
   • REGION : région configurée dans Developer Connect de votre projet Cloud.

   La création d'un index prend généralement 30 minutes, mais peut durer jusqu'à une heure.

   Google limite le nombre d'index de dépôt de code à un par projet et par organisation.

Contrôlez l'accès à votre index à l'aide de groupes de dépôts. Un groupe de dépôts est un conteneur pour la configuration de l'indexation, qui inclut les dépôts et leurs modèles de branche. Les groupes de dépôts sont conçus pour un contrôle IAM précis. Ils permettent aux développeurs d'accéder aux données indexées de ces groupes, où ils disposent de l'autorisation cloudaicompanion.repositoryGroups.use.

Les groupes de dépôts contiennent des dépôts ou des liens Developer Connect provenant du même projet et du même emplacement.

Les administrateurs peuvent :

• créer une ressource d'index de dépôt de code ;
• configurer une connexion Developer Connect dans le même projet et au même emplacement ;
• associer des dépôts Git dans la connexion ;
• obtenir les noms de ressources des liens, choisir le modèle de branche à indexer pour chaque lien et le placer dans un ou plusieurs groupes de dépôts.

Pour créer un groupe de dépôts, dans un environnement de shell, utilisez la commande 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"}]'

Remplacez les éléments suivants :

• REPOSITORY_GROUP : nom du groupe de dépôts, tel que default.
• REPOSITORY_RESOURCE_NAME : nom du dépôt dans la connexion Developer Connect. Pour trouver le nom du dépôt, accédez à la page Dépôts Git de la console Google Cloud. Ensuite, dans l'onglet Dépôts, recherchez l'ID de connexion sous la colonne Connexion du tableau. Pour copier le nom de la ressource, cliquez sur le menu more_vert pour afficher plus d'options, puis sélectionnez Copier le chemin d'accès à la ressource.
• BRANCH_NAMES : nom des branches que vous souhaitez indexer, par exemple main|dev.

Vous pouvez également créer un groupe de dépôts avec des dépôts définis dans un fichier JSON (ou YAML), au format suivant :

[
  {
      "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

Pour créer un groupe de dépôts à partir d'un fichier JSON ou YAML, dans un environnement de shell, utilisez la commande 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

Si vous préférez, vous pouvez chiffrer et contrôler vos données avec une clé de chiffrement gérée par le client (CMEK) via Cloud Key Management Service. Pour en savoir plus sur l'utilisation d'une CMEK, consultez Chiffrer les données avec des clés de chiffrement gérées par le client.

Attribuez des rôles IAM au groupe de dépôts dans un projet.

Vous ne recevez que des suggestions provenant de dépôts figurant dans l'index. Chaque dépôt appartient à un ou plusieurs groupes de dépôts. Pour accéder aux suggestions, vous devez attribuer le rôle IAM Utilisateur des groupes de dépôts Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser), qui contient l'autorisation IAM cloudaicompanion.repositoryGroups.user requise, au groupe de dépôts de l'une des manières suivantes :

• Accordez aux comptes principaux l'autorisation d'accéder à l'intégralité de l'index.

• Accordez aux comptes principaux l'accès à un sous-ensemble de l'index.

  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

Vérifiez que vous avez configuré Developer Connect et que vous êtes connecté à votre dépôt :

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

Créer un index. La personnalisation du code s'appuie sur un index pour analyser votre dépôt afin de générer des suggestions de code et des recherches plus rapidement.

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

Remplacez les éléments suivants :

• INDEX_NAME : nom de votre index. Important : Notez le nom de votre index. Vous en aurez besoin à plusieurs étapes de ce document.
• PROJECT_ID : ID de votre projet Google Cloud.
• REGION : région configurée dans Developer Connect de votre projet Cloud.

La création d'un index prend généralement 30 minutes, mais peut durer jusqu'à une heure.

Google limite le nombre d'index de dépôt de code à un par projet et par organisation.

Contrôlez l'accès à votre index à l'aide de groupes de dépôts. Un groupe de dépôts est un conteneur pour la configuration de l'indexation, qui inclut les dépôts et leurs modèles de branche. Les groupes de dépôts sont conçus pour un contrôle IAM précis. Ils permettent aux développeurs d'accéder aux données indexées de ces groupes, où ils disposent de l'autorisation cloudaicompanion.repositoryGroups.use.

Les groupes de dépôts contiennent des dépôts ou des liens Developer Connect provenant du même projet et du même emplacement.

Les administrateurs peuvent :

• créer une ressource d'index de dépôt de code ;
• configurer une connexion Developer Connect dans le même projet et au même emplacement ;
• associer des dépôts Git dans la connexion ;
• obtenir les noms de ressources des liens, choisir le modèle de branche à indexer pour chaque lien et le placer dans un ou plusieurs groupes de dépôts.

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"
  }
}

Remplacez les éléments suivants :

• REPOSITORY_GROUP : nom du groupe de dépôts, tel que default.
• REPOSITORY_RESOURCE_NAME : nom du dépôt dans la connexion Developer Connect. Pour trouver le nom du dépôt, accédez à la page Dépôts Git dans la console Google Cloud. Ensuite, dans l'onglet Dépôts, recherchez l'ID de connexion sous la colonne Connexion du tableau. Pour copier le nom de la ressource, cliquez sur le menu more_vert pour afficher plus d'options, puis sélectionnez Copier le chemin d'accès à la ressource.
• BRANCH_NAMES : nom des branches que vous souhaitez indexer, par exemple main|dev.

Vous pouvez également créer un groupe de dépôts avec des dépôts définis dans un fichier JSON (ou YAML), au format suivant :

[
  {
      "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

Pour créer un groupe de dépôts à partir d'un fichier JSON ou YAML, dans un environnement de shell, utilisez la commande 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

Si vous préférez, vous pouvez chiffrer et contrôler vos données avec une clé de chiffrement gérée par le client (CMEK) via Cloud Key Management Service. Pour en savoir plus sur l'utilisation d'une CMEK, consultez Chiffrer les données avec des clés de chiffrement gérées par le client.

Attribuez des rôles IAM au groupe de dépôts dans un projet.

Vous ne recevez que des suggestions provenant de dépôts figurant dans l'index. Chaque dépôt appartient à un ou plusieurs groupes de dépôts. Pour accéder aux suggestions, vous devez attribuer le rôle IAM Utilisateur des groupes de dépôts Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser), qui contient l'autorisation IAM cloudaicompanion.repositoryGroups.user requise, au groupe de dépôts de l'une des manières suivantes :

• Accordez aux comptes principaux l'autorisation d'accéder à l'intégralité de l'index.

• Accordez aux comptes principaux l'accès à un sous-ensemble de l'index.

  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"]
  }

Dans la console d'API, accédez à la page Produits Gemini.

Accéder aux produits Gemini

La page Produits Gemini se charge.

Dans le menu de navigation, cliquez sur Personnalisation du code.

La page Personnalisation du code se charge.

Pour supprimer l'index, cliquez sur Supprimer l'index.

Un message d'avertissement s'affiche. Si vous souhaitez continuer et supprimer l'index, saisissez son nom, puis cliquez sur Supprimer.

Pour lister tous les groupes de dépôts de l'index actuel, dans un environnement de shell, utilisez la commande 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

Remplacez les éléments suivants :

• REGION : région configurée dans Developer Connect de votre projet Cloud. Notez que les commandes échoueront si vous spécifiez une région non compatible. Pour obtenir la liste des régions disponibles, consultez les limites de la personnalisation du code.
• PROJECT_ID : ID de votre projet Google Cloud.
• INDEX_NAME : nom de l'index que vous avez créé lors d'une étape précédente (créer un index).

Pour supprimer un groupe de dépôts de l'index actuel, utilisez la commande 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

Répétez les étapes précédentes pour chaque groupe de dépôts jusqu'à ce que vous ayez supprimé tous les groupes de dépôts de l'index.

Facultatif : Pour supprimer l'index, dans un environnement de shell, utilisez la commande gemini code-repository-indexes delete :

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