gcloud CLI 초기화

이 페이지에서는 gcloud CLI를 초기화하는 방법을 보여줍니다.

gcloud CLI를 설치한 후 gcloud init을 실행하여 초기 설정 작업을 수행합니다. gcloud init을 실행하여 설정을 변경하거나 새 구성을 만들 수도 있습니다.

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

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

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

명령어 설명
gcloud auth login 구성을 설정하지 않고 사용자 계정으로 인증합니다.
gcloud auth activate-service-account 사용자 계정 대신 서비스 계정으로 인증합니다.
비대화형으로 웹브라우저 없이 승인할 때 유용합니다.
gcloud config [COMMAND]
gcloud config configurations [COMMAND] 		gcloud CLI 구성과 속성을 만들고 관리합니다.

gcloud CLI 초기화

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

  1. gcloud init을 실행합니다.

    gcloud init

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

    gcloud init --no-launch-browser

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

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

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

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

    --no-launch-browser 플래그를 사용했고 로그인해야 하는 경우, 제공된 승인 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. 메시지가 표시되면 기본 Compute Engine 영역을 선택합니다.

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

gcloud init 명령어를 통해 설정된 속성을 보려면 gcloud config list 명령어를 사용합니다.

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

다음 단계