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 속성을 사용자가 선택하는 속성으로 설정합니다. 200개가 넘는 프로젝트에 액세스할 수 있는 경우 프로젝트 ID를 입력하거나 새 프로젝트를 만들거나 프로젝트를 나열하라는 메시지가 표시됩니다.

    This account has a lot of projects! Listing them all can take a while.
     [1] Enter a project ID
     [2] Create a new project
     [3] List projects
    Please enter your numeric choice:
    
  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 명령어를 사용하여 나중에 언제든지 이 속성을 볼 수 있습니다.

다음 단계