Codeanpassung für Gemini Code Assist konfigurieren

Hinweis: Die Codeanpassung für Gemini Code Assist ist nur in Gemini Code Assist Enterprise verfügbar. Weitere Informationen finden Sie unter Unterstützte Funktionen für Gemini Code Assist.

In diesem Dokument wird beschrieben, wie Sie die Codeanpassung für Gemini Code Assist in der Google Cloud Console, mit der Google Cloud CLI oder mit Terraform einrichten, indem Sie Gemini Code Assist mit Ihren privaten Code-Repositories verbinden. Mit der Funktion zur Codeanpassung für Gemini Code Assist können Sie Code-Empfehlungen erhalten, die auf den internen Bibliotheken, privaten APIs und dem Codierungsstil Ihrer Organisation basieren.

Vorbereitung

1. Richten Sie Gemini Code Assist ein, und zwar mit einem Enterprise-Abo.

2. Prüfen Sie, ob Sie die folgenden IAM-Rollen (Identity and Access Management) für das Projekt haben, zu dem das Abo gehört:

   • Code Repository Indexes Admin (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
   • Gemini for Google Cloud User (roles/cloudaicompanion.user)

3. Erstellen oder konfigurieren Sie Nutzerkonten. Jeder Entwickler in Ihrer Organisation, der Gemini Code Assist verwendet, muss eine Nutzeridentität inGoogle Cloud haben, die die Berechtigung hat, auf Ihr Projekt von Google Cloud zuzugreifen. Weitere Informationen finden Sie unter Rollen in der Google Cloud Console gewähren. Prüfen Sie, ob jeder Nutzer die folgenden Rollen hat:

   • Gemini for Google Cloud User
   • Repository Groups User

4. Bei der Funktion zur Codeanpassung werden Ihre privaten Repositories mit Developer Connect abgerufen und indexiert. Die Developer Connect-Region, in der sich Ihre Developer Connect-Repository-Verbindung befindet, muss auch ein unterstützter Standort für die Codeanpassung sein. Die Funktion zur Codeanpassung kann nicht verwendet werden, wenn sich die Developer Connect-Verbindung in einer nicht unterstützten Region befindet. Eine Liste der unterstützten Regionen finden Sie im Abschnitt zu den Beschränkungen der Codeanpassung.

Auswählen, welche Repositories indexiert werden

Als Best Practice sollten Sie Repositories indexieren, die die folgenden Merkmale haben:

• Code, der dem Stil oder der Struktur ähnelt, die Sie von Ihren Entwicklern erwarten
• Private Bibliotheken oder APIs, die Sie aus Ihrer aktuellen Codebasis aufrufen möchten

Optional: Nicht zu indexierende Dateien auswählen

Standardmäßig werden bei der Codeanpassung alle unterstützten Codedateien in den von Ihnen angegebenen Repositories indexiert.

Um zu verhindern, dass Code, den Sie nicht indexieren möchten, offengelegt wird, können Sie Zweigmuster verwenden, um den Zugriff auf Ihren Index zu steuern, und einen stabilen Zweig wie main verwenden.

Alternativ können Sie Dateien auch aus dem Index ausschließen, indem Sie eine .aiexclude-Datei erstellen.

Codeanpassung für Gemini Code Assist konfigurieren

Wählen Sie eine der folgenden Optionen aus:

Console

1. Rufen Sie in der Google Cloud Console die Seite Codeanpassung auf.

   Zur Codeanpassung für Gemini Code Assist

   Die Seite Codeanpassung für Gemini Code Assist wird geladen.

2. Erstellen Sie einen Index. Die Codeanpassung verwendet einen Index, um Ihr Repository zu analysieren und zu parsen und so schneller Vorschläge für die Codegenerierung und Suchergebnisse bereitzustellen.

   1. Klicken Sie auf Erstellen und konfigurieren Sie die Indexdetails:

      • Wählen Sie die Region aus, die in Developer Connect in Ihrem Projekt von Google Cloud konfiguriert ist.
      • Geben Sie einen Namen für den Index ein. Notieren Sie sich den Indexnamen. Sie benötigen ihn für mehrere Schritte in diesem Dokument.

   2. Klicken Sie auf Erstellen.

   Das Erstellen des Index dauert in der Regel 30 Minuten, kann aber auch bis zu einer Stunde in Anspruch nehmen. Wenn die Indexierung abgeschlossen ist, erhalten Sie eine Benachrichtigung in der Google Cloud Console.

   Google beschränkt die Anzahl der Code-Repository-Indexe auf einen pro Projekt und Organisation.

3. Steuern Sie den Zugriff auf Ihren Index mit Repository-Gruppen.

   Eine Repository-Gruppe ist ein Container für die Indexierungskonfiguration, der Repositories und ihre Zweigmuster enthält. Repository-Gruppen sind für die detaillierte IAM-Steuerung konzipiert. Entwickler erhalten Zugriff auf die indexierten Daten aus diesen Gruppen, sofern sie die Berechtigung cloudaicompanion.repositoryGroups.use haben.

   Repository-Gruppen enthalten Developer Connect-Repositories oder Links aus demselben Projekt und vom selben Standort.

4. Klicken Sie auf der Seite Codeanpassung für Gemini Code Assist auf Repositories hinzufügen und wählen Sie dann Quell-Repositories hinzufügen aus.

   Es wird eine Liste der vorhandenen Repositories in Developer Connect für die Region angezeigt, die Sie im vorherigen Schritt zum Erstellen des Index konfiguriert haben.

   Wenn Sie der Repository-Gruppe neue Repositories hinzufügen müssen, klicken Sie auf Repository verknüpfen und folgen Sie der Anleitung in der Google Cloud Console.

   Außerdem können Sie ein oder mehrere Repositorys auswählen und bearbeiten, um einen neuen Zweig hinzuzufügen.

5. Wählen Sie die Repository-Gruppe aus, der Sie neue Repositories hinzufügen möchten. Alternativ können Sie auf Neue Repository-Gruppe erstellen klicken, um eine neue Repository-Gruppe zu erstellen und zu konfigurieren.

6. Klicken Sie auf Index, um mit der Indexierung der ausgewählten Repositories zu beginnen.

   Die Indexierungsdauer hängt von der Größe der Repositories ab.

CLI

1. Prüfen Sie, ob Developer Connect konfiguriert und eine Verbindung zu Ihrem Repository hergestellt ist:
   • GitHub.com
   • GitLab.com
   • Bitbucket.org

2. Führen Sie in einer Shell-Umgebung den Befehl gcloud components update aus, um zu prüfen, ob Sie alle installierten Komponenten der gcloud CLI auf die aktuelle Version aktualisiert haben. Für diesen Schritt können Sie die gcloud CLI installieren und initialisieren oder den Cloud Shell-Editor verwenden.

   gcloud components update
   

3. Erstellen Sie einen Index. Die Codeanpassung verwendet einen Index, um Ihr Repository zu analysieren und zu parsen und so schneller Vorschläge für die Codegenerierung und Suchergebnisse bereitzustellen.

   1. Verwenden Sie in einer Shell-Umgebung den Befehl gemini code-repository-indexes create, um den Index zu erstellen:

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

      Ersetzen Sie Folgendes:

      • INDEX_NAME: Ihr Indexname. Wichtig: Notieren Sie sich den Namen des Index. Sie benötigen ihn für mehrere Schritte in diesem Dokument.
      • PROJECT_ID: Projekt-ID in Google Cloud .
      • REGION: Region, die in Developer Connect in Ihrem Projekt von Google Cloud konfiguriert ist.

      Das Erstellen des Index dauert in der Regel 30 Minuten, kann aber auch bis zu einer Stunde in Anspruch nehmen.

      Google beschränkt die Anzahl der Code-Repository-Indexe auf einen pro Projekt und Organisation.

4. Steuern Sie den Zugriff auf Ihren Index mit Repository-Gruppen. Eine Repository-Gruppe ist ein Container für die Indexierungskonfiguration, der Repositories und ihre Zweigmuster enthält. Repository-Gruppen sind für die detaillierte IAM-Steuerung konzipiert. Entwickler erhalten Zugriff auf die indexierten Daten aus diesen Gruppen, sofern sie die Berechtigung cloudaicompanion.repositoryGroups.use haben.

   Repository-Gruppen enthalten Developer Connect-Repositories oder Links aus demselben Projekt und vom selben Standort.

   Administratoren führen die folgenden Aktionen aus:

   • Code-Repository-Indexressource erstellen.
   • Im selben Projekt und am selben Standort eine neue Developer Connect-Verbindung konfigurieren.
   • Git-Repositories in der Verbindung verknüpfen.
   • Ressourcennamen von Links abrufen, für jeden Link ein zu indexierendes Zweigmuster auswählen und in eine oder mehrere Repository-Gruppen einfügen.

   Verwenden Sie zum Erstellen einer Repository-Gruppe in einer Shell-Umgebung den Befehl 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"}]'
   

   Hinweis: Sie können reguläre Ausdrücke in RE2-Syntax verwenden, um Zweignamen anzugeben.

   Ersetzen Sie Folgendes:

   • REPOSITORY_GROUP: Name der Repository-Gruppe, z. B. default.
   • REPOSITORY_RESOURCE_NAME: Name des Repositorys in der Developer Connect-Verbindung. Den Namen des Repositorys finden Sie auf der Seite Git-Repositories in der Google Cloud Console. Suchen Sie in der Tabelle auf dem Tab Repositories in der Spalte Verbindung nach der Verbindungs-ID. Klicken Sie zum Kopieren des Ressourcennamens auf das Menü more_vert und wählen Sie aus den Optionen Ressourcenpfad kopieren aus.
   • BRANCH_NAMES: Name der Zweige, die indexiert werden sollen, z. B. main|dev.

   Sie können auch eine Repository-Gruppe mit Repositories erstellen, die in einer JSON- oder YAML-Datei definiert sind. Die Datei muss so formatiert sein:

   JSON

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

   YAML

   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: main|dev
   
   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: dev
   

   So erstellen Sie eine Repository-Gruppe auf Grundlage einer JSON- oder YAML-Datei in einer Shell-Umgebung mit dem gemini code-repository-indexes repository-groups create-Befehl:

   JSON

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

   YAML

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

   Sie können Ihre Daten auch mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) über Cloud Key Management Service verschlüsseln und verwalten. Weitere Informationen zur Verwendung eines CMEK finden Sie unter Daten mit vom Kunden verwalteten Verschlüsselungsschlüsseln verschlüsseln.

5. Der Repository-Gruppe in einem Projekt IAM-Rollen zuweisen.

   Sie erhalten nur Vorschläge aus Repositories im Index. Jedes Repository gehört zu einer oder mehreren Repository-Gruppen. Damit Sie auf Vorschläge zugreifen können, müssen Sie der Repository-Gruppe die IAM-Rolle „Cloud AI Companion Repository Groups User“ (roles/cloudaicompanion.repositoryGroupsUser) zuweisen. Diese enthält die erforderliche IAM-Berechtigung cloudaicompanion.repositoryGroups.user. Das kann auf eine der folgenden Arten erfolgen:

   • Hauptkonten die Berechtigung zum Zugriff auf den gesamten Index gewähren

   • Hauptkonten Zugriff auf eine Teilmenge des Index gewähren

   Gesamter Index

   1. Verwenden Sie in einer Shell-Umgebung den Befehl projects add-iam-policy-binding, um eine IAM-Richtlinie für ein Projekt zu binden:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member='PRINCIPAL' \
          --role='roles/cloudaicompanion.repositoryGroupsUser'
      

      Ersetzen Sie Folgendes:

      • PRINCIPAL: E-Mail-Adresse des Hauptkontos, das Zugriff benötigt, z. B. user:[e-mail] für eine Einzelperson oder group:[e-mail] für eine Gruppe.

      Weitere Informationen finden Sie unter gcloud projects set-iam-policy.

   2. Wenn Sie aufgefordert werden, eine Bedingung anzugeben, geben Sie None ein.

   Teilmenge des Index

   Sie können mehrere Repository-Gruppen erstellen und verschiedenen IAM-Hauptkonten IAM-Rollen zuweisen.

   Um eine IAM-Richtlinie einzurichten, müssen Sie die JSON- oder YAML-Datei für die IAM-Richtlinie vorbereiten. Sie enthält eine Liste mit IAM-Gruppen und zugewiesenen Rollen. Beispiel:

     bindings:
     - members:
       - group:[e-mail]
       - user:[e-mail]
       role: roles/cloudaicompanion.repositoryGroupsUser
   

   Weitere Informationen und die Syntax finden Sie unter Informationen zu Zulassungsrichtlinien.

   Hinweis: Sie können Ihren IAM-Gruppen benutzerdefinierte Rollen zuweisen. Die benutzerdefinierte Rolle muss jedoch alle Berechtigungen der Rolle roles/cloudaicompanion.repositoryGroupsUser enthalten.

   Verwenden Sie zum Festlegen der IAM-Richtlinie in einer Shell-Umgebung den Befehl gemini code-repository-indexes repository-groups set-iam-policy:

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

   Ersetzen Sie Folgendes:

   • GROUP_NAME: Name der Repository-Gruppe, die Sie in einem vorherigen Schritt erstellt haben, um den Zugriff auf Ihren Index mit Repository-Gruppen zu steuern.

   • POLICY_FILE: Die IAM-Richtlinie.

     Weitere Informationen finden Sie unter gcloud gemini code-repository-indexes repository-groups set-iam-policy.

Terraform

1. Prüfen Sie, ob Developer Connect konfiguriert und eine Verbindung zu Ihrem Repository hergestellt ist:

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

2. Erstellen Sie einen Index. Die Codeanpassung verwendet einen Index, um Ihr Repository zu analysieren und zu parsen und so schneller Vorschläge für die Codegenerierung und Suchergebnisse bereitzustellen.

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

   Ersetzen Sie Folgendes:

   • INDEX_NAME: Ihr Indexname. Wichtig: Notieren Sie sich den Namen des Index. Sie benötigen ihn für mehrere Schritte in diesem Dokument.
   • PROJECT_ID: Projekt-ID in Google Cloud .
   • REGION: Region, die in Developer Connect in Ihrem Projekt von Google Cloud konfiguriert ist.

   Das Erstellen des Index dauert in der Regel 30 Minuten, kann aber auch bis zu einer Stunde in Anspruch nehmen.

   Google beschränkt die Anzahl der Code-Repository-Indexe auf einen pro Projekt und Organisation.

3. Steuern Sie den Zugriff auf Ihren Index mit Repository-Gruppen. Eine Repository-Gruppe ist ein Container für die Indexierungskonfiguration, der Repositories und ihre Zweigmuster enthält. Repository-Gruppen sind für die detaillierte IAM-Steuerung konzipiert. Entwickler erhalten Zugriff auf die indexierten Daten aus diesen Gruppen, sofern sie die Berechtigung cloudaicompanion.repositoryGroups.use haben.

   Repository-Gruppen enthalten Developer Connect-Repositories oder Links aus demselben Projekt und vom selben Standort.

   Administratoren führen die folgenden Aktionen aus:

   • Code-Repository-Indexressource erstellen.
   • Im selben Projekt und am selben Standort eine neue Developer Connect-Verbindung konfigurieren.
   • Git-Repositories in der Verbindung verknüpfen.
   • Ressourcennamen von Links abrufen, für jeden Link ein zu indexierendes Zweigmuster auswählen und in eine oder mehrere Repository-Gruppen einfügen.

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

   Hinweis: Sie können reguläre Ausdrücke in RE2-Syntax verwenden, um Zweignamen anzugeben.

   Ersetzen Sie Folgendes:

   • REPOSITORY_GROUP: Name der Repository-Gruppe, z. B. default.
   • REPOSITORY_RESOURCE_NAME: Name des Repositorys in der Developer Connect-Verbindung. Den Namen des Repositorys finden Sie auf der Seite Git-Repositories in der Google Cloud Console. Suchen Sie in der Tabelle auf dem Tab Repositories in der Spalte Verbindung nach der Verbindungs-ID. Klicken Sie zum Kopieren des Ressourcennamens auf das Menü more_vert und wählen Sie aus den Optionen Ressourcenpfad kopieren aus.
   • BRANCH_NAMES: Name der Zweige, die indexiert werden sollen, z. B. main|dev.

   Sie können auch eine Repository-Gruppe mit Repositories erstellen, die in einer JSON- oder YAML-Datei definiert sind. Die Datei muss so formatiert sein:

   JSON

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

   YAML

   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: main|dev
   
   - resource: REPOSITORY_RESOURCE_NAME
     branchPattern: dev
   

   So erstellen Sie eine Repository-Gruppe auf Grundlage einer JSON- oder YAML-Datei in einer Shell-Umgebung mit dem gemini code-repository-indexes repository-groups create-Befehl:

   JSON

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

   YAML

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

   Sie können Ihre Daten auch mit einem vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) über Cloud Key Management Service verschlüsseln und verwalten. Weitere Informationen zur Verwendung eines CMEK finden Sie unter Daten mit vom Kunden verwalteten Verschlüsselungsschlüsseln verschlüsseln.

4. Der Repository-Gruppe in einem Projekt IAM-Rollen zuweisen.

   Sie erhalten nur Vorschläge aus Repositories im Index. Jedes Repository gehört zu einer oder mehreren Repository-Gruppen. Damit Sie auf Vorschläge zugreifen können, müssen Sie der Repository-Gruppe die IAM-Rolle „Cloud AI Companion Repository Groups User“ (roles/cloudaicompanion.repositoryGroupsUser) zuweisen. Diese enthält die erforderliche IAM-Berechtigung cloudaicompanion.repositoryGroups.user. Das kann auf eine der folgenden Arten erfolgen:

   • Hauptkonten die Berechtigung zum Zugriff auf den gesamten Index gewähren

   • Hauptkonten Zugriff auf eine Teilmenge des Index gewähren

   Gesamter Index

   1. Verwenden Sie in einer Shell-Umgebung den Befehl projects add-iam-policy-binding, um eine IAM-Richtlinie für ein Projekt zu binden:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member='PRINCIPAL' \
          --role='roles/cloudaicompanion.repositoryGroupsUser'
      

      Ersetzen Sie Folgendes:

      • PRINCIPAL: E-Mail-Adresse des Hauptkontos, das Zugriff benötigt, z. B. user:[e-mail] für eine Einzelperson oder group:[e-mail] für eine Gruppe.

        Weitere Informationen finden Sie unter gcloud projects set-iam-policy.

   2. Wenn Sie aufgefordert werden, eine Bedingung anzugeben, geben Sie None ein.

   Teilmenge des Index

   Sie können mehrere Repository-Gruppen erstellen und verschiedenen IAM-Hauptkonten IAM-Rollen zuweisen.

     data "google_iam_policy" "foo" {
       binding {
         role = "roles/cloudaicompanion.repositoryGroupsUser"
         members = ["[e-mail]"]
       }
     }
   
     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
       ]
     }
   

   Sie können auch eine Bindung erstellen:

     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 = ["[e-mail]"]
     }
   

   Ersetzen Sie Folgendes:

   • GROUP_NAME: Name der Repository-Gruppe, die Sie in einem vorherigen Schritt erstellt haben, um den Zugriff auf Ihren Index mit Repository-Gruppen zu steuern.

Indexierungsstatus prüfen

Je nach Anzahl der zu indexierenden Repositories und deren Größe kann das Indexieren von Inhalten bis zu 24 Stunden dauern. Bei großen Repositories kann die Indexierung länger dauern. Die Indexierung erfolgt einmal alle 24 Stunden und berücksichtigt alle Änderungen, die im Repository vorgenommen wurden.

1. Suchen Sie nach den indexing-Logs. Weitere Informationen finden Sie unter Logging-Abfragesprache.

   Console

   1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf:

      Zum Log-Explorer

   2. Verwenden Sie den Filter für Log-Namen, um indexing-Logs aufzurufen.

   CLI

   Verwenden Sie in einer Shell-Umgebung den Befehl logging read, um nach den Indexierungsprotokollen zu suchen:

   gcloud logging read "logName="projects/PROJECT_ID/logs/indexing""
   

   Ersetzen Sie PROJECT_ID durch die Projekt-ID, in der sich die Repository-Gruppe befindet.

   Wenn Sie beispielsweise Fehler in den indexing-Logs ansehen möchten, führen Sie den folgenden Befehl aus:

   gcloud logging read "logName="projects/PROJECT_ID/logs/indexing" AND severity>=ERROR"
   

2. Sehen Sie sich die zugehörigen Indexierungsstatus an, z. B.:

   • Beginn der Repository-Indexierung, z. B. Indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 6, failed: 0.
   • Ende der Indexierung einzelner Repositorys, z. B.:
     • Erfolgreich: Successfully finished indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 7, failed: 0.
     • Fehler: Failed to index repository REPOSITORY_NAME. Error: [<error message>]. Total number of repositories: 10, succeeded: 7, failed: 1.
   • Ende der Repository-Indexierung, z. B.:
     • Erfolgreich: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 0.
     • Fehler: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 1. Repositories that were not successfully fetched will be retried in the next run.

   In den Indexstatus ist REPOSITORY_NAME das Repository, das Sie prüfen möchten.

3. Sehen Sie sich die zugehörigen Indexierungsfehler an, z. B.:

   • Repository konnte nicht abgerufen werden.
   • Repository-Dateien konnten nicht aufgelistet werden.
   • Repository-Informationen konnten nicht aus dem Index abgerufen werden.
   • Dateien konnten nicht aus dem Index abgerufen werden.
   • Interner Fehler.

Codeanpassung verwenden

Nachdem Sie die Codeanpassung eingerichtet haben, werden Ihnen Vorschläge für die Vervollständigung und Generierung von Code angezeigt, die möglicherweise auf privatem Code basieren, den Sie zusätzlich zu Ergebnissen aus der vollständigen Codebasis indexiert haben.

Weitere Informationen zur Verwendung von Codeanpassungen und zu Best Practices finden Sie unter Codeanpassung verwenden.

Codeanpassung deaktivieren

Wählen Sie eine der folgenden Optionen aus:

Console

1. Rufen Sie in der Google Cloud Console die Seite Gemini-Produkte auf.

   Zu Gemini-Produkten

   Die Seite Gemini-Produkte wird geladen.

2. Klicken Sie im Navigationsmenü auf Codeanpassung.

   Die Seite Codeanpassung wird geladen.

3. Klicken Sie zum Löschen des Index auf Löschen.

   Eine Warnmeldung wird angezeigt. Wenn Sie fortfahren und den Index löschen möchten, geben Sie den Indexnamen ein und klicken Sie auf Löschen.

CLI

1. Verwenden Sie in einer Shell-Umgebung den Befehl gemini code-repository-indexes repository-groups list, um alle Repository-Gruppen für den aktuellen Index aufzulisten:

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

   Ersetzen Sie Folgendes:

   • REGION: Region, die in Developer Connect in Ihrem Projekt von Google Cloud konfiguriert ist. Befehle schlagen fehl, wenn Sie eine nicht unterstützte Region angeben. Eine Liste der unterstützten Regionen finden Sie im Abschnitt zu den Beschränkungen der Codeanpassung.
   • PROJECT_ID: Projekt-ID in Google Cloud .
   • INDEX_NAME: Name des Index, den Sie in einem vorherigen Schritt erstellt haben.

2. Verwenden Sie den Befehl gemini code-repository-indexes repository-groups delete, um eine Repository-Gruppe aus dem aktuellen Index zu löschen:

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

3. Wiederholen Sie die vorherigen Schritte für jede Repository-Gruppe, bis Sie alle Repository-Gruppen aus dem Index gelöscht haben.

4. Optional: Wenn Sie den Index löschen möchten, verwenden Sie in einer Shell-Umgebung den Befehl gemini code-repository-indexes delete:

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

Nächste Schritte

• So verwenden Sie Gemini Code Assist:
  • VS Code, IntelliJ und andere unterstützte JetBrains-IDEs: Mit Gemini Code Assist programmieren
  • Cloud Shell-Editor: Mit Gemini Code Assist programmieren
  • Cloud Workstations: Mit Gemini Code Assist programmieren
• Weitere Informationen zur Verwendung von Codeanpassungen und Best Practices
• Informationen zum Verschlüsseln von Daten mit vom Kunden verwalteten Verschlüsselungsschlüsseln (CMEK)
• Weitere Informationen zu Developer Connect.
• Weitere Informationen dazu, wie und wann Gemini für Google Cloud Ihre Daten verwendet.