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
메타데이터 서버에서 기본 리전 및 영역 설정
메타데이터 서버의 기본 리전 및 영역은 프로젝트의 모든 구성에 적용됩니다. 메타데이터 서버에서 기본 리전과 영역을 설정하려면 다음을 수행합니다.
기본 리전 및 영역을 설정합니다.
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_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를 참조하세요.
다음 단계
gcloud명령줄 도구에 대한 빠른 시작 가이드를 따르세요.gcloud compute사용 도움말을 검토하세요.- 일반적인
gcloud compute명령어를 살펴보세요.