gcloud 컴퓨팅

gcloud 명령줄 도구를 사용하면 gcloud compute 명령어 그룹을 사용하여 Compute Engine 리소스를 관리할 수 있습니다. Compute Engine API 대신 gcloud compute를 사용할 수 있습니다.

gcloud 도구는 Cloud SDK의 일부로서 문 자동 완성, 인플레이스(in-place) 업데이트, 명령줄 도움말, 사람이 읽을 수 있고 머신에서 구문 분석할 수 있는 출력 형식, Google Cloud SDK와의 통합 등의 기능을 포함하는 통합 명령줄 도구입니다.

Compute Engine을 사용해 본 적이 없다면 Linux 빠른 시작 또는 Windows 빠른 시작으로 시작하세요.

시작하기 전에

  • 명령 프롬프트에서 gcloud compute를 실행하려면 Cloud SDK를 설치, 업데이트, 초기화하세요.
  • 명령 프롬프트를 사용할 수 없으면 Cloud Shell에서 gcloud compute를 사용해 보세요. Cloud Shell은 최신 Cloud SDK로 자동 설치, 업데이트, 초기화됩니다.

기본 속성

가상 머신 인스턴스를 만들 때 Compute Engine은 메타데이터 서버의 기본 속성을 사용하여 VM을 구성합니다. 다음 명령어를 실행하여 VM의 기본 속성을 확인할 수 있습니다.

gcloud compute project-info describe --project PROJECT_ID

PROJECT_ID를 프로젝트 ID로 바꿉니다.

기본 프로젝트

Cloud SDK를 설정하고 초기화할 때 기본 프로젝트를 설정하면 모든 gcloud compute 명령어에 해당 프로젝트 ID가 기본적으로 사용됩니다.

다음 방법에 따라 기본 프로젝트 ID를 재정의할 수 있습니다.

  • --project 플래그를 사용하여 각 gcloud compute 명령어를 실행합니다.

  • CLOUDSDK_CORE_PROJECT 환경 변수를 설정합니다.

    Linux 및 macOS

    export 명령어를 사용하여 프로젝트 환경 변수를 설정합니다.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    PROJECT_ID를 기본값으로 사용할 프로젝트의 프로젝트 ID로 바꿉니다.

    프로젝트 환경 변수 설정 해제

    프로젝트 환경 변수를 설정 해제해야 할 경우 다음 unset 명령어를 사용합니다.

    unset CLOUDSDK_CORE_PROJECT

    Windows

    set 명령어를 사용하여 프로젝트 환경 변수를 설정합니다.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    PROJECT_ID를 기본값으로 사용할 프로젝트의 프로젝트 ID로 바꿉니다.

    프로젝트 환경 변수 설정 해제

    프로젝트 환경 변수를 설정 해제해야 할 경우 다음 명령어를 사용합니다.

    set CLOUDSDK_CORE_PROJECT=

기본 프로젝트 또는 환경 변수를 설정하지 않을 경우 실행하는 각 gcloud compute 명령어에 --project 플래그를 포함해야 합니다.

기본 리전 및 영역

일부 gcloud compute 명령어에는 --region 또는 --zone 플래그가 필요합니다. 명령어를 실행할 때마다 이러한 플래그를 지정하는 대신 프로젝트에 기본 리전 및 영역을 설정할 수 있습니다. 기본 리전이나 영역을 설정하지 않은 경우 리전 또는 영역 종속 명령어를 실행하면 gcloud 명령줄 도구에서 --region 또는 --zone 플래그를 제공하라는 메시지를 표시하거나 오류를 반환합니다.

다음 세 가지 방법으로 기본 리전 및 영역을 설정할 수 있습니다.

  • 메타데이터 서버 사용. gcloud init 실행 시 메타데이터 서버에 설정된 기본 리전 및 영역이 로컬 클라이언트에 적용됩니다.
  • 로컬 클라이언트 사용. 로컬 클라이언트에 설정된 기본 리전 및 영역이 메타데이터 서버에 설정된 기본 리전 및 영역을 재정의합니다.
  • 환경 변수 사용. 환경 변수에 설정된 기본 리전 및 영역이 로컬 클라이언트 및 메타데이터 서버에 설정된 기본 리전 및 영역을 재정의합니다.

명령어를 실행할 때 --region 및 --zone 플래그를 제공하여 메타데이터 서버, 로컬 클라이언트, 환경 변수에서 기본 리전 및 영역을 재정의할 수 있습니다.

기본 리전 및 영역 보기

기본 리전 및 영역을 보려면 다음 명령어를 실행합니다.

gcloud config get-value compute/region
gcloud config get-value compute/zone

출력이 (unset)이면 기본 리전이나 영역이 설정되지 않은 것입니다.

사용 가능한 리전 및 영역 보기

다음 명령어를 실행하여 리전 및 영역 목록을 볼 수 있습니다.

gcloud compute regions list
gcloud compute zones list

메타데이터 서버에서 기본 리전 및 영역 설정

메타데이터 서버의 기본 리전 및 영역은 프로젝트의 모든 구성에 적용됩니다. 메타데이터 서버에서 기본 리전과 영역을 설정하려면 다음을 수행합니다.

  1. 기본 리전 및 영역을 설정합니다.

    gcloud compute project-info add-metadata \
   --metadata=[google-compute-default-region=REGION | google-compute-default-zone=ZONE]

    예를 들면 다음과 같습니다.

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

  2. 로컬 클라이언트에서 변경사항을 초기화합니다.

    gcloud init

로컬 클라이언트에서 기본 리전 및 영역을 설정하거나 환경 변수에서 기본 리전 및 영역을 설정하거나 명령어에 --zone 또는 --region 플래그를 포함하여 메타데이터 서버에 지정된 기본 리전 및 영역을 재정의할 수 있습니다.

메타데이터 서버에서 기본 리전 및 영역 설정 해제

메타데이터 서버에서 기본 리전 및 영역을 설정 해제하려면 다음 안내를 따르세요.

  1. 메타데이터를 설정 해제합니다.

    gcloud compute project-info remove-metadata \
   --keys=[google-compute-default-region | google-compute-default-zone]

  2. 로컬 클라이언트에서 변경사항을 초기화합니다.

    gcloud init

로컬 클라이언트에서 기본 리전 및 영역 설정

로컬 클라이언트에 설정된 기본 리전 및 영역이 메타데이터 서버에 설정된 기본 리전 및 영역을 재정의합니다.

로컬 클라이언트에서 기본 리전 및 영역을 설정하려면 다음 명령어를 실행합니다.

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

로컬 클라이언트에서 기본 리전 및 영역 설정 해제

로컬 클라이언트에서 기본 리전 또는 영역을 설정 해제하려면 다음 명령어를 실행합니다.

gcloud config unset compute/zone

gcloud config unset compute/region

환경 변수에 기본 리전 및 영역을 설정하거나 명령어에 --zone 또는 --region 플래그를 포함하여 로컬 클라이언트에 설정된 기본 리전 및 영역을 재정의할 수 있습니다.

환경 변수에서 기본 리전 및 영역 설정

환경 변수에 설정된 기본 리전 및 영역이 로컬 클라이언트 및 메타데이터 서버에 설정된 기본 리전 및 영역을 재정의합니다.

Linux 및 macOS

export 명령어를 사용하여 리전 및 영역 변수를 설정합니다.

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

환경 변수를 영구적으로 만들려면 ~/.bashrc 파일에 이러한 명령어를 포함한 후 터미널을 다시 시작합니다.

Windows

set 명령어를 사용하여 리전 및 영역 변수를 설정합니다.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

명령어에 --zone 또는 --region 플래그를 포함하여 환경 변수를 재정의할 수 있습니다.

환경 변수에서 기본 리전 및 영역 설정 해제

다음 명령어를 사용하여 환경 변수에서 기본 리전 및 영역을 설정 해제합니다.

Linux 및 macOS

리전 및 영역 환경 변수를 설정 해제하려면 다음 unset 명령어를 사용합니다.

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

리전 및 영역 환경 변수를 설정 해제하려면 다음 명령어를 사용합니다.

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

플래그로 기본 영역 재정의

--zone 플래그를 사용하여 메타데이터 서버, 로컬 클라이언트, 환경 변수에 설정된 기본 영역을 재정의합니다.

예를 들면 다음과 같습니다.

gcloud compute instances create example-instance \
    --zone=ZONE

구성

gcloud topic configurations는 gcloud 도구의 동작에 영향을 주는 데 사용할 수 있는 고급 기능입니다. 대부분의 사용자는 기본 구성을 사용하는 것으로 충분합니다.

구성은 다음과 같은 사용자에게 유용할 수 있습니다.

  • 여러 프로젝트 작업을 수행합니다. 프로젝트마다 별도의 구성을 만들 수 있습니다.
  • 여러 계정을 사용합니다. 예를 들어 사용자 계정과 서비스 계정을 사용합니다.
  • 다양한 개별 작업을 수행합니다(한 프로젝트에서 App Engine 앱 작업, us-central-1a 영역에서 Compute Engine 클러스터 관리, asia-east-1 리전에서 네트워크 구성 관리 등).

구성 간을 전환하려면 다음 명령어를 실행하세요.

gcloud config configurations activate CONFIGURATION_NAME

구성 관리에 대한 자세한 내용은 gcloud config configurations를 참조하세요.

다음 단계