Gemini Code Assist를 사용하려면 먼저 팀에서 이 문서에 설명된 설정 단계를 수행해야 합니다.
선택사항: Gemini Code Assist 구독을 구매합니다. Gemini Code Assist는 2024년 11월 8일까지 무료로 사용해 볼 수 있으며 결제 계정당 사용자 1명으로 제한됩니다.
Google Cloud 프로젝트에서 Gemini Code Assist 활성화 일반적으로 관리자가 이 단계를 수행합니다.
선택사항: IDE에서 Gemini Code Assist를 사용하려면 Cloud Code 플러그인을 설치합니다.
선택사항: Gemini Code Assist 구독 구매하기
Gemini Code Assist는 2024년 11월 8일까지 구독 없이 무료로 사용해 볼 수 있으며 결제 계정당 사용자 한 명으로 제한됩니다. 결제 계정당 여러 사용자가 있는 조직은 이 섹션에 설명된 대로 구독을 구매해야 합니다. Google Cloud와 기존 계약이 있는 경우 구독을 구매하기 전에 영업팀에 문의하세요.
Google Cloud 콘솔에서 Google Cloud를 위한 Gemini 페이지로 이동합니다.
Gemini 시작하기를 클릭합니다.
메시지가 표시되면 결제 계정을 선택하고 Continue to Admin for Gemini(Gemini 관리 페이지 계속)를 클릭합니다.
구독 구성에서 약정 기간(월간 또는 연간) 및 구독의 라이선스 수를 포함하여 구독을 구성하는 필드를 작성합니다.
약정 기간(월간 또는 연간) 이후 구독을 자동 갱신할지 여부를 선택합니다. 자동 갱신은 구독 및 라이선스를 활성 상태로 유지합니다. 구독이 자동 갱신되지 않는 경우 현재 기간이 끝나면 구독이 종료되며, 라이선스를 다시 획득하려면 구매 프로세스를 다시 진행해야 합니다.
구독 세부정보를 검토하려면 계속을 클릭합니다.
약관에 동의하면 구매 완료를 클릭한 다음 구독을 확인합니다.
이제 Gemini에 대한 결제가 사용 설정되었습니다. 이제 이 결제 계정과 연결된 하나 이상의 프로젝트에서 Gemini Code Assist를 활성화해야 합니다. Gemini는 하나 이상의 프로젝트에서 활성화할 때까지 사용자에게 표시되지 않습니다.
Google Cloud 프로젝트에서 Gemini Code Assist 활성화
Google Cloud 프로젝트에서 Gemini Code Assist를 활성화하려면 관리자가 Cloud AI Companion API를 사용 설정하고 Cloud AI 컴패니언 사용자 및 서비스 사용량 뷰어 IAM 역할을 사용자에게 부여해야 합니다.
콘솔
Cloud AI Companion API를 사용 설정하려면 Google Cloud용 Gemini 페이지로 이동합니다.
프로젝트 선택기에서 프로젝트를 선택합니다.
사용 설정을 클릭합니다.
페이지가 업데이트되고 사용 설정됨 상태가 표시됩니다. 이제 선택한 Google Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Gemini를 사용할 수 있습니다.
Gemini를 사용하는 데 필요한 IAM 역할을 부여하려면 IAM 및 관리자 페이지로 이동합니다.
주 구성원 열에서 Gemini에 대한 액세스를 사용 설정하려는 주 구성원 열을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.
액세스 수정 창에서
다른 역할 추가를 클릭합니다.역할 선택에서 Cloud AI 컴패니언 사용자를 선택합니다.
다른 역할 추가를 클릭하고 서비스 사용량 뷰어를 선택합니다.
저장을 클릭합니다.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
프로젝트 선택기 드롭다운 목록에서 프로젝트를 선택합니다.
gcloud services enable
명령어를 사용하여 Gemini용 Cloud AI Companion API를 사용 설정합니다.gcloud services enable cloudaicompanion.googleapis.com
다른 Google Cloud 프로젝트에 Cloud AI Companion 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를 사용할 수 있습니다.
Gemini를 사용하는 데 필요한 두 가지 IAM 역할을 부여합니다.
Cloud AI 컴패니언 사용자 역할을 부여합니다.
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.serviceUsageViewer
다음을 포함하는 정책 바인딩 목록이 출력됩니다.
- members: - user:PRINCIPAL role: roles/serviceusage.serviceUsageViewer
자세한 내용은 단일 역할 부여 및
gcloud projects add-iam-policy-binding
을 참조하세요.
이러한 역할이 부여된 모든 사용자가 지정된 프로젝트 내에서 Google Cloud 콘솔의 Gemini 기능에 액세스할 수 있습니다. 자세한 내용은 AI 지원 및 개발에 Gemini 사용하기를 참조하세요.
선택사항: IDE에서 Gemini Code Assist 사용
IDE에서 Gemini를 사용하려는 개발자라면 Cloud Code 플러그인을 설치해야 합니다. 자세한 내용은 다음을 참조하세요.
- 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.serviceUsageViewer
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할을 만들고 부여합니다.
자신이 만든 모든 커스텀 역할이 Gemini에 액세스하려면 다음 권한이 필요합니다.
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
serviceusage.services.get
다음 단계
- Google Cloud를 위한 Gemini에서 사용할 수 있는 생성형 AI 지원 유형에 대해 자세히 알아보세요.
- Google Cloud를 위한 Gemini에서 사용자 데이터를 사용하는 방법을 알아보세요.
- Gemini 관리 제어 기능에 액세스하고 관리하는 방법을 알아보세요.