일반 gcloud compute 명령어

이 문서에는 가장 일반적으로 사용되는 gcloud compute 명령어의 일부가 나열되어 있습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.

    1. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다. 

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

프로젝트 설명

다음 명령어를 실행하여 프로젝트 메타데이터, ssh 키, 할당량 측정항목과 같은 Compute Engine 프로젝트에 대한 정보를 쿼리합니다.

 gcloud compute project-info describe

프로젝트 설명에 대한 자세한 내용은 gcloud compute project-info describe 참조 문서를 확인하세요.

VM 작업

다음 예시에서는 가상 머신 (VM) 인스턴스로 작업할 때 자주 수행되는 작업을 보여줍니다. 가상 머신 (VM) 인스턴스에 대한 자세한 내용은 가상 머신 인스턴스를 참조하세요.

VM 만들기

다음 명령어를 실행하여 VM을 만듭니다.

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

다음을 바꿉니다.

  • VM_NAME: 새 VM의 이름입니다.
  • IMAGE 또는 IMAGE_FAMILY: 다음 중 하나를 지정합니다.
    • IMAGE: 공개 이미지의 필수 버전입니다. 예를 들면 --image debian-10-buster-v20200309입니다.
    • IMAGE_FAMILY: 이미지 계열입니다. 이렇게 하면 지원 중단되지 않은 최신 OS 이미지를 사용하여 VM이 생성됩니다. 예를 들어 --image-family debian-10을 지정하면 Compute Engine이 Debian 10 이미지 계열에서 최신 버전의 OS 이미지를 사용하여 VM을 만듭니다.
  • IMAGE_PROJECT: 이미지가 포함된 프로젝트입니다.

VM 만들기에 대한 자세한 내용은 VM 인스턴스 만들기 및 시작하기와 gcloud compute instances create 참조 문서를 확인하세요.

VM 나열

다음 명령어를 실행하여 프로젝트의 모든 VM을 표시합니다.

gcloud compute instances list

VM 나열에 대한 자세한 내용은 gcloud compute instances list 참조 문서를 확인하세요.

GPU가 있는 VM 나열

다음 명령어를 실행하여 프로젝트에서 GPU가 있는 모든 VM을 표시합니다.

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

로컬 SSD가 있는 VM 나열

다음 명령어를 실행하여 프로젝트에서 로컬 SSD가 있는 모든 VM을 표시합니다.

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

VM 설명

다음 명령어를 실행하여 VM과 연결된 모든 데이터를 표시합니다.

gcloud compute instances describe VM_NAME

VM_NAME을 VM의 이름으로 바꿉니다.

VM 설명에 대한 자세한 내용은 gcloud compute instances describe 참조 문서를 확인하세요.

VM 시작

다음 명령어를 실행하여 중지된 VM을 시작합니다.

gcloud compute instances start VM_NAME

VM_NAME을 VM의 이름으로 바꿉니다.

VM 시작에 대한 자세한 내용은 인스턴스 시작 및 중지와 gcloud compute instances start 참조 문서를 확인하세요.

VM 중지

다음 명령어를 실행하여 VM을 중지합니다.

gcloud compute instances stop VM_NAME

VM_NAME을 VM의 이름으로 바꿉니다.

VM 중지에 대한 자세한 내용은 인스턴스 시작 및 중지와 gcloud compute instances stop 참조 문서를 확인하세요.

VM에 라벨 추가

다음 명령어를 실행하여 VM에 라벨을 추가합니다.

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.
  • KEY=VALUE: 라벨의 키-값 쌍입니다.

VM 라벨 지정에 대한 자세한 내용은 리소스 라벨 지정 및 gcloud compute instances add-labels 참조 문서를 확인하세요.

VM에 연결

SSH를 사용하여 인스턴스에 연결

다음 명령어를 실행하여 SSH를 통해 VM에 연결합니다.

gcloud compute ssh VM_NAME

VM_NAME을 VM의 이름으로 바꿉니다.

SSH를 사용하여 VM에 연결하는 방법에 대한 자세한 내용은 Linux VM에 연결과 gcloud compute ssh 참조 문서를 확인하세요.

SCP를 사용하여 파일을 인스턴스에 전송

다음 명령어를 실행하여 파일을 VM에 복사합니다.

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

다음 명령어를 실행하여 VM에서 파일을 복사합니다.

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

다음을 바꿉니다.

  • LOCAL_FILE_PATH: 워크스테이션에 있는 파일의 경로입니다.
  • VM_NAME: VM의 이름입니다.
  • REMOTE_DIRECTORY: VM에 있는 디렉터리의 경로입니다.

SCP를 사용하여 VM에서 파일을 전송하는 방법에 대한 자세한 내용은 Google Cloud CLI를 사용하여 파일 전송 및 gcloud compute scp 참조 문서를 확인하세요.

디스크 작업

다음 예시에서는 디스크 작업 시 일반적인 작업을 보여줍니다. 디스크에 대한 자세한 내용은 스토리지 옵션을 참조하세요.

디스크 나열

다음 명령어를 실행하여 프로젝트의 모든 디스크를 표시합니다.

gcloud compute disks list

디스크 나열에 대한 자세한 내용은 gcloud compute disks list 참조 문서를 확인하세요.

스냅샷 다루기

다음 예시에서는 스냅샷 작업 시의 일반적인 작업을 보여줍니다. 스냅샷에 대한 자세한 내용은 영구 디스크 스냅샷을 참조하세요.

스냅샷 나열

다음 명령어를 실행하여 프로젝트의 모든 스냅샷을 표시합니다.

gcloud compute snapshots list

스냅샷 설명에 대한 자세한 내용은 gcloud compute snapshots list 참조 문서를 확인하세요.

스냅샷 설명

다음 명령어를 실행하여 스냅샷과 관련된 모든 데이터를 표시합니다.

gcloud compute snapshots describe SNAPSHOT_NAME

SNAPSHOT_NAME을 스냅샷의 이름으로 바꿉니다.

스냅샷 설명에 대한 자세한 내용은 gcloud compute snapshots describe 참조 문서를 확인하세요.

스냅샷 삭제

다음 명령어를 실행하여 스냅샷을 삭제합니다.

gcloud compute snapshots delete SNAPSHOT_NAME

SNAPSHOT_NAME을 스냅샷의 이름으로 바꿉니다.

스냅샷 삭제에 대한 자세한 내용은 스냅샷 삭제 및 gcloud compute snapshots delete 참조 문서를 확인하세요.

방화벽 규칙 작업

다음 예시는 방화벽 규칙 작업 시 일반적인 작업을 보여줍니다. 방화벽 규칙에 대한 자세한 내용은 VPC 방화벽 규칙 개요를 참조하세요.

방화벽 규칙 설명

다음 명령어를 실행하여 방화벽 규칙과 연결된 모든 데이터를 표시합니다.

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

FIREWALL_RULE_NAME을 방화벽 규칙의 이름으로 바꿉니다.

방화벽 규칙 설명에 대한 자세한 내용은 gcloud compute firewall-rules describe 참조 문서를 확인하세요.

방화벽 규칙 만들기

다음 명령어를 실행하여 방화벽 규칙을 만듭니다.

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

--allow 또는 --action 중 하나와 --rules을 지정하고 다음을 바꿉니다.

  • FIREWALL_RULE_NAME: 방화벽 규칙의 이름입니다.
  • ACTION: 일치 시 작업 (allow 또는 deny)입니다.
  • PROTOCOL:PORT: 방화벽 규칙의 영향을 받는 트래픽의 프로토콜 및 포트입니다.

방화벽 규칙 만들기에 대한 자세한 내용은 방화벽 규칙 만들기와 gcloud compute firewall-rules create 참조 문서를 확인하세요.

관리형 인스턴스 그룹 (MIG) 작업

다음 예시에서는 MIG 작업 시의 일반적인 작업을 보여줍니다. MIG에 대한 자세한 내용은 관리형 인스턴스 그룹 (MIG)을 참조하세요.

관리형 인스턴스 그룹 만들기

다음 명령어를 실행하여 MIG를 만듭니다.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE

다음을 바꿉니다.

  • INSTANCE_GROUP_NAME: 인스턴스 그룹의 이름입니다.
  • SIZE: 인스턴스 그룹의 크기입니다.
  • INSTANCE_TEMPLATE: 이 그룹에 사용할 인스턴스 템플릿의 이름입니다.

MIG 만들기에 대한 자세한 내용은 MIG 만들기 기본 시나리오 및 gcloud compute instance-groups managed create 참조 문서를 확인하세요.

자동 확장 설정

다음 명령어를 실행하여 CPU 사용률에 따라 MIG에 자동 확장을 설정합니다.

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

다음을 바꿉니다.

  • INSTANCE_GROUP_NAME: MIG 이름입니다.
  • MAX_NUM_REPLICAS: 자동 확장 처리에서 만들 수 있는 최대 복제본 수입니다.
  • TARGET_CPU_UTILIZATION: 자동 확장 처리가 유지해야 하는 CPU 수준이며 0.0와 1.0 사이입니다.

자동 확장 설정에 대한 자세한 내용은 인스턴스 그룹 자동 확장 및 gcloud compute instance-groups managed set-autoscaling 참조 문서를 확인하세요.

메타데이터 작업

다음 예시는 메타데이터 작업 시 일반적인 작업을 보여줍니다. 메타데이터에 대한 자세한 내용은 메타데이터 저장 및 검색을 참조하세요.

프로젝트 수준 메타데이터 추가

다음 명령어를 실행하여 메타데이터를 프로젝트에 추가합니다.

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.
  • KEY=VALUE: 메타데이터 키-값 쌍입니다.

VM에 메타데이터를 추가하는 방법에 대한 자세한 내용은 프로젝트 전체의 커스텀 메타데이터 설정 및 gcloud compute project-info add-metadata 참조 문서를 확인하세요.

인스턴스 수준 메타데이터 추가

다음 명령어를 실행하여 메타데이터를 VM에 추가합니다.

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

다음을 바꿉니다.

  • VM_NAME: VM의 이름입니다.
  • KEY=VALUE: 메타데이터 키-값 쌍입니다.

VM에 메타데이터를 추가하는 방법에 대한 자세한 내용은 인스턴스 메타데이터 설정 및 gcloud compute instances add-metadata 참조 문서를 확인하세요.

도움말 페이지 보기

다음 명령어는 gcloud compute 명령어에 대한 일반 도움말에서 리소스 그룹(instances)이나 명령어(create)에 대한 특정 도움말까지 여러 유형의 도움말에 액세스하는 방법을 보여줍니다. 모든 리소스와 명령어에 대한 포괄적 도움말은 다음 패턴을 따릅니다.

gcloud compute --help
gcloud compute instances --help
gcloud compute instances create --help

--help 플래그 대신 -h 플래그를 사용하여 빠른 도움말을 볼 수 있습니다. Google Cloud CLI 참조에서 종합적인 도움말을 모두 검토할 수도 있습니다.

gcloud CLI 구성을 위한 명령어가 포함된 종합적인 도움말을 보려면 다음 명령어를 실행하세요.

gcloud topic TOPIC

TOPIC을 도움말 항목으로 바꿉니다. 도움말 주제의 목록은 gcloud topic 참조 문서를 확인하세요.

다음 단계