gcloud 명령줄 도구 개요

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

gcloud 명령줄 도구란 무엇인가요?

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

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

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

gcloud CLI를 사용하여 App Engine 애플리케이션을 배포하고 인증을 관리하며 로컬 설정을 조정하며 기타 다른 작업을 수행할 수도 있습니다. gcloud CLI 참조를 살펴보고 이 도구의 기능에 대해 자세히 알아보세요.

gcloud 명령줄 도구 요약본

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

gcloud CLI 및 Cloud SDK

gcloud CLI는 Google Cloud SDK의 일부입니다. 시스템에 SDK를 다운로드 및 설치하고 초기화한 후에 gcloud 명령줄 도구를 사용할 수 있습니다.

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

gcloud CLI 출시 버전 번호는 SDK와 동일합니다. 현재 SDK 버전은 280.0.0입니다. 이전 버전 SDK는 다운로드 보관 파일에서 다운로드 및 설치할 수 있습니다.

gcloud 명령줄 도구 다운로드

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

출시 레벨

gcloud CLI 명령어에는 다음과 같은 출시 레벨이 있습니다.

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

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

명령어 그룹

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

예:

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

gcloud CLI 명령어 실행

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

속성

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

여기에서 사용할 수 있는 속성 목록을 찾을 수 있습니다.

접근성 기능 사용 설정

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

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

gcloud config set accessibility/screen_reader true

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

구성

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

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

여러 프로젝트 또는 승인 계정을 사용하려면 gcloud config configurations create로 여러 구성을 설정하고 구성 간에 전환 할 수 있습니다. 이러한 구성 내에서 속성을 맞춤 설정할 수 있습니다. 예를 들어, 활성 구성 내에서 프로젝트를 설정하려면 project 속성 gcloud config set project <project-id>를 사용하세요.

이러한 개념의 계정에 대한 자세한 내용은 구성관리의 탐색을 참조하세요.

전역 플래그

gcloud CLI는 사전 호출 레벨에 따른 명령어 동작을 제어하는 gcloud CLI 전역 플래그 집합을 제공합니다. 플래그는 SDK 속성에서 설정된 모든 값을 재정의합니다.

위치 인수 및 플래그

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

stdout 및 stderr 사용

gcloud CLI 명령어가 성공적으로 출력되면 stdout에 기록됩니다. 프롬프트, 경고, 오류 등 다른 모든 형태의 응답은 stderr에 기록됩니다. stderr에 기록된 모든 내용은 안정적이지 않으므로 이에 대한 스크립트를 작성하지 않아야 합니다.

출력 처리에 대한 가이드라인 정의 목록은 이 섹션을 참조하세요.

메시지 표시

의도치 않은 파괴적인 작업을 방지하기 위해 gcloud CLI는 gcloud projects delete와 같은 명령어를 실행하기 전에 사용자의 의도를 확인합니다.

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

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

메시지 표시의 문구는 변경될 수 있으므로 이에 대한 스크립트를 작성하지 않아야 합니다.

메시지 표시 안 함, 터미널에 쓰기, 로깅

gcloud CLI의 --quiet 플래그(또는 -q)는 gcloud CLI 명령어 실행 시 모든 대화형 메시지 표시를 중지하며, 스크립트 작성 시 유용합니다. 입력이 필요한 경우에는 기본값이 사용됩니다. 기본값이 없으면 오류가 발생합니다.

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

대신 로그의 상세 수준을 조정하려면 --verbosity 플래그를 사용하여 적절한 수준(디버그, 정보, 경고, 오류, 위험 또는 없음)을 정의하세요.

출력 구조 결정

기본적으로 gcloud CLI 명령어가 리소스 목록을 반환하면 쉽게 읽을 수 있는 표준 출력으로 표시됩니다. 보다 의미 있는 출력을 생성하려면 형식, 필터, 프로젝션 플래그를 사용하여 출력을 미세 조정할 수 있습니다.

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

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

필터 및 형식 기능에 익숙해지는 데 도움이 되는 빠른 대화식 가이드를 살펴보려면 아래 링크를 클릭하세요.

Cloud Shell에서 열기

다음 단계