Konfigurowanie dostosowywania kodu w Gemini Code Assist

W konsoli Google Cloud otwórz stronę Dostosowywanie kodu.

Przejdź do sekcji Dostosowywanie kodu dla Gemini Code Assist

Otworzy się strona Dostosowywanie kodu dla Gemini Code Assist.

Utwórz indeks. Dostosowywanie kodu opiera się na indeksie, który umożliwia analizę pozwalającą szybciej generować sugestie i wyszukiwać kod.

1. Kliknij Utwórz i skonfiguruj szczegóły indeksu:

   • Wybierz region skonfigurowany w Developer Connect w projekcie w chmurze.
   • Wpisz nazwę indeksu. Zanotuj nazwę indeksu. Będziesz go potrzebować w kilku krokach tego dokumentu.

2. Kliknij Utwórz.

Tworzenie indeksu trwa zwykle 30 minut, ale może potrwać nawet godzinę. Po zakończeniu indeksowania otrzymasz powiadomienie w konsoli Google Cloud.

Google ogranicza liczbę indeksów repozytoriów kodu do jednego na projekt i organizację.

Kontroluj dostęp do indeksu za pomocą grup repozytoriów.

Grupa repozytoriów to kontener konfiguracji indeksowania, która obejmuje repozytoria i wzorce gałęzi. Grupy repozytoriów są przeznaczone do szczegółowej kontroli dostępu i zapewniają deweloperom dostęp do zindeksowanych danych z tych grup, w których mają uprawnienie cloudaicompanion.repositoryGroups.use.

Grupy repozytoriów zawierają repozytoria Developer Connect lub linki z tego samego projektu i lokalizacji.

Na stronie Dostosowywanie kodu dla Gemini Code Assist kliknij Dodaj repozytoria, a następnie wybierz Dodaj repozytoria źródłowe.

Wyświetli się lista repozytoriów w Developer Connect w regionie skonfigurowanym w poprzednim kroku na potrzeby utworzenia indeksu.

Jeśli chcesz dodać nowe repozytoria do grupy repozytoriów, kliknij Połącz repozytorium i wykonaj czynności w konsoli Google Cloud.

Możesz też wybrać co najmniej 1 repozytorium i go edytować, aby dodać nowy branch.

Wybierz grupę repozytoriów, do której chcesz dodać nowe repozytoria. Możesz też kliknąć Utwórz nową grupę repozytoriów, aby utworzyć i skonfigurować nową grupę repozytoriów.

Aby rozpocząć indeksowanie wybranych repozytoriów, kliknij Indeksuj.

Czas indeksowania zależy od rozmiaru repozytoriów.

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

W środowisku powłoki uruchom gcloud components update polecenie, aby sprawdzić, czy wszystkie zainstalowane komponenty gcloud zostały zaktualizowane do najnowszej wersji. Na tym etapie możesz zainstalować i zainicjować gcloud lub użyć edytora Cloud Shell.

gcloud components update

Utwórz indeks. Dostosowywanie kodu opiera się na indeksie, który umożliwia analizę pozwalającą szybciej generować sugestie i wyszukiwać kod.

1. Aby utworzyć indeks, w środowisku powłoki użyj gemini code-repository-indexes createpolecenia:

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

   Zastąp następujące elementy:

   • INDEX_NAME: nazwa indeksu. Ważne: zanotuj nazwę indeksu. Będzie Ci potrzebny w kilku krokach opisanych w tym dokumencie.
   • PROJECT_ID: identyfikator Twojego projektu Google Cloud;
   • REGION: region skonfigurowany w Developer Connect w Twoim projekcie w chmurze. Aby polecenia działały, musisz określić obsługiwany region.

   Tworzenie indeksu trwa zwykle 30 minut, ale może potrwać nawet godzinę.

   Google ogranicza liczbę indeksów repozytoriów kodu do jednego na projekt i organizację.

Kontroluj dostęp do indeksu za pomocą grup repozytoriów. Grupa repozytoriów to kontener konfiguracji indeksowania, który zawiera repozytoria i wzorce ich gałęzi. Grupy repozytoriów są przeznaczone do szczegółowej kontroli dostępu, dzięki czemu deweloperzy mają dostęp do zindeksowanych danych z tych grup, w których mają uprawnienie cloudaicompanion.repositoryGroups.use.

Grupy repozytoriów zawierają repozytoria Developer Connect lub linki z tego samego projektu i lokalizacji.

Administratorzy wykonują te działania:

• Utwórz zasób indeksu repozytorium kodu.
• W tym samym projekcie i lokalizacji skonfiguruj nowe połączenie Developer Connect.
• Połącz repozytoria Git w połączeniu.
• Pobierz nazwy zasobów linków, wybierz wzorzec gałęzi do indeksowania dla każdego linku i umieść go w co najmniej 1 grupie repozytoriów.

Aby utworzyć grupę repozytoriów, w środowisku powłoki użyj gemini code-repository-indexes repository-groups createpolecenia:

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

Zastąp następujące elementy:

• REPOSITORY_GROUP: nazwa grupy repozytoriów, np. default.
• REPOSITORY_RESOURCE_NAME: nazwa repozytorium w połączeniu Developer Connect. Aby znaleźć nazwę repozytorium, otwórz stronę Repozytoria Git w konsoli Google Cloud i na karcie Repozytoria w kolumnie Połączenie w tabeli znajdź identyfikator połączenia. Aby skopiować nazwę zasobu, kliknij menu more_vert, aby wyświetlić więcej opcji, i wybierz Kopiuj ścieżkę zasobu.
• BRANCH_NAMES: nazwa gałęzi, które chcesz indeksować, np. main|dev.

Możesz też utworzyć grupę repozytoriów z repozytoriami zdefiniowanymi w pliku JSON (lub YAML) w tym formacie:

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

Aby utworzyć grupę repozytoriów na podstawie pliku JSON lub YAML, w środowisku powłoki użyj polecenia 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

Jeśli wolisz, możesz szyfrować dane i kontrolować je za pomocą klucza szyfrowania zarządzanego przez klienta (CMEK) w usłudze Cloud Key Management Service. Więcej informacji o korzystaniu z klucza CMEK znajdziesz w artykule Szyfrowanie danych za pomocą kluczy szyfrowania zarządzanych przez klienta.

Przyznaj grupie repozytoriów role uprawnień w projekcie.

Otrzymujesz tylko sugestie z repozytoriów w indeksie. Każde repozytorium należy do co najmniej 1 grupy repozytoriów. Aby uzyskać dostęp do sugestii, musisz przypisać do grupy repozytoriów rolę uprawnień Użytkownik grup repozytoriów usługi Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser), która zawiera wymagane uprawnienie cloudaicompanion.repositoryGroups.user IAM, w jeden z tych sposobów:

• Przyznaj podmiotom zabezpieczeń uprawnienia dostępu do całego indeksu.

• Przyznawanie podmiotom zabezpieczeń dostępu do podzbioru indeksu.

  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

Sprawdź, czy masz skonfigurowane Developer Connect i połączone z repozytorium:

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

Utwórz indeks. Dostosowywanie kodu opiera się na indeksie, który umożliwia analizę pozwalającą szybciej generować sugestie i wyszukiwać kod.

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

Zastąp następujące elementy:

• INDEX_NAME: nazwa indeksu. Ważne: zanotuj nazwę indeksu. Będziesz go potrzebować w kilku krokach tego dokumentu.
• PROJECT_ID: identyfikator Twojego projektu Google Cloud;
• REGION: region skonfigurowany w Developer Connect w Twoim projekcie w chmurze. Aby polecenia działały, musisz określić obsługiwany region.

Tworzenie indeksu trwa zwykle 30 minut, ale może potrwać nawet godzinę.

Google ogranicza liczbę indeksów repozytoriów kodu do jednego na projekt i organizację.

Kontroluj dostęp do indeksu za pomocą grup repozytoriów. Grupa repozytoriów to kontener konfiguracji indeksowania, która obejmuje repozytoria i wzorce gałęzi. Grupy repozytoriów są przeznaczone do szczegółowej kontroli dostępu, dzięki czemu deweloperzy mają dostęp do zindeksowanych danych z tych grup, w których mają uprawnienie cloudaicompanion.repositoryGroups.use.

Grupy repozytoriów zawierają repozytoria Developer Connect lub linki z tego samego projektu i lokalizacji.

Administratorzy wykonują te działania:

• Utwórz zasób indeksu repozytorium kodu.
• W tym samym projekcie i lokalizacji skonfiguruj nowe połączenie Developer Connect.
• Połącz repozytoria Git w połączeniu.
• Pobierz nazwy zasobów linków, wybierz wzorzec gałęzi do indeksowania dla każdego linku i umieść go w co najmniej 1 grupie repozytoriów.

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

Zastąp następujące elementy:

• REPOSITORY_GROUP: nazwa grupy repozytoriów, np. default.
• REPOSITORY_RESOURCE_NAME: nazwa repozytorium w połączeniu Developer Connect. Aby znaleźć nazwę repozytorium, w konsoli Google Cloud otwórz stronę Repozytoria Git, a na karcie Repozytoria w kolumnie Połączenie w tabeli znajdź identyfikator połączenia. Aby skopiować nazwę zasobu, kliknij menu more_vert, aby wyświetlić więcej opcji, i wybierz Kopiuj ścieżkę zasobu.
• BRANCH_NAMES: nazwa gałęzi, które chcesz zindeksować, np. main|dev.

Możesz też utworzyć grupę repozytoriów z repozytoriami zdefiniowanymi w pliku JSON (lub YAML) w tym formacie:

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

Aby utworzyć grupę repozytoriów na podstawie pliku JSON lub YAML, w środowisku powłoki użyj polecenia 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

Jeśli wolisz, możesz szyfrować dane i kontrolować je za pomocą klucza szyfrowania zarządzanego przez klienta (CMEK) w usłudze Cloud Key Management Service. Więcej informacji o korzystaniu z klucza CMEK znajdziesz w artykule Szyfrowanie danych za pomocą kluczy szyfrowania zarządzanych przez klienta.

Przyznaj grupie repozytoriów role uprawnień w projekcie.

Otrzymujesz tylko sugestie z repozytoriów w indeksie. Każde repozytorium należy do co najmniej 1 grupy repozytoriów. Aby uzyskać dostęp do sugestii, musisz przypisać do grupy repozytoriów rolę uprawnień Użytkownik grup repozytoriów usługi Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser), która zawiera wymagane uprawnienie cloudaicompanion.repositoryGroups.user IAM, w jeden z tych sposobów:

• Przyznaj podmiotom zabezpieczeń uprawnienia dostępu do całego indeksu.

• Przyznawanie podmiotom zabezpieczeń dostępu do podzbioru indeksu.

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

W konsoli Google Cloud otwórz stronę Usługi Gemini.

Przejdź do usług Gemini

Wczyta się strona Usługi Gemini.

W menu nawigacyjnym kliknij Dostosowywanie kodu.

Otworzy się strona Dostosowywanie kodu.

Aby usunąć indeks, kliknij Usuń.

Wyświetli się komunikat ostrzegawczy. Jeśli chcesz kontynuować i usunąć indeks, wpisz jego nazwę, a potem kliknij Usuń.

Aby wyświetlić listę wszystkich grup repozytoriów dla bieżącego indeksu, w środowisku powłoki użyj gemini code-repository-indexes repository-groups list polecenia:

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

Zastąp następujące elementy:

• REGION: region skonfigurowany w Developer Connect w Twoim projekcie w chmurze. Aby polecenia działały, musisz określić obsługiwany region.
• PROJECT_ID: identyfikator Twojego projektu Google Cloud;
• INDEX_NAME: nazwa indeksu utworzonego w poprzednim kroku.

Aby usunąć grupę repozytoriów z bieżącego indeksu, użyj polecenia 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

Powtarzaj poprzednie kroki dla każdej grupy repozytoriów, aż usuniesz z indeksu wszystkie grupy repozytoriów.

Opcjonalnie: aby usunąć indeks, w środowisku powłoki użyj polecenia gemini code-repository-indexes delete:

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