gcloud 도구 개요

이 페이지에는 gcloud 명령줄 도구와 일반 명령 패턴 및 기능에 대한 개요가 포함되어 있습니다.

gcloud 도구란 무엇인가요?

gcloud 명령줄 도구는 Google Cloud 리소스를 만들고 관리하기 위한 기본 CLI 도구입니다. 이 도구를 사용하여 명령줄이나 스크립트 및 기타 자동화에서 많은 공통 플랫폼 작업을 수행할 수 있습니다.

예를 들어 gcloud 도구를 사용하여 다음 항목을 만들고 관리할 수 있습니다.

  • Compute Engine 가상 머신 인스턴스 및 기타 리소스
  • Cloud SQL 인스턴스
  • Google Kubernetes Engine 클러스터
  • Dataproc 클러스터 및 작업
  • Cloud DNS 관리 영역 및 레코드 조합
  • Cloud Deployment Manager 배포

gcloud 도구를 사용하여 App Engine 애플리케이션을 배포하고 인증을 관리하며 로컬 구성을 맞춤설정하며 다른 태스크를 수행할 수도 있습니다. gcloud 도구 기능에 대한 자세한 내용은 gcloud 도구 참조를 확인하세요.

gcloud 도구 요약본

gcloud 도구, 일반적으로 사용되는 명령어 목록, 이러한 명령어가 구조화되는 방식에 대한 간단한 소개는 gcloud 도구 요약본을 참조하세요.

gcloud 도구 및 Cloud SDK

gcloud 도구는 Cloud SDK의 일부입니다. gcloud 도구를 사용하려면 먼저 시스템에 Cloud SDK를 다운로드하여 설치하고 Cloud SDK를 초기화해야 합니다 .

기본적으로 Cloud SDK는 일반 안정화 버전 수준에 있는 gcloud 도구 명령어를 설치합니다. 추가 기능은 alphabeta라고 하는 Cloud SDK 구성요소에서 사용 가능합니다. 이러한 구성요소를 통해 gcloud 도구를 사용하여 Cloud Bigtable, Dataflow, Google Cloud의 다른 부분을 일반 안정화 버전 이전 출시 버전 수준에서 사용할 수 있습니다.

gcloud 도구 출시 버전 번호는 Cloud SDK와 버전 번호와 동일합니다. 현재 Cloud SDK 버전은 369.0.0입니다. 다운로드 보관 파일에서 Cloud SDK의 이전 버전을 다운로드하여 설치할 수 있습니다.

gcloud 도구 다운로드

다운로드 페이지에서 gcloud 도구가 포함된 최신 버전의 Cloud SDK를 다운로드할 수 있습니다.

출시 레벨

gcloud 도구 명령어의 출시 레벨은 다음과 같습니다.

출시 레벨 라벨 설명
일반 안정화 버전 없음 명령어가 완전히 안정적이며 프로덕션 용도로 사용될 수 있습니다. 현재 기능을 손상시키는 명령어의 변경사항에 대한 사전 알림은 출시 노트를 참조하세요.
베타 beta 명령어가 기능적으로 완전하지만 명령어에 아직 해결되지 않은 문제가 있을 수 있습니다. 이러한 명령어는 예고 없이 변경될 수 있습니다.
알파 alpha 명령어가 초기 출시 상태이며 예고 없이 변경될 수 있습니다.

Cloud SDK를 설치할 때 alphabeta 구성요소는 기본적으로 설치되지 않습니다. gcloud components install 명령어를 사용하여 별도로 이러한 구성요소를 설치해야 합니다. alpha 또는 beta 명령어를 실행하려고 하지만 해당 구성요소가 설치되어 있지 않으면 gcloud 도구에서 이를 설치하라는 메시지를 표시합니다.

명령어 그룹

각 출시 레벨 내에서 gcloud 도구 명령어는 중첩된 명령어 그룹 계층으로 구성되며 각 명령어 그룹은 Google Cloud 또는 기능 하위 그룹의 제품이나 기능을 나타냅니다.

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

명령어 그룹 설명
gcloud compute 일반 안정화 버전에서 Compute Engine과 관련된 명령어
gcloud compute instances 일반 안정화 버전에서 Compute Engine 인스턴스와 관련된 명령어
gcloud beta compute 베타에서 Compute Engine과 관련된 명령어
gcloud alpha app 알파에서 App Engine 배포 관리와 관련된 명령어

gcloud 도구 명령어 실행

다른 명령줄 도구를 사용할 때와 마찬가지로 명령줄에서 gcloud 도구 명령어를 실행할 수 있습니다. 또한 Jenkins를 사용하여 Google Cloud 태스크를 자동화하는 경우와 같이 스크립트와 기타 자동화에서 gcloud 도구 명령어도 실행할 수 있습니다.

속성

gcloud 도구 속성gcloud 도구 및 기타 Cloud SDK 도구의 동작에 영향을 미치는 설정입니다. 이러한 속성 중 일부는 전역 또는 명령어 플래그로 설정될 수 있습니다. 이 경우 플래그로 설정된 값이 우선 적용됩니다.

접근성 기능 사용 설정

스크린 리더 환경을 더 간소화하기 위해 gcloud 도구는 accessibility/screen_reader 속성과 함께 제공됩니다.

이 속성을 사용하려면 다음을 실행합니다.

gcloud config set accessibility/screen_reader true

gcloud 명령줄 도구와 함께 제공되는 접근성 기능에 대한 자세한 내용은 접근성 기능 사용 설정 가이드를 참조하세요.

구성

구성은 gcloud 도구 속성을 조합하여 이름을 붙인 것입니다. 구성은 프로필과 같은 역할을 수행합니다.

Cloud SDK를 사용하면 default라는 단일 구성으로 작업하고 gcloud init 또는 gcloud config set를 실행하여 속성을 설정할 수 있습니다. 대부분의 경우에 이 단일 기본 구성이 적합합니다.

여러 프로젝트나 승인 계정에서 작업하려면 gcloud config configurations create로 여러 구성을 설정하고 구성 간에 전환할 수 있습니다. 구성 내에서 속성을 맞춤설정할 수 있습니다. 예를 들어 활성 구성 내에서 프로젝트를 설정하려면 project 속성을 사용합니다.

gcloud config set project <project-id>

이러한 개념에 대한 자세한 내용은 구성 가이드를 참조하세요.

전역 플래그

gcloud 도구는 호출 수준에 따른 명령어 동작을 제어하는 gcloud 도구 전체 플래그 세트를 제공합니다. 플래그는 Cloud SDK 속성에서 설정된 값을 재정의합니다.

위치 인수 및 플래그

위치 인수와 플래그는 gcloud 도구 명령어 출력에 영향을 미치지만 사용 사례에서는 약간의 차이가 있습니다. 위치 인수는 명령이 작동하는 개체를 정의하는 데 사용되고, 플래그는 명령어 동작의 변형을 설정할 때 필요합니다.

stdoutstderr 사용

성공한 gcloud 도구 명령어 출력은 stdout에 기록됩니다. 프롬프트, 경고, 오류 등 다른 모든 형태의 응답은 stderr에 기록됩니다. stderr에 기록된 응답은 불안정하므로 이러한 응답을 스크립트하지 마세요.

출력 처리에 대한 가이드라인은 스크립팅 가이드를 참조하세요.

메시지 표시

의도치 않은 파괴적인 작업으로부터 보호하기 위해 gcloud 도구는 gcloud projects delete와 같은 명령어를 실행하기 전에 사용자 의도를 확인합니다.

gcloud compute instances create test-instance를 사용하여 Compute Engine 가상 머신 인스턴스를 만드는 경우에도 메시지가 표시될 수 있습니다. 인스턴스를 만들 영역을 선택하라는 메시지가 나타납니다.

메시지가 표시되지 않게 하려면 --quiet 플래그를 사용합니다.

문구가 변경될 수 있으므로 메시지 표시 문구를 스크립트하지 마세요.

메시지 표시, 단말기에 쓰기, 로깅 해제

gcloud 도구--quiet 플래그(또는 -q)는 gcloud 도구 명령어를 실행할 때 모든 대화형 프롬프트를 중지하므로 스크립팅에 유용합니다. 입력이 필요하면 기본값이 사용됩니다. 기본값이 없으면 오류가 발생합니다.

터미널에서 명령어 결과를 표준 결과 및 표준 오류로 인쇄하지 않으려면 --no-user-output-enabled 플래그를 사용합니다.

로그의 세부정보 수준을 조정하려면 --verbosity 플래그를 사용하여 세부정보 수준(디버그, 정보, 경고, 오류, 심각 또는 없음)을 지정합니다.

출력 구조 결정

기본적으로 gcloud 도구 명령어에서 리소스 목록을 반환하면 리소스가 쉽게 읽을 수 있는 표준 출력으로 표시됩니다. 보다 의미 있는 출력을 생성하려면 format, filter, projection 플래그를 사용하여 출력을 미세 조정하면 됩니다.

출력 형식만 정의하려면 --format 플래그를 사용하여 출력의 테이블 형식이나 플랫 버전(대화형 디스플레이의 경우)을 또는 머신에서 읽을 수 있는 출력 버전(json, csv, yaml, value)을 생성합니다.

리소스 데이터 값을 선택하는 키 목록 형식을 지정하려면 projections를 사용합니다. 정의할 기준에 맞게 출력을 더욱 세부적으로 지정하려면 filter를 사용합니다.

필터 및 형식 기능에 익숙해지려면 Cloud Shell에서 열기를 클릭하여 빠른 대화형 튜토리얼을 완료하면 됩니다.

Cloud Shell에서 열기

다음 단계