Gemini Code Assist Standard 및 Enterprise 설정

Gemini Code Assist Standard 또는 Enterprise를 사용하려면 먼저 팀에서 이 문서에 설명된 설정 단계를 수행해야 합니다.

참고: 일반적으로 관리자가 1~4단계를 수행합니다.

1. Gemini Code Assist Standard 또는 Enterprise 구독을 구매합니다.

2. 조직의 개별 사용자에게 라이선스를 할당합니다.

3. Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정합니다.

4. Google Cloud 프로젝트에서 Identity and Access Management 역할을 부여합니다.

5. 조직의 사용자가 Gemini Code Assist 플러그인을 설치하여 IDE에서 Gemini Code Assist Standard 또는 Enterprise를 사용합니다.

Gemini Code Assist 구독 구매

각 버전에서 사용할 수 있는 기능 목록은 지원되는 기능을 참조하세요.

Gemini Code Assist를 구독한 적이 없는 결제 계정이 있는 신규 Gemini Code Assist 고객에게는 Gemini Code Assist 버전과 관계없이 첫 달에 무료 라이선스 최대 50개에 상응하는 크레딧이 자동으로 적용됩니다. 초기 무료 라이선스 크레딧이 할당된 후에는 무료 크레딧 수를 늘릴 수 없습니다. 또한 첫 달에는 Gemini Code Assist 버전을 변경할 수 없습니다.

Google Cloud와 기존 계약이 있는 경우 구독을 구매하기 전에 Google 영업팀에 문의하세요.

1. Gemini 관리자 페이지로 이동합니다.

   Gemini 관리자로 이동

   Gemini 관리자 페이지가 열립니다.

2. Gemini Code Assist 구매를 선택합니다.

   필요한 consumerprocurement.orders.place 권한이 없으면 이 버튼이 사용 중지됩니다. 프로젝트와 연결된 결제 계정에 이미 Gemini Code Assist 구독이 있으면 이 버튼은 Gemini Code Assist 관리로 표시되며 이 버튼을 사용하여 구독을 수정할 수 있습니다.

   Gemini Code Assist 구독 구매하기 페이지가 열립니다.

3. Gemini Code Assist 구독 버전 선택에서 Gemini Code Assist 버전을 선택합니다. Gemini Code Assist 버전 비교를 선택하여 각 버전에서 사용할 수 있는 기능의 세부 목록을 확인합니다.

   그런 다음 계속을 선택합니다.

4. 구독 구성에서 다음을 포함하여 필드를 작성해 구독을 구성합니다.

   • 구독 이름
   • 구독의 라이선스 수 Enterprise 버전을 구매하는 경우 라이선스를 최소 10개 이상 구매해야 합니다.
   • 구독 기간(월간 또는 연간). 연간 구독의 경우 할인율이 적용되며 수시 입금이 아닌 월별로 청구됩니다.

5. 구독을 확인하려면 계속을 선택합니다.

6. 약관에 동의하면 구매 약관에 동의합니다를 선택한 후 구독 확인을 선택합니다.

7. 다음: Gemini 라이선스 할당 관리를 선택합니다.

이제 Gemini Code Assist Standard 또는 Enterprise 구독이 구매되었습니다. 이제 조직에서 Gemini 라이선스 할당을 관리해야 합니다.

라이선스 할당

Gemini Code Assist를 사용하기 전에 조직에서 액세스 권한을 부여해야 하는 각 사용자에게 라이선스를 할당해야 합니다.

Gemini Code Assist를 구독한 적이 없는 결제 계정이 있는 신규 Gemini Code Assist 고객에게는 Gemini Code Assist 버전과 관계없이 첫 달에 무료 라이선스 최대 50개에 상응하는 크레딧이 자동으로 적용됩니다. 초기 무료 라이선스 크레딧이 할당된 후에는 무료 크레딧 수를 늘릴 수 없습니다. 또한 첫 달에는 Gemini Code Assist 버전을 변경할 수 없습니다.

콘솔

API Console에서 개별 사용자에게 Gemini 라이선스를 할당하려면 결제 계정에 대한 다음 권한이 있어야 합니다.

• billing.accounts.get
• billing.accounts.list
• consumerprocurement.orders.get
• consumerprocurement.orders.list
• consumerprocurement.orders.modify
• consumerprocurement.orders.place
• consumerprocurement.licensePools.enumerateLicensedUsers
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.update
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.unassign

1. Gemini 관리자 페이지로 이동합니다.

   Google Cloud를 위한 Gemini로 이동

2. 변경하려는 구독을 선택한 후 구독 수정을 클릭합니다.

3. '라이선스 할당'을 클릭합니다. 사용자 선택 대화상자가 표시됩니다. 특정 사용자를 검색하려면 검색창에 사용자 이름을 입력합니다.

4. 목록에서 사용자를 한 명 이상 선택한 후 다음을 클릭합니다.

5. 라이선스를 할당할 Gemini 서비스를 선택합니다.

6. '라이선스 할당'을 클릭합니다.

API

API로 Gemini 라이선스를 할당하려면 billingAccounts.orders.licensePool.assign 메서드를 사용합니다.

1. 할당하려는 라이선스 풀이 포함된 결제 계정에 대한 consumerprocurement.licensePools.assign Identity and Access Management 권한이 있어야 합니다.

2. 다음 정보를 포함하는 JSON 파일을 만듭니다.

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   여기서 USER_EMAILS는 라이선스가 할당되는 사용자 계정의 쉼표로 구분된 목록입니다. 예를 들면 "[e-mail]", "[e-mail]"입니다.

3. cURL를 사용하여 메서드를 호출합니다.

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "X-Goog-User-Project: PROJECT_ID" \
     -H "Content-Type: application/json" \
     "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   다음을 바꿉니다.

   • JSON_FILE_NAME: 2단계에서 만든 JSON 파일의 경로입니다.
   • PROJECT_ID: 프로젝트 ID입니다. API 요청과 연결된 할당량 사용량 및 요금이 이 프로젝트에 적용됩니다.
   • BILLING_ACCOUNT_ID: 라이선스 풀과 연결된 결제 계정의 ID입니다.
   • ORDER_ID: 주문 ID. 주문 ID를 모르는 경우 결제 계정과 연결된 주문을 나열하여 검색할 수 있습니다.

성공한 경우 응답은 다음과 유사합니다.

  {}

이제 이 결제 계정과 연결된 프로젝트 하나 이상에서 Google Cloud를 위한 Gemini API를 사용 설정해야 합니다. 프로젝트 최소 하나 이상에서 Gemini Code Assist를 활성화하기 전까지는 사용자에게 Gemini Code Assist가 표시되지 않습니다.

Cloud 프로젝트에서 Google Cloud를 위한 Gemini API 사용 설정

이 섹션에서는 Cloud 프로젝트에서 Gemini for Google Cloud API를 사용 설정하는 데 필요한 단계를 설명합니다.

콘솔

1. Google Cloud를 위한 Gemini API를 사용 설정하려면 Google Cloud를 위한 Gemini 페이지로 이동합니다.

   Google Cloud를 위한 Gemini로 이동

2. 프로젝트 선택기에서 프로젝트를 선택합니다.

3. 사용 설정을 클릭합니다.

   페이지가 업데이트되고 사용 설정됨 상태가 표시됩니다. 이제 선택한 Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Gemini를 사용할 수 있습니다.

gcloud

로컬 개발 환경을 사용하려면 gcloud CLI를 설치하고 초기화합니다.

1. 프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.

2. gcloud services enable 명령어를 사용하여 Gemini에 Gemini for Google Cloud API를 사용 설정합니다.

   gcloud services enable cloudaicompanion.googleapis.com
   

   다른 Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정하려면 --project 매개변수를 추가합니다.

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   PROJECT_ID를 Cloud 프로젝트 ID로 바꿉니다.

   출력은 다음과 비슷합니다.

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

이제 지정된 Cloud 프로젝트에서 필요한 IAM 역할이 있는 모든 사용자가 Gemini for Google Cloud를 사용할 수 있습니다.

IDE와 Google 간의 API 트래픽을 위한 방화벽 구성

방화벽 뒤에 있는 사용자는 Gemini for Google Cloud API 사용 설정 외에도 다음 API의 트래픽이 통과하도록 허용해야 합니다.

• oauth2.googleapis.com: Google Cloud에 로그인하는 데 사용됩니다.
• serviceusage.googleapis.com: 사용자의 Gemini Code Assist 프로젝트가 올바르게 구성되었는지 확인하는 데 사용됩니다.
• cloudaicompanion.googleapis.com: 기본 Google Cloud API용 Gemini 엔드포인트입니다.
• cloudcode-pa.googleapis.com: IDE 관련 기능을 제공하는 내부 API입니다.
• cloudresourcemanager.googleapis.com: 프로젝트 선택 도구의 IDE에서 사용됩니다. 프로젝트가 settings.json 파일에서 명시적으로 구성된 경우에는 Resource Manager API가 필요하지 않을 수 있습니다.
• people.googleapis.com: 프로필과 연락처에 대한 정보에 대한 액세스 권한을 제공합니다.
• firebaselogging-pa.googleapis.com: 추천 수락 여부에 대한 이벤트를 포함한 제품 원격 분석을 전송하는 데 사용되는 내부 API입니다.
• feedback-pa.googleapis.com: IDE 내 의견 제출에 사용되는 내부 API입니다.
• apihub.googleapis.com: Cloud Code API 브라우저 기능에서 사용합니다.
• lh3.googleusercontent.com 및 lh5.googleusercontent.com: 사용자 사진을 가져오는 데 사용됩니다.

Google Cloud 기본 도메인의 IP 주소 확인

IDE에서 Google Cloud API에 연결하려면 방화벽에서 Google의 공개 문서화된 IP 주소 범위에 대한 아웃바운드 TCP 트래픽을 허용해야 합니다. 이러한 범위는 Google에서 동적으로 관리합니다.

Google Cloud 도메인에 액세스할 IP 범위 목록을 유지하려면 다음과 같은 몇 가지 옵션이 있습니다.

• 게시된 목록을 사용하거나 스크립트를 자동화하여 Google IP 주소 범위를 가져옵니다.
• private.googleapis.com 가상 IP를 사용합니다.
• Private Service Connect를 사용합니다.

선택사항: VPC 서비스 제어 구성

조직에 서비스 경계가 있으면 다음 리소스를 경계에 추가해야 합니다.

• Gemini for Google Cloud API
• Gemini Code Assist API

서비스 경계 외부에서 Gemini Code Assist Standard 또는 Enterprise를 사용하는 경우 이러한 서비스에 대한 액세스를 허용하도록 인그레스 정책도 수정해야 합니다.

자세한 내용은 Gemini의 VPC 서비스 제어 구성을 참조하세요.

Google Cloud 프로젝트에서 IAM 역할 부여

이 섹션에서는 Google Cloud를 위한 Gemini 사용자 및 서비스 사용량 소비자 IAM 역할을 사용자에게 부여하는 데 필요한 단계를 설명합니다.

콘솔

1. Gemini 사용에 필요한 IAM 역할을 부여하려면 IAM 및 관리자 페이지로 이동합니다.

   IAM 및 관리자로 이동

2. 주 구성원 열에서 Gemini에 대한 액세스 권한을 부여하려는 주 구성원을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.

3. 액세스 수정 창에서 다른 역할 추가를 클릭합니다.

4. 역할 선택에서 Google Cloud를 위한 Gemini 사용자를 선택합니다.

5. 다른 역할 추가를 클릭하고 서비스 사용량 소비자를 선택합니다.

6. 저장을 클릭합니다.

gcloud

로컬 개발 환경을 사용하려면 gcloud CLI를 설치하고 초기화합니다.

1. 프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.

2. Google Cloud를 위한 Gemini 사용자 역할을 부여합니다.

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

   다음을 바꿉니다.

   • PROJECT_ID: 클라우드 프로젝트의 ID입니다(예: 1234567890).
   • PRINCIPAL: 사용자의 식별자입니다(예: user:[e-mail]).

   다음을 포함하는 정책 바인딩 목록이 출력됩니다.

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

3. roles/serviceusage.serviceUsageConsumer 역할에 대해 이전 단계를 반복합니다.

자세한 내용은 단일 역할 부여 및 gcloud projects add-iam-policy-binding을 참조하세요.

이러한 역할이 부여된 모든 사용자가 지정된 프로젝트 내에서 API 콘솔의 Google Cloud용 Gemini 기능에 액세스할 수 있습니다. 자세한 내용은 Google Cloud용 Gemini 개요를 참조하세요.

Gemini Code Assist 플러그인 설치

조직의 사용자가 선호하는 지원되는 IDE에 Gemini Code Assist 플러그인을 설치합니다.

VS Code

1. VS Code에서 확장 프로그램 뷰를 열려면 확장 프로그램을 클릭하거나 Ctrl/Cmd+Shift+X를 누릅니다.

2. Gemini Code Assist을 검색합니다.

3. 설치를 클릭합니다.

4. 메시지가 표시되면 VS Code를 다시 시작합니다.

   확장 프로그램이 설치되면 Gemini Code Assist가 작업 표시줄에 표시되고 사용 가능합니다. 최상위 애플리케이션 작업 표시줄에서 코드 > 설정 > 설정 > 확장 프로그램으로 이동하여 Gemini Code Assist를 검색하여 환경설정을 지정해 Gemini Code Assist 설치를 추가로 구성할 수 있습니다.

IntelliJ

1. settings IDE 및 프로젝트 설정 > 플러그인을 클릭합니다.
2. Marketplace 탭에서 Gemini Code Assist를 검색합니다.
3. 설치를 클릭하여 플러그인을 설치합니다.
4. 설치가 완료되면 IDE 다시 시작을 클릭합니다.

5. IDE가 다시 시작되면 작업 표시줄에 Gemini Code Assist가 표시됩니다.

   

이제 사용자는 IDE에서 Gemini Code Assist Standard 또는 Enterprise를 사용할 수 있습니다. 지원되는 기능에 대해 자세히 알아보세요.

• 코드 기능 개요
• Chat 기능 개요

다음 가이드를 통해 시작해 보세요.

• Gemini Code Assist로 코딩하기
• Gemini Code Assist와 채팅하기

Gemini Code Assist에서 정보를 캐시하는 디렉터리 목록

다음 표에는 Gemini Code Assist에서 인증 토큰과 같은 확장 프로그램 정보를 저장하는 디렉터리의 목록이 나와 있습니다.

Windows

• %LOCALAPPDATA%/cloud-code
• %LOCALAPPDATA%/google-vscode-extension

macOS

• ~/Library/Application Support/cloud-code
• ~/Library/Application Support/google-vscode-extension

Linux

• ~/.cache/cloud-code
• ~/.cache/google-vscode-extension

Google에 로그인하고 Google Cloud 프로젝트 선택

사용자가 IDE에 Gemini Code Assist를 설치한 후에는 Google 계정에 로그인해야 합니다. IDE에서 Gemini Code Assist Standard 또는 Enterprise를 처음 사용하는 경우 Google Cloud 프로젝트를 선택합니다.

VS Code

Gemini for Google Cloud API가 사용 설정되지 않은 Google Cloud 프로젝트를 선택하면 IDE에서 API를 사용 설정하는 옵션을 제공하는 알림이 전송됩니다. 알림 창에서 API 사용 설정을 선택하여 프로젝트에 API를 사용 설정합니다. 자세한 내용은 프로젝트에 Gemini Code Assist Standard 및 Enterprise 설정을 참고하세요.

IDE에서 Gemini Code Assist를 사용한 코드 둘러보기를 직접 수행하려면 VS Code 실행을 클릭하고 둘러보기 단계를 수행하여 Google Cloud에 연결하고 Gemini Code Assist Standard 또는 Enterprise를 활성화합니다.

VS Code 실행

아니라면 다음 단계를 따르세요.

1. IDE를 시작합니다.

2. 작업 표시줄에서 Gemini Code Assist를 클릭합니다.

3. Gemini Code Assist 채팅 창에서 Google Cloud에 로그인을 클릭합니다.

4. Gemini Code Assist에서 외부 웹사이트를 열도록 허용하라는 메시지가 표시되면 열기를 클릭합니다.

5. 표시되는 메시지에 따라 Google 계정에 로그인합니다.

6. Google에서 Gemini Code Assist를 다운로드했는지 묻는 메시지가 표시되면 로그인을 클릭합니다.

   참고: 로그인 시도가 계속 타임아웃되는 경우 문제 해결에 대한 자세한 내용은 로그인 시도가 계속 타임아웃됨이라는 알려진 문제를 참조하세요.

   이제 Google Cloud에 연결되었습니다.

   다음으로 Google Cloud용 Gemini API가 사용 설정된 Google Cloud 프로젝트를 선택하려면 다음 단계를 따르세요.

7. Gemini Code Assist 상태 표시줄에서 Gemini Code Assist를 클릭합니다.

   

8. Gemini Code Assist 메뉴에서 Gemini Code 프로젝트 선택을 선택합니다.

9. Google Cloud용 Gemini API가 사용 설정된 Google Cloud 프로젝트를 선택합니다.

   Gemini Code Assist Standard 또는 Enterprise를 사용할 수 있습니다.

   

IntelliJ

Google 계정에 로그인하려면 다음 단계를 수행합니다.

1. 작업 표시줄에서 spark Gemini Code Assist를 클릭합니다.

2. Google에 로그인을 클릭합니다.

3. 웹브라우저에 열리는 페이지에서 Google 계정을 선택합니다.

4. Google에서 이 앱을 다운로드했는지 묻는 화면에서 로그인을 클릭합니다.

   Gemini Code Assist가 이제 사용자 계정에 액세스할 수 있도록 승인되었습니다.

   다음으로, IDE에서 Gemini Code Assist Standard 또는 Enterprise를 처음 사용하는 경우 다음 단계를 수행하여 Google Cloud 프로젝트를 선택해야 합니다.

5. IDE로 돌아갑니다. Google이 사용자가 선택한 프로젝트에 Gemini Code Assist를 사용하는 데 필요한 API를 대신 사용 설정하도록 허용하는 데 동의하면 Gemini Code Assist 도구 창에서 GCP 프로젝트 선택을 클릭하여 계속 진행합니다.

6. Google Cloud 프로젝트 선택 대화상자에서 Google Cloud 프로젝트를 검색하여 선택한 후 확인을 클릭합니다.

7. 마침을 클릭합니다.

Gemini Code Assist API가 사용 설정된 Google Cloud 프로젝트가 선택됩니다. 이제 IDE에서 Gemini Code Assist Standard 또는 Enterprise를 사용할 수 있습니다.

고급 설정 태스크

API Console이나 gcloud를 사용하여 사전 정의된 IAM 역할을 부여하는 대신 다음 중 하나를 수행할 수 있습니다.

• IAM REST API 또는 IAM 클라이언트 라이브러리를 사용하여 역할을 부여합니다.

  이러한 인터페이스를 사용하는 경우 정규화된 역할 이름을 사용합니다.

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

  역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

• 커스텀 역할을 만들고 부여합니다.

  생성된 모든 커스텀 역할에서 Gemini Code Assist Standard 및 Enterprise에 액세스하려면 다음 권한이 필요합니다.

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • serviceusage.services.enable

• 라이선스를 할당하고 관리합니다.

  생성된 모든 커스텀 역할에서 Gemini Code Assist 라이선스를 할당하고 관리하려면 다음 권한이 필요합니다.

  • consumerprocurement.orders.get
  • consumerprocurement.orders.licensePools..*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

또한 앞선 권한이 작동하려면 각 권한을 할당한 동일한 Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정해야 합니다.

다음 단계

• Google Cloud를 위한 Gemini에서 사용할 수 있는 생성형 AI 지원 유형에 대해 자세히 알아보세요.
• Google Cloud를 위한 Gemini에서 사용자 데이터를 사용하는 방법을 알아보세요.
• Gemini Code Assist Standard 및 Enterprise 관리자 제어에 액세스하고 관리하는 방법 알아보기
• Gemini Code Assist Enterprise의 코드 맞춤설정을 구성하는 방법 알아보기
• Gemini Code Assist Standard 및 Enterprise의 VPC 서비스 제어 구성