gcloud CLI 요약본

Google Cloud의 기본 명령줄 도구인 Google Cloud CLI에서 자주 사용하는 명령어 목록입니다.

(소개 도움말, 명령어 이해, 인쇄용 PDF도 포함됩니다.)

요약본

시작하기

gcloud CLI를 사용하여 시작합니다.

도움말

gcloud CLI가 최선을 다해 도와드리겠습니다.

  • gcloud help: gcloud CLI 참조 문서에서 특정 용어를 검색합니다.
  • gcloud feedback: gcloud CLI팀에 의견을 보냅니다.
  • gcloud topic: 접근성, 필터링, 형식 지정과 같은 비명령어 주제에 대한 보충 도움말 자료입니다.

맞춤설정

gcloud CLI를 직접 만들고 속성을 통하여 구성을 맞춤설정합니다.

승인 및 사용자 인증 정보

gcloud CLI에 대한 권한을 부여 및 취소하고 사용자 인증 정보를 관리합니다.

프로젝트

프로젝트 액세스 정책을 관리합니다.

IAM

Identity and Access Management(IAM) 환경설정 및 서비스 계정을 구성합니다.

Docker 및 Google Kubernetes Engine(GKE)

Kubernetes에서 컨테이너화된 애플리케이션을 관리합니다.

가상 머신 및 Compute Engine

Google Cloud 인프라에서 VM을 생성, 실행, 관리합니다.

서버리스 및 App Engine

완전 관리형 서버리스 플랫폼에서 확장성이 우수한 애플리케이션 빌드하기

기타

유용하게 사용되는 명령어

소개 입문서

gcloud CLI를 시작하는 방법에 대한 간단한 입문서 입니다.

Google Cloud CLI 설치

설치 안내에 따라 Google Cloud CLI를 설치합니다.

플래그, 인수 및 기타 놀라운 추가

인수는 위치 인수 또는 플래그일 수 있습니다.

  • 위치 인수: 명령어 이름 뒤에 설정하며 위치 인수의 순서를 준수해야 합니다.
  • 플래그: 위치 인수 뒤에 설정되며 플래그 순서는 중요하지 않습니다.

    플래그는 다음 중 하나일 수 있습니다.

    • 이름-값 쌍(--foo=bar)
    • 불리언(--force/no-force)

    또한 플래그는 다음 중 하나일 수 있습니다.

    • 필수
    • 선택사항: 선택적 플래그가 정의되어 있지 않으면 기본값이 사용됩니다.

전역 플래그

다음과 같은 일부 플래그는 gcloud CLI 환경 전체에서 사용할 수 있습니다.

  • --help: 잘 모르는 경우 명령어에 대한 자세한 도움말을 표시합니다.
  • --project: 현재 프로젝트가 아닌 다른 프로젝트를 사용하는 경우 사용합니다.
  • --quiet: 대화형 메시지 표시를 사용 중지하고 입력에 기본값을 적용합니다.
  • --verbosity: debug, info, warning, error, critical, none의 세부정보 수준을 설정합니다.
  • --version: gcloud 버전 정보를 표시합니다.
  • --format: config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, yaml로 출력 형식을 설정합니다.

결과 정리

필터, 형식, 제한, 정렬 기준 플래그를 통해 출력에서 최대한 활용할 수 있습니다.

f1-micro 머신 유형이 아니고 프리픽스가 us인 Compute Engine 인스턴스의 경우 다음 명령어를 사용합니다.

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

2018년 1월 15일 이후에 생성된 프로젝트 목록이 가장 오래된 것부터 최신순으로 정렬되고 프로젝트 번호, 프로젝트 ID, 로컬 시간대의 날짜 및 시간으로 이루어진 생성 시간 열이 있는 테이블로 표시되는 경우 다음 명령어를 사용합니다.

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

my-label(모든 값) 라벨이 지정된 Compute Engine 인스턴스 10개 목록의 경우 다음 명령어를 사용합니다.

gcloud compute instances list --filter="labels.my-label:*" --limit=10

명령어 이해

명령어를 자체적으로 검색할 수 있도록 하는 gcloud CLI 명령어의 기본 패턴입니다.

gcloud CLI 명령어 찾기

gcloud CLI는 트리입니다. 리프가 아닌 노드는 명령어 그룹이고 리프 노드는 명령어입니다. 명령어 및 리소스에서도 명령줄 자동 완성 기능을 사용할 수 있습니다.

대부분의 gcloud 명령어는 다음 형식을 따릅니다.

gcloud + release level (optional) + component + entity + operation + positional args + flags

예를 들면 다음과 같습니다. gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

출시 레벨

출시 레벨은 명령어의 릴리스 상태를 나타냅니다.

예시: 알파 명령어의 경우 alpha, 베타 명령어의 경우 beta, GA 명령어의 경우 출시 레벨이 필요하지 않습니다.

구성요소

구성요소는 다양한 Google Cloud 서비스를 나타냅니다.

예시: Compute Engine의 경우 compute, App Engine의 경우 app 등입니다.

항목

항목은 구성요소 아래에 있는 요소 또는 요소 모음의 복수 형태를 나타냅니다.

예시: compute의 경우 disks, firewalls, images, instances, regions, zones이 있습니다.

작업

작업은 항목에서 수행할 작업의 명령형 동사 형태를 나타냅니다.

예시: 일반적인 작업은 describe, list, create/update, delete/clear, import, export, copy, remove, add, reset, restart, restore, run, deploy입니다.

위치 인수

위치 인수는 명령어를 실행하는 데 필요한 필수 순서별 인수를 나타냅니다.

예시: <INSTANCE_NAMES>gcloud compute instances create의 필수 위치 인수입니다.

플래그

플래그는 위치 인수 뒤에 명령어로 전달되는 추가 인수 --flag-name(=value)를 나타냅니다.

예시: --machine-type=<MACHINE_TYPE>--preemptiblegcloud compute instances create에 대한 선택적 플래그입니다.