프로젝트에 대한 Gemini Code Assist 설정

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

  1. 선택사항: Gemini Code Assist 구독을 구매합니다. Gemini Code Assist는 2024년 11월 8일까지 무료로 사용해 볼 수 있으며 결제 계정당 사용자 1명으로 제한됩니다.

  2. Google Cloud 프로젝트에서 Gemini Code Assist 활성화 일반적으로 관리자가 이 단계를 수행합니다.

  3. 선택사항: IDE에서 Gemini Code Assist를 사용하려면 Cloud Code 플러그인을 설치합니다.

선택사항: Gemini Code Assist 구독 구매하기

Gemini Code Assist는 2024년 11월 8일까지 구독 없이 무료로 사용해 볼 수 있으며 결제 계정당 사용자 한 명으로 제한됩니다. 결제 계정당 여러 사용자가 있는 조직은 이 섹션에 설명된 대로 구독을 구매해야 합니다. Google Cloud와 기존 계약이 있는 경우 구독을 구매하기 전에 영업팀에 문의하세요.

  1. Google Cloud 콘솔에서 Google Cloud를 위한 Gemini 페이지로 이동합니다.

    Google Cloud를 위한 Gemini로 이동

  2. Gemini 시작하기를 클릭합니다.

  3. 메시지가 표시되면 결제 계정을 선택하고 Continue to Admin for Gemini(Gemini 관리 페이지 계속)를 클릭합니다.

  4. 구독 구성에서 약정 기간(월간 또는 연간) 및 구독의 라이선스 수를 포함하여 구독을 구성하는 필드를 작성합니다.

    약정 기간(월간 또는 연간) 이후 구독을 자동 갱신할지 여부를 선택합니다. 자동 갱신은 구독 및 라이선스를 활성 상태로 유지합니다. 구독이 자동 갱신되지 않는 경우 현재 기간이 끝나면 구독이 종료되며, 라이선스를 다시 획득하려면 구매 프로세스를 다시 진행해야 합니다.

  5. 구독 세부정보를 검토하려면 계속을 클릭합니다.

  6. 약관에 동의하면 구매 완료를 클릭한 다음 구독을 확인합니다.

이제 Gemini에 대한 결제가 사용 설정되었습니다. 이제 이 결제 계정과 연결된 하나 이상의 프로젝트에서 Gemini Code Assist를 활성화해야 합니다. Gemini는 하나 이상의 프로젝트에서 활성화할 때까지 사용자에게 표시되지 않습니다.

Google Cloud 프로젝트에서 Gemini Code Assist 활성화

Google Cloud 프로젝트에서 Gemini Code Assist를 활성화하려면 관리자가 Cloud AI Companion API를 사용 설정하고 Cloud AI 컴패니언 사용자 및 서비스 사용량 뷰어 IAM 역할을 사용자에게 부여해야 합니다.

콘솔

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

    Google Cloud를 위한 Gemini로 이동

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

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

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

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

    IAM 및 관리자로 이동

  5. 주 구성원 열에서 Gemini에 대한 액세스를 사용 설정하려는 주 구성원 열을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.

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

  7. 역할 선택에서 Cloud AI 컴패니언 사용자를 선택합니다.

  8. 다른 역할 추가를 클릭하고 서비스 사용량 뷰어를 선택합니다.

  9. 저장을 클릭합니다.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. 프로젝트 선택기 드롭다운 목록에서 프로젝트를 선택합니다.

  3. 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를 사용할 수 있습니다.

  4. Gemini를 사용하는 데 필요한 두 가지 IAM 역할을 부여합니다.

    1. 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
      
    2. 서비스 사용량 뷰어 역할을 부여합니다.

      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 플러그인을 설치해야 합니다. 자세한 내용은 다음을 참조하세요.

고급 설정 태스크

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

다음 단계