Konfigurowanie dostosowywania kodu w Gemini Code Assist

W konsoli interfejsów API otwórz stronę Dostosowywanie kodu.

Przejdź do dostosowywania kodu w 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ę. Gdy indeksowanie się zakończy, otrzymasz powiadomienie w konsoli interfejsów API Google.

Google ogranicza liczbę indeksów repozytoriów kodu do jednego na każdy 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 indeksowanych 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 interfejsów API Google.

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.

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

   Google ogranicza liczbę indeksów repozytoriów kodu do jednego na każdy 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 ich 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 czynności:

• 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 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='[{"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 poszukaj identyfikatora 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ędzie Ci potrzebny w kilku krokach tego dokumentu.
• PROJECT_ID: identyfikator Twojego projektu Google Cloud;
• REGION: region skonfigurowany w Developer Connect w Twoim projekcie w chmurze.

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

Google ogranicza liczbę indeksów repozytoriów kodu do jednego na każdy 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 czynności:

• 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 interfejsów API otwórz stronę Usługi Gemini.

Przejdź do usług z Gemini

Wczyta się strona Usługi Gemini.

W menu nawigacyjnym kliknij Dostosowywanie kodu.

Wczytuje się strona Dostosowywanie kodu.

Aby usunąć indeks, kliknij Usuń indeks.

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. Pamiętaj, że polecenia nie będą działać, jeśli określisz nieobsługiwany region. Listę obsługiwanych regionów znajdziesz w sekcji ograniczenia dotyczące dostosowywania kodu.
• 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