Настройка настройки кода Gemini Code Assist

В консоли Google Cloud перейдите на страницу настройки кода .

Перейти к настройке кода для Gemini Code Assist

Загрузится страница настройки кода для Gemini Code Assist .

Создайте индекс. Настройка кода основана на индексе для анализа и разбора вашего репозитория, что позволяет быстрее генерировать предложения и искать код.

1. Нажмите «Создать» и настройте данные индекса:

   • Выберите регион, настроенный в Developer Connect в вашем облачном проекте.
   • Введите имя для вашего индекса. Запишите его. Оно понадобится вам для выполнения нескольких шагов в этом документе.

2. Нажмите «Создать» .

Создание индекса обычно занимает 30 минут, но может занять до часа. После завершения индексации вы получите уведомление в консоли Google Cloud.

Google ограничивает количество индексов репозитория кода одним для каждого проекта и организации.

Управляйте доступом к вашему индексу с помощью групп репозитория.

Группа репозиториев — это контейнер для конфигурации индексации, которая включает репозитории и их шаблоны ветвления. Группы репозиториев предназначены для детального управления IAM, предоставляя разработчикам доступ к индексированным данным из этих групп, где у них есть разрешение cloudaicompanion.repositoryGroups.use .

Группы репозиториев содержат репозитории Developer Connect или ссылки из одного проекта и местоположения.

На странице «Настройка кода для Gemini Code Assist» нажмите «Добавить репозитории» , а затем выберите «Добавить исходные репозитории» .

Отобразится список существующих репозиториев в Developer Connect для региона, который вы настроили на предыдущем шаге для создания индекса.

Если вам необходимо добавить новые репозитории в группу репозиториев, нажмите «Подключить репозиторий» и следуйте инструкциям в консоли Google Cloud.

Кроме того, вы можете выбрать и отредактировать один или несколько репозиториев, чтобы добавить новую ветку.

Выберите группу репозиториев, в которую вы хотите добавить новые репозитории. Также можно нажать «Создать новую группу репозиториев» , чтобы создать и настроить новую группу репозиториев.

Чтобы начать индексацию выбранных репозиториев, нажмите кнопку Индексировать .

Время индексации варьируется в зависимости от размера репозиториев.

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

В среде оболочки выполните команду gcloud components update , чтобы убедиться, что все установленные компоненты gcloud обновлены до последней версии. Для этого вы можете установить и инициализировать gcloud или использовать Cloud Shell Editor .

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.
   • REGION : регион, настроенный в Developer Connect в вашем облачном проекте. Для успешного выполнения команд необходимо указать поддерживаемый регион .

   Создание индекса обычно занимает 30 минут, но может занять и час.

   Google ограничивает количество индексов репозитория кода одним для каждого проекта и организации.

Управляйте доступом к индексу с помощью групп репозиториев. Группа репозиториев — это контейнер для конфигурации индексирования, которая включает репозитории и их шаблоны ветвления. Группы репозиториев предназначены для детального управления IAM, предоставляя разработчикам доступ к индексированным данным из этих групп, где у них есть разрешение cloudaicompanion.repositoryGroups.use .

Группы репозиториев содержат репозитории Developer Connect или ссылки из одного проекта и местоположения.

Администраторы выполняют следующие действия:

• Создайте ресурс индекса репозитория кода.
• В том же проекте и месте настройте новое подключение Developer Connect.
• Связать репозитории Git с подключением.
• Получите имена ресурсов ссылок, выберите шаблон ветвления для индексации каждой ссылки и поместите ее в одну или несколько групп репозиториев.

Чтобы создать группу репозиториев, в среде оболочки используйте команду 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. Чтобы узнать имя репозитория, перейдите на страницу репозиториев Git в консоли Google Cloud и на вкладке «Репозитории » найдите идентификатор подключения в столбце «Подключение » таблицы. Чтобы скопировать имя ресурса, откройте меню 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

При желании вы можете шифровать и контролировать свои данные с помощью ключа шифрования, управляемого клиентом (CMEK), через службу управления облачными ключами . Подробнее об использовании CMEK см. в статье Шифрование данных с помощью ключей шифрования, управляемых клиентом .

Предоставьте роли IAM группе репозитория в проекте.

Вы получаете предложения только из репозиториев, указанных в индексе. Каждый репозиторий принадлежит одной или нескольким группам репозиториев. Для доступа к предложениям необходимо предоставить группе репозиториев IAM-роль пользователя групп репозиториев Cloud AI Companion ( roles/cloudaicompanion.repositoryGroupsUser ), которая содержит необходимое разрешение IAM cloudaicompanion.repositoryGroups.user , одним из следующих способов:

• Предоставить принципалам разрешение на доступ ко всему индексу.

• Предоставить принципалам доступ к подмножеству индекса.

  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.
• REGION : регион, настроенный в Developer Connect в вашем облачном проекте. Для успешного выполнения команд необходимо указать поддерживаемый регион .

Создание индекса обычно занимает 30 минут, но может занять и час.

Google ограничивает количество индексов репозитория кода одним для каждого проекта и организации.

Управляйте доступом к индексу с помощью групп репозиториев. Группа репозиториев — это контейнер для конфигурации индексирования, которая включает репозитории и их шаблоны ветвления. Группы репозиториев предназначены для детального управления IAM, предоставляя разработчикам доступ к индексированным данным из этих групп, где у них есть разрешение cloudaicompanion.repositoryGroups.use .

Группы репозиториев содержат репозитории Developer Connect или ссылки из одного проекта и местоположения.

Администраторы выполняют следующие действия:

• Создайте код ресурса индекса репозитория.
• В том же проекте и месте настройте новое подключение Developer Connect.
• Связать репозитории Git с подключением.
• Получите имена ресурсов ссылок, выберите шаблон ветвления для индексации каждой ссылки и поместите ее в одну или несколько групп репозиториев.

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. Чтобы узнать имя репозитория, перейдите на страницу репозиториев Git в консоли Google Cloud и на вкладке «Репозитории » найдите идентификатор подключения в столбце «Подключение » таблицы. Чтобы скопировать имя ресурса, откройте меню 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

При желании вы можете шифровать и контролировать свои данные с помощью ключа шифрования, управляемого клиентом (CMEK), через службу управления облачными ключами . Подробнее об использовании CMEK см. в статье Шифрование данных с помощью ключей шифрования, управляемых клиентом .

Предоставьте роли IAM группе репозитория в проекте.

Вы получаете предложения только из репозиториев, указанных в индексе. Каждый репозиторий принадлежит одной или нескольким группам репозиториев. Для доступа к предложениям необходимо предоставить группе репозиториев IAM-роль пользователя групп репозиториев Cloud AI Companion ( roles/cloudaicompanion.repositoryGroupsUser ), которая содержит необходимое разрешение IAM cloudaicompanion.repositoryGroups.user , одним из следующих способов:

• Предоставить принципалам разрешение на доступ ко всему индексу.

• Предоставить принципалам доступ к подмножеству индекса.

  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 : регион, настроенный в Developer Connect в вашем облачном проекте. Для успешного выполнения команд необходимо указать поддерживаемый регион .
• PROJECT_ID : идентификатор вашего проекта Google Cloud.
• 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