Gemini Code Assist 출시 채널 구성

이 문서에서는 Google Cloud 콘솔 또는 API를 사용하여 프로젝트의 Gemini Code Assist 출시 채널을 구성하는 방법을 설명합니다.

Google에서는 다양한 출시 채널을 통해 Gemini Code Assist 기능을 출시합니다. 기능 가용성과 안정성 사이에서 선택한 균형에 따라 각 Google Cloud 프로젝트를 단일 출시 채널로 설정할 수 있습니다. 로컬 IDE에서 Gemini Code Assist를 사용하는 조직의 사용자는 프로젝트에 구성된 출시 채널을 기반으로 기능을 사용하고 모델을 사용할 수 있습니다.

다음 출시 채널을 사용할 수 있습니다.

  • 정식 버전 기본 출시 채널입니다. 일반적으로 사용 가능한 모델과 기능을 사용할 수 있습니다. 미리보기 채널을 선택하지 않고도 미리보기 등록의 대체 메커니즘을 사용하여 특정 미리보기 기능에 액세스할 수 있습니다. 이러한 기능은 GA 채널 내에서 액세스할 수 있지만 여전히 GA 이전 제공 서비스 약관이 적용됩니다.

  • 미리보기 Gemini Code Assist의 특정 미리보기 기능에 액세스할 수 있으며, 원하는 경우 Google에서 향후 출시 버전을 개선하는 데 도움이 되도록 의견과 사용 데이터를 제공할 수 있습니다. 현재 미리보기 출시 채널에는 별도의 기능이 없습니다.

    프로젝트에서 프리뷰 출시 채널을 사용 설정하면 해당 프로젝트에서 Gemini Code Assist를 모두 사용하는 경우 Google Cloud 플랫폼별 서비스 약관의 GA 이전 서비스 약관이 적용된다는 점을 고객을 대신하여 동의하는 것입니다. GA 이전 서비스와 함께 사용하기에 적합하지 않은 프로젝트 및 리소스에는 이 채널을 사용하지 마세요.

다음 섹션에서는 Gemini Code Assist 출시 채널을 설정하거나 변경하는 데 필요한 단계를 설명합니다.

시작하기 전에

필요한 역할

출시 채널을 제어하는 설정과 바인딩을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Gemini for Google Cloud 설정 관리자 (roles/cloudaicompanion.settingsAdmin) 역할을 부여해 달라고 요청하세요.

필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • API를 사용하여 출시 채널을 구성하려면 다음 단계를 따르세요.
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • API를 사용하여 프롬프트 및 대답 공유를 구성합니다.
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Gemini for Google Cloud 관리자 설정 보기:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Gemini Code Assist 출시 채널 구성

다음 옵션 중 하나를 선택합니다.

콘솔

  1. Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

    Gemini for Google Cloud로 이동

    Gemini for Google Cloud 페이지가 로드됩니다.

  2. 탐색 메뉴에서 설정을 클릭합니다.

    설정 페이지가 로드됩니다.

  3. 로컬 IDE의 Gemini Code Assist 출시 채널 섹션에서 필요에 가장 적합한 출시 채널을 선택합니다.

    미리보기

    1. 미리보기를 선택합니다.
    2. 미리보기 출시 채널 세부정보와 신뢰할 수 있는 테스터 프로그램 약관을 검토한 후 변경사항 저장을 클릭합니다.

    정식 버전

    1. GA를 선택합니다.
    2. 변경사항 저장을 클릭합니다.

API

  1. 출시 채널 설정 및 설정별 값을 만듭니다.

    1. 인증 토큰을 획득합니다. 이 토큰을 가져오려면 gcloud CLI 인증을 사용하여 인증해야 합니다.

      TOKEN=$(gcloud auth print-access-token)

    2. 설정을 만듭니다. 이 안내에서는 cURL을 사용하여 API 메서드를 호출합니다.

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
      "release_channel": "RELEASE_CHANNEL",
    } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"

      다음을 바꿉니다.

      • RELEASE_CHANNEL: 출시 채널입니다. 미리보기의 경우 EXPERIMENTAL, 정식 버전의 경우 STABLE입니다.
      • CONTAINER_PROJECT_NAME: 바인딩 리소스가 저장된 프로젝트의 프로젝트 ID입니다. 이는 바인딩의 상위 프로젝트입니다.
      • RC_SETTING_ID: 고유한 설정 이름(예: Release Channel의 경우 rc1)

      출력에 releaseChannel이 RELEASE_CHANNEL로 설정되어 표시됩니다.

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/releaseChannelSettings/RC_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "releaseChannel": RELEASE_CHANNEL
}

    3. 출시 채널 설정 바인딩을 만듭니다.

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"

      다음을 바꿉니다.

      • TARGET_PROJECT_NAME: 바인딩을 바인딩할 대상 프로젝트입니다. 이는 컨테이너 프로젝트와 동일한 경우가 많습니다. 하지만 설정 리소스가 중복되지 않도록 설정을 여러 프로젝트에 바인딩할 수 있습니다.
      • CONTAINER_PROJECT_NAME: 바인딩 리소스가 저장된 프로젝트의 프로젝트 ID입니다. 이는 바인딩의 상위 프로젝트입니다.
      • RC_SETTING_ID: 설정을 만들 때 사용한 것과 동일한 RC_SETTING_ID이지만 b1이 추가됩니다. 예를 들어 Release Channel의 경우 rc1b1을 사용합니다.
      • RC_BINDING_ID: 설정 바인딩의 고유한 이름입니다(예: rc_binding).

      출력에는 다음 형식의 작업 메타데이터가 포함됩니다.

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

    4. 선택사항: 출시 채널 설정 바인딩 생성 상태를 확인합니다.

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 바인딩 리소스가 저장된 프로젝트의 프로젝트 ID입니다. 이는 바인딩의 상위 프로젝트입니다.
      • RC_BINDING_OPERATION_ID: 이전 단계의 응답에 제공된 출시 채널 설정 바인딩 생성 작업 ID입니다.

  2. 선택사항: 프롬프트 및 응답 공유 설정과 설정별 값을 만듭니다.

    1. 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)

    2. 설정을 만듭니다.

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_preview_data_sharing": true,
  } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 상위 프로젝트 ID
      • DSWG_SETTING_ID: 고유한 설정 이름(예: Data Sharing with Google의 경우 dswg1)

      출력에 enablePreviewDataSharing이 true로 설정되어 표시됩니다.

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

    3. 프롬프트 및 응답 설정 바인딩을 만듭니다.

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"

      다음을 바꿉니다.

      • TARGET_PROJECT_NAME: 설정을 적용할 대상 프로젝트입니다.
      • CONTAINER_PROJECT_NAME: 상위 프로젝트 ID입니다.
      • DSWG_SETTING_ID: 설정을 만들 때 사용한 것과 동일한 DSWG_SETTING_ID이지만 b1이 추가됩니다. 예를 들어 Data Sharing with Google의 경우 dswg1b1을 사용합니다.
      • DSWG_BINDING_ID: 설정 바인딩의 고유한 이름입니다(예: dswg_binding).

      출력에는 다음 형식의 작업 메타데이터가 포함됩니다.

      {
"name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
  "createTime": "2025-01-23T15:27:50.076075570Z",
  "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
  "verb": "create",
  "requestedCancellation": false,
  "apiVersion": "v1"
},
"done": false
}

    4. (선택사항) 프롬프트 및 응답 설정 바인딩 생성 상태를 확인합니다.

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 바인딩 리소스가 저장된 프로젝트의 프로젝트 ID입니다. 이는 바인딩의 상위 프로젝트입니다.
      • DSWG_BINDING_OPERATION_ID: 이전 단계의 응답에 제공된 프롬프트 및 응답 설정 바인딩 생성 작업 ID입니다.

다음 단계