Gemini Cloud Assist 설정

Gemini Cloud Assist를 사용하려면 먼저 관리자가 이 문서에 설명된 설정 단계를 수행해야 합니다. Gemini Cloud Assist를 프로젝트 또는 폴더에 설정할 수 있습니다.

프로젝트에 Gemini Cloud Assist 설정

다음 단계에서는 Google Cloud 콘솔에서 또는 Google Cloud CLI를 사용하여 프로젝트에 Gemini Cloud Assist를 설정하는 방법을 자세히 설명합니다

콘솔

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

    Google Cloud를 위한 Gemini로 이동

  2. 페이지 상단에 있는 프로젝트 선택기에서 프로젝트 리소스를 선택합니다.

  3. Gemini Cloud Assist 가져오기를 선택합니다.

  4. Gemini Cloud Assist 가져오기 대화상자에서 다음을 수행합니다.

    1. 필수 및 권장 API 섹션에 있는 펼치기 화살표를 선택합니다.

    2. Gemini Cloud Assist APIGemini for Google Cloud API와 같은 필수 API가 사용 설정되어 있는지 확인합니다.

    3. 권장 API 목록에서 사용 설정할 API를 선택합니다.

    4. 선택사항: 프롬프트와 답변을 공유하여 Google이 Cloud Assist를 개선할 수 있도록 돕기를 선택합니다.

    5. Gemini Cloud Assist 무료 사용 설정을 선택합니다.

  5. 저장을 클릭합니다.

  6. Gemini Cloud Assist를 사용하는 데 필요한 IAM 역할을 부여합니다.

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

      IAM 및 관리자로 이동

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

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

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

    5. 다른 역할 추가를 클릭하고 추천자 뷰어를 선택합니다.

    주 구성원이 아직 액세스 권한이 없는 제품과 관련하여 지원을 받으려는 경우에는 추가 IAM 역할을 부여해야 할 수 있습니다. 다양한 제품에 최적화된 Gemini Cloud Assist 환경을 지원하는 IAM 역할 표는 Gemini Cloud Assist 사용을 위한 IAM 요구사항을 참조하세요.

gcloud

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

    Activate Cloud Shell

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

    gcloud services enable geminicloudassist.googleapis.com
    

    이 단계에서는 Gemini Cloud Assist를 사용하는 데 필요한 Gemini for Google Cloud API도 사용 설정합니다.

    다른 Google Cloud 프로젝트에서 Gemini Cloud Assist API를 사용 설정하려면 --project 파라미터를 추가합니다.

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

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

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    
  3. Google Cloud 프로젝트에서 IAM 역할을 부여합니다. 자세한 내용은 단일 역할 부여gcloud projects add-iam-policy-binding을 참조하세요.

    1. roles/geminicloudassist.user 역할을 부여합니다.

      gcloud projects add-iam-policy-binding  PROJECT_ID \
          --member=PRINCIPAL --role=roles/geminicloudassist.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/geminicloudassist.user
      
    2. roles/recommender.viewer 역할에 대해 이전 단계를 반복합니다.

    주 구성원이 아직 액세스 권한이 없는 제품과 관련하여 지원을 받으려는 경우에는 추가 IAM 역할을 부여해야 할 수 있습니다. 다양한 제품에 최적화된 Gemini Cloud Assist 환경을 지원하는 IAM 역할 표는 Gemini Cloud Assist 사용을 위한 IAM 요구사항을 참조하세요.

폴더에 Gemini Cloud Assist 설정

다음 단계에서는 Google Cloud 콘솔에서 폴더에 Gemini Cloud Assist를 설정하는 방법을 자세히 설명합니다. Google Cloud CLI를 사용하여 Gemini Cloud Assist를 설정할 수 없습니다.

  1. 필수 및 권장 API를 사용 설정합니다.

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

      Gemini 관리자로 이동

    2. 페이지 상단에 있는 프로젝트 선택기에서 폴더 리소스를 선택합니다.

    3. Gemini Cloud Assist 가져오기를 선택합니다.

      폴더 내 기존 프로젝트에 API 사용 설정 대화상자가 표시됩니다.

    4. 폴더 내 기존 프로젝트에 API 사용 설정 대화상자의 필수 및 권장 API 섹션에 있는 펼치기 화살표를 선택합니다.

    5. Gemini Cloud Assist APIGemini for Google Cloud API와 같은 필수 API가 사용 설정되어 있는지 확인합니다.

    6. 권장 API 목록에서 사용 설정할 API를 선택합니다.

    7. 선택사항: 프롬프트와 답변을 공유하여 Google이 Cloud Assist를 개선할 수 있도록 돕기를 선택합니다.

    8. Gemini Cloud Assist 무료 사용 설정을 선택합니다.

      이 단계에서는 폴더의 모든 프로젝트에 필수 API와 선택한 권장 API를 사용 설정합니다. 폴더의 일부 프로젝트에 예외를 적용하려면 해당 프로젝트에 리소스 서비스 사용량 제한 조직 정책 제약 조건을 설정하여 API 사용 설정을 차단하면 됩니다. 자세한 내용은 리소스 사용량 제한을 참조하세요.

  2. 폴더에 상응하는 권한으로 다음 IAM 역할을 부여하거나 커스텀 역할을 만듭니다.

    • Google Cloud를 위한 Gemini 사용자
    • 클라우드 애셋 뷰어
    • 추천자 뷰어

    주 구성원이 아직 액세스 권한이 없는 제품과 관련하여 지원을 받으려는 경우에는 추가 IAM 역할을 부여해야 할 수 있습니다. 다양한 제품에 최적화된 Gemini Cloud Assist 환경을 지원하는 IAM 역할 표는 Gemini Cloud Assist 사용을 위한 IAM 요구사항을 참조하세요.

  3. 애플리케이션에서 Gemini Cloud Assist를 사용하는 경우에는 애플리케이션 관리도 사용 설정해야 합니다. 이 단계에서는 결제 계정을 연결해야 하는 관리 프로젝트를 만듭니다.

    1. Gemini 관리자 페이지로 돌아갑니다.

      Gemini 관리자로 이동

    2. 앱 관리 사용 설정을 선택합니다.

      IAM 및 관리자 설정 페이지가 표시됩니다.

    3. 페이지의 앱 사용 설정 섹션에서 사용 설정을 선택합니다.

      이 폴더에서 애플리케이션 API 사용 설정 대화상자가 표시됩니다.

    4. 사용 설정을 선택합니다.

      상태 표시줄에 API 사용 설정 진행률이 표시됩니다. API 사용 설정이 완료되면 IAM 및 관리자 설정 페이지가 새로고침됩니다.

    5. 결제 관리를 선택합니다.

      연결된 계정 페이지가 표시됩니다.

    6. 목록에서 결제 계정을 선택한 후 계정 설정을 선택합니다.

  4. 2단계에서 폴더에 부여한 IAM 역할을 부여하거나 이전 단계에서 만든 관리 프로젝트에 상응하는 권한이 있는 커스텀 역할을 만듭니다.

    폴더의 관리 프로젝트를 찾습니다.

    1. Gemini 관리자 페이지로 돌아갑니다.

      Gemini 관리자로 이동

    2. 페이지 상단에 있는 프로젝트 선택기에서 폴더 리소스를 선택합니다.

    3. Gemini Cloud Assist 설정 관리를 선택합니다.

      Gemini Cloud Assist 관리 대화상자가 표시됩니다.

    4. 관리 프로젝트를 확인합니다.

  5. (선택사항) 폴더에서 프로젝트 설정을 구성합니다.

다음 단계