Cloud SDK 초기화

이 페이지에서는 Google Cloud SDK를 초기화하는 방법을 설명합니다.

Cloud SDK를 설치한 후 다음 단계는 일반적으로 gcloud init 명령어를 실행하여 초기 설정 작업을 수행하는 것입니다. 나중에 gcloud init를 실행하여 설정을 변경하거나 새 구성을 만들 수도 있습니다.

gcloud init는 다음 설정 단계를 수행합니다.

  • 사용자 계정을 사용해서 Google Cloud에 액세스하도록 Cloud SDK 도구를 승인하거나 이전에 승인된 액세스 권한이 있는 경우 다른 계정을 선택할 수 있습니다.
  • Cloud SDK 구성을 설정하고 위 단계에서의 활성 계정, 현재 프로젝트(해당하는 경우), 기본 Google Compute Engine 리전과 영역(zone)을 포함한 기본 속성 집합을 설정합니다.

gcloud init 대신 다음을 실행할 수 있습니다.

명령어 설명
gcloud auth login 구성을 설정하지 않고 사용자 계정으로 승인합니다.
gcloud auth activate-service-account 사용자 계정 대신 서비스 계정으로 승인합니다.

비대화형으로 웹브라우저 없이 승인할 때 유용합니다.

gcloud config [COMMAND]
gcloud config configurations [COMMAND]
Cloud SDK 구성과 속성을 만들고 관리합니다.

gcloud init 실행

Cloud SDK를 초기화하려면 다음 안내를 따르세요.

  1. gcloud init을 실행합니다.

    gcloud init
    

    원격 터미널 세션에 있는 경우, --console-only 플래그를 사용하여 명령어가 브라우저 기반 승인 흐름을 시작하지 못하게 할 수 있습니다.

    gcloud init --console-only
    
  2. 메시지가 표시되면 구성을 만들거나 선택합니다.

    새 Cloud SDK 설치를 초기화하는 경우, gcloud initdefault라는 이름의 새로운 구성을 만들고 이를 활성 구성으로 설정합니다. 기존 구성이 있는 경우, gcloud init은 활성 구성 다시 초기화, 다른 구성으로 전환한 후 이 구성을 다시 초기화 또는 새 구성 만들기 등 세 가지 옵션 중 하나를 선택하라는 메시지가 표시될 수 있습니다.

  3. 메시지가 나타나면 승인 단계를 완료합니다.

    Google Cloud에 대해 이전에 승인된 액세스 권한이 있는지 여부에 따라 로그인하고 웹브라우저에서 액세스 권한을 부여하거나 기존 계정을 선택하라는 메시지가 표시될 수 있습니다.

    --console-only 플래그를 사용했고 로그인해야 하는 경우, 제공된 승인 URL을 잘라서 다른 브라우저 창에 붙여넣고 제공되는 메시지를 따라야 합니다.

    이 단계가 완료되면 gcloud init은 구성의 account 속성을 지정된 계정으로 설정합니다.

  4. 메시지가 표시되면 현재 Google Cloud 프로젝트를 선택합니다.

    사용자 계정의 기본 프로젝트를 포함하여 프로젝트 하나에만 액세스할 수 있는 경우 gcloud init가 이 프로젝트를 선택합니다. 그렇지 않으면 사용자가 소유자, 편집자 또는 뷰어 권한을 가진 프로젝트 목록에서 프로젝트를 선택할 수 있습니다. gcloud init는 구성의 project 속성을 사용자가 선택하는 속성으로 설정합니다.

  5. 메시지가 표시되면 기본 Google Compute Engine 영역을 선택합니다.

    Compute Engine API를 사용 설정하지 않았거나 이미 프로젝트 수준 메타데이터에 기본 영역이 있는 경우에는 이 단계가 나타나지 않습니다. gcloud init는 사용자가 선택한 영역을 사용하여 구성의 regionzone 속성을 설정합니다.

gcloud init가 완료되면 활성 구성의 속성이 터미널에서 인쇄됩니다.

[compute]
region = us-east1
zone = us-east1-b
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project

gcloud config list 명령어를 사용하여 나중에 언제든지 이 속성을 볼 수 있습니다.

다음 단계