Gemini Code Assist 설정하기

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

Gemini Code Assist 구독을 구매합니다.
조직의 개별 사용자에게 라이선스를 할당합니다.
Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정합니다.
Google Cloud 프로젝트에서 Identity and Access Management(IAM) 역할을 부여합니다.
조직의 사용자가 Cloud Code 플러그인을 설치하여 IDE에서 Gemini Code Assist를 사용합니다.

Gemini Code Assist 구독 구매

Gemini Code Assist 구독을 구매하는 데 필요한 단계는 구매하는 버전(Enterprise 또는 Standard)에 따라 다릅니다. 각 버전에서 사용할 수 있는 기능 목록은 지원되는 기능을 참조하세요.

Enterprise 버전

Gemini Code Assist Enterprise는 2025년 3월 31일까지 12개월 약정으로 사용자당 월 19달러에 사용 가능합니다. 이 프로모션 코드를 활용하려면 Google 영업팀에 문의하세요.

표준 버전

2024년 11월 8일까지 Gemini Code Assist Standard 버전을 구독 없이 무료로 사용해 볼 수 있으며 결제 계정당 사용자 1명으로 제한됩니다. 결제 계정당 사용자가 여러 명 있는 조직은 이 섹션의 설명대로 구독을 구매해야 합니다.

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

참고: Gemini 구독을 구매하려면 consumerprocurement.orders.place Identity and Access Management(IAM) 권한이 있어야 합니다. consumerprocurement.orders.place 권한은 roles/billing.admin IAM 역할 또는 roles/consumerprocurement.orderAdmin 역할에 포함되어 있습니다. 또는 권한을 커스텀 역할에 추가할 수도 있습니다.

Google Cloud를 위한 Gemini 페이지로 이동합니다.

Google Cloud를 위한 Gemini로 이동

Google Cloud를 위한 Gemini 페이지가 열립니다.
Gemini Code Assist 구매하기를 클릭합니다. 프로젝트에 이미 Gemini Code Assist가 있으면 이 텍스트에 Gemini Code Assist 관리가 표시됩니다.

Gemini Code Assist 구독 구매하기 페이지가 열립니다.
구독 구성에서 다음을 포함하여 필드를 작성해 구독을 구성합니다.
- 구독 이름
- 구독의 라이선스 수
- 구독 기간(월간 또는 연간). 연간 구독의 경우 할인율이 적용되며 수시 입금이 아닌 월별로 청구됩니다.
- 약정 기간(월간 또는 연간)이 종료된 후 구독 자동 갱신. 자동 갱신을 사용하면 구독 및 라이선스가 활성 상태로 유지됩니다. 구독이 자동 갱신되지 않으면 현재 기간 종료 시 구독이 종료되며 구매 프로세스를 다시 진행하고 라이선스를 재할당해야 합니다.
구독 세부정보를 검토하려면 계속을 클릭합니다.
약관에 동의하면 구매 약관에 동의합니다를 선택한 후 구독 확인을 클릭합니다.
다음: Gemini 라이선스 할당 관리를 클릭합니다.

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

라이선스 할당

Gemini Code Assist를 사용하려면 조직의 각 사용자에게 라이선스가 필요합니다.

콘솔

Google Cloud 콘솔에서 개별 사용자에게 Gemini 라이선스를 할당하려면 다음 권한이 있어야 합니다.

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign

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

Gemini 관리자로 이동
변경하려는 구독을 선택한 후 구독 수정을 클릭합니다.
'라이선스 할당'을 클릭합니다. 사용자 선택 대화상자가 표시됩니다. 특정 사용자를 검색하려면 검색창에 사용자 이름을 입력합니다.
목록에서 사용자를 한 명 이상 선택한 후 다음을 클릭합니다.
라이선스를 할당할 Gemini 서비스를 선택합니다.
'라이선스 할당'을 클릭합니다.

API

API로 Gemini 라이선스를 할당하려면 consumerprocurement.licensePools.assign 권한이 있어야 합니다.

HTTP 메서드: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

다음을 바꿉니다.

BILLING_ACCOUNT_ID: 결제 계정 ID
ORDER_ID: IAM 정책

요청 본문:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

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

{}

라이선스가 할당되면 응답은 비어 있습니다.

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

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

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

콘솔

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

Google Cloud를 위한 Gemini로 이동
프로젝트 선택기에서 프로젝트를 선택합니다.
사용 설정을 클릭합니다.

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

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell
프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.
gcloud services enable 명령어를 사용하여 Gemini에 Google Cloud를 위한 Gemini API를 사용 설정합니다.
```
gcloud services enable cloudaicompanion.googleapis.com
```
다른 Google Cloud 프로젝트에서 Google Cloud를 위한 Gemini API를 사용 설정하려면 --project 파라미터를 추가합니다.
```
gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
```
PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

출력은 다음과 비슷합니다.
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```

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

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

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

콘솔

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

IAM 및 관리자로 이동
주 구성원 열에서 Gemini에 대한 액세스 권한을 부여하려는 주 구성원을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.
액세스 수정 창에서 다른 역할 추가를 클릭합니다.
역할 선택에서 Google Cloud를 위한 Gemini 사용자를 선택합니다.
다른 역할 추가를 클릭하고 서비스 사용량 소비자를 선택합니다.
저장을 클릭합니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell
프로젝트 선택기 메뉴에서 프로젝트를 선택합니다.
Google Cloud를 위한 Gemini 사용자 역할을 부여합니다.
```
gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user
```
PRINCIPAL을 주 구성원 식별자로 바꿉니다. 식별자는 user|group|serviceAccount:email 또는domain:domain 형식을 취합니다(예:user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com 또는 domain:example.domain.com).

다음을 포함하는 정책 바인딩 목록이 출력됩니다.
```
- members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user
```

서비스 사용량 소비자 역할을 부여합니다.

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

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

- members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

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

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

Cloud Code 플러그인을 설치하여 IDE에서 Gemini Code Assist 사용

조직의 사용자가 선호하는 IDE에 Gemini Code Assist를 설치합니다. 자세한 내용은 다음을 참조하세요.

Cloud Workstations: Gemini Code Assist를 사용한 코드
Cloud Shell 편집기: Gemini Code Assist를 사용한 코드
VS Code용 Cloud Code: Gemini Code Assist를 사용한 코드
IntelliJ 및 기타 JetBrains IDE용 Cloud Code: Gemini Code Assist를 사용한 코드

고급 설정 태스크

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

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

이러한 인터페이스를 사용하는 경우 정규화된 역할 이름을 사용합니다.
- roles/cloudaicompanion.user
- roles/serviceusage.serviceUsageConsumer
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할을 만들고 부여합니다.

생성된 모든 커스텀 역할에서 Gemini Code Assist에 액세스하려면 다음 권한이 필요합니다.
- cloudaicompanion.companions.generateChat
- cloudaicompanion.companions.generateCode
- cloudaicompanion.instances.completeCode
- cloudaicompanion.instances.completeTask
- cloudaicompanion.instances.generateCode
- cloudaicompanion.instances.generateText
- 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 Code Assist에서 사용할 수 있는 생성형 AI 지원 유형을 자세히 알아보세요.
Google Cloud용 Gemini Code Assist에서 사용자 데이터를 사용하는 방법을 알아보세요.
Gemini Code Assist 관리자 제어에 액세스하고 관리하는 방법을 알아보세요.
코드 맞춤설정을 구성하는 방법을 알아보세요.