gcloud compute

Linux VM Windows VM

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로 바꿉니다.

기본 리전 및 영역

일부 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

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

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

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

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

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

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

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

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

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

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

로컬 클라이언트에서 변경사항을 초기화합니다.
```
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_CORE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

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

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

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

Linux 및 macOS

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

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

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

set CLOUDSDK_CORE_PROJECT=

set CLOUDSDK_COMPUTE_ZONE=

플래그를 사용하여 기본 리전 및 영역 재정의

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

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

gcloud compute instances create example-instance \
    --region=REGION \
    --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를 참조하세요.

다음 단계

gcloud 명령줄 도구에 대한 빠른 시작 가이드를 따르세요.
gcloud compute 사용 도움말을 검토하세요.
일반적인 gcloud compute 명령어를 살펴보세요.