gcloud 도구 요약본

gcloud 도구 요약본

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

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

요약본

시작하기

gcloud 도구를 시작해 보세요.

도움말

Cloud SDK는 최선을 다해 도와드리겠습니다.

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

맞춤설정

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

사용자 인증 정보

Cloud SDK에 대한 권한 부여 및 취소

프로젝트

프로젝트 액세스 정책 관리

IAM

Identity and Access Management(IAM) 환경설정 및 서비스 계정 구성

Docker 및 Google Kubernetes Engine(GKE)

Kubernetes에서 컨테이너화된 애플리케이션 관리

가상 머신 및 Compute Engine

Google Cloud 인프라에서 VM 생성, 실행, 관리

서버리스 및 App Engine

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

기타

유용하게 사용되는 명령어

소개 입문서

gcloud 도구를 시작하기 위한 빠른 입문서를 소개합니다.

Cloud SDK 설치

이러한 설치 안내에 따라 Cloud SDK를 설치합니다.

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

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

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

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

    • 이름-값 쌍(--foo=bar)
    • 부울(--force/no-force)

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

    • 필수
    • 선택 사항: 이 경우 플래그가 정의되지 않았다면 기본값이 사용됩니다.

전역 플래그

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

  • --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 명령어의 기본 패턴입니다.

gcloud 도구 명령어 찾기

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

대부분의 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에 대한 선택적 플래그입니다.