이 페이지에는 Google Cloud CLI와 일반적인 명령어 패턴 및 특징의 개요가 나와 있습니다.
gcloud CLI란 무엇인가요?
Google Cloud CLI는 Google Cloud 리소스를 만들고 관리하기 위한 도구 모음입니다. 이러한 도구를 사용하면 명령줄에서 또는 스크립트 및 기타 자동화를 통해 많은 일반적인 플랫폼 태스크를 수행할 수 있습니다.
gcloud CLI를 사용해 만들고 관리할 수 있는 항목의 예는 다음과 같습니다.
- Compute Engine 가상 머신 인스턴스 및 기타 리소스
- Cloud SQL 인스턴스
- Google Kubernetes Engine 클러스터
- Dataproc 클러스터 및 작업
- Cloud DNS 관리 영역 및 레코드 조합
- Cloud Deployment Manager 배포
gcloud CLI를 사용하여 App Engine 애플리케이션을 배포하고 인증을 관리하며 로컬 설정을 조정하며 기타 다른 작업을 수행할 수도 있습니다.
gcloud CLI 다운로드 및 설치
gcloud CLI의 현재 버전은 503.0.0입니다.
현재 버전의 gcloud CLI를 사용하는 것이 가장 좋지만 보관 파일 다운로드에서 이전 버전을 다운로드하여 설치할 수도 있습니다.
Cloud Shell을 사용하는 경우 gcloud CLI가 자동으로 제공되며 이를 설치할 필요가 없습니다. 그렇지 않으면 gcloud CLI를 다운로드 및 설치한 후 초기화합니다.
기본적으로 gcloud CLI는 일반 안정화 버전 단계에 있는 명령어를 설치합니다. 추가 기능은 alpha 및 beta라는 gcloud CLI 구성요소에서 사용할 수 있습니다. 해당 구성요소를 활용하면 gcloud CLI를 통해 Bigtable, Dataflow, 기타 Google Cloud 요소를 정식 버전 이전의 출시 버전 단계로 사용할 수 있습니다.
gcloud CLI 요약본
gcloud CLI, 일반적으로 사용되는 명령어 목록, 이러한 명령어가 구조화되는 방식에 대한 간단한 소개는 gcloud CLI 요약본을 참조하세요.
출시 레벨
gcloud CLI 명령어에는 다음과 같은 출시 레벨이 있습니다.
| 출시 레벨 | 라벨 | 설명 |
|---|---|---|
| 일반 안정화 버전 | 없음 | 명령어가 완전히 안정적이며 프로덕션 용도로 사용될 수 있습니다. 현재 기능을 손상시키는 명령어의 변경사항에 대한 사전 알림은 출시 노트를 참조하세요. |
| 베타 | beta |
명령어가 기능적으로 완전하지만 명령어에 아직 해결되지 않은 문제가 있을 수 있습니다. 이러한 명령어는 예고 없이 변경될 수 있습니다. |
| 알파 | alpha |
명령어가 초기 출시 상태이며 예고 없이 변경될 수 있습니다. |
gcloud CLI 설치 시 alpha 및 beta 구성요소는 기본적으로 설치되지 않습니다. gcloud components install 명령어를 사용하여 별도로 이러한 구성요소를 설치해야 합니다. alpha 또는 beta 명령어를 실행하려고 하지만 해당 구성요소가 설치되어 있지 않으면 gcloud CLI에서 이를 설치하라는 메시지를 표시합니다.
명령어 그룹
각 출시 레벨 내에서 gcloud CLI 명령어는 중첩된 명령어 그룹 계층으로 구성되며 각 명령어 그룹은 Google Cloud 또는 기능 하위 그룹의 제품이나 기능을 나타냅니다.
예를 들면 다음과 같습니다.
| 명령어 그룹 | 설명 |
|---|---|
gcloud compute |
정식 버전에서 Compute Engine과 관련된 명령어 |
gcloud compute instances |
정식 버전에서 Compute Engine 인스턴스와 관련된 명령어 |
gcloud beta compute |
베타에서 Compute Engine과 관련된 명령어 |
gcloud alpha app |
알파에서 App Engine 배포 관리와 관련된 명령어 |
gcloud CLI 명령어 실행
gcloud CLI 명령어는 명령줄에서는 물론 스크립트 및 기타 자동화에서도 실행할 수 있습니다. Jenkins를 사용하여 Google Cloud 태스크를 자동화하는 경우가 그 예시입니다.
속성
gcloud CLI 속성은 gcloud CLI 도구의 동작에 영향을 미치는 설정입니다. 이러한 속성 중 일부는 전역 또는 명령어 옵션으로 설정될 수 있습니다. 이 경우 옵션으로 설정된 값이 우선 적용됩니다.
접근성 기능 사용 설정
스크린 리더 환경을 더 간소화하기 위해 gcloud CLI는 accessibility/screen_reader 속성과 함께 제공됩니다.
접근성 속성을 사용 설정하려면 다음을 실행합니다.
gcloud config set accessibility/screen_reader true
gcloud 명령줄 도구와 함께 제공되는 접근성 기능에 대한 자세한 내용은 접근성 기능 사용 설정 가이드를 참조하세요.
구성
구성은 gcloud CLI 속성 모음입니다. 구성은 프로필과 같은 역할을 수행합니다.
gcloud CLI를 사용하기 시작하면 default라고 하는 단일 구성으로 작업하고 gcloud init 또는 gcloud config set를 실행하여 속성을 설정할 수 있습니다. 대부분의 경우에 이 단일 기본 구성이 적합합니다.
여러 프로젝트나 승인 계정에서 작업하려면 gcloud config configurations create로 여러 구성을 설정하고 구성 간에 전환할 수 있습니다. 구성 내에서 속성을 맞춤설정할 수 있습니다.
예를 들어 활성 구성 내에서 프로젝트를 설정하려면 project 속성을 사용합니다.
gcloud config set project <project-id>
이러한 개념에 대한 자세한 내용은 구성 가이드를 참조하세요.
전체 옵션
gcloud CLI는 호출 레벨에서 명령어 동작을 제어하는 gcloud CLI 옵션 집합을 제공합니다. 이 옵션은 gcloud CLI 속성에 설정된 값을 재정의합니다.
위치 인수 및 옵션
위치 인수와 옵션이 gcloud CLI 명령어 결과에 영향을 미치지만 사용 사례에서는 약간의 차이가 있습니다. 위치 인수는 명령어가 작동하는 항목을 정의하는 데 사용되고, 옵션은 명령어 동작의 변형을 설정할 때 필요합니다.
stdout 및 stderr 사용
gcloud CLI 명령어가 성공적으로 출력되면 stdout에 기록됩니다. 프롬프트, 경고, 오류 등 다른 모든 형태의 응답은 stderr에 기록됩니다. stderr에 기록된 응답은 불안정하므로 이러한 응답을 스크립트하지 마세요.
출력 처리에 대한 가이드라인은 스크립팅 가이드를 참조하세요.
메시지 표시
의도치 않은 파괴적인 작업으로부터 보호하기 위해 gcloud CLI는 gcloud projects delete와 같은 명령어를 실행하기 전에 사용자 의도를 확인합니다.
추가 정보가 필요하면 메시지가 표시될 수 있습니다.
예를 들어 gcloud compute instances create test-instance를 사용해서 Compute Engine 가상 머신을 만들면 영역을 선택하라는 메시지가 표시됩니다.
메시지가 표시되지 않도록 하려면 --quiet 옵션을 사용합니다.
문구가 변경될 수 있으므로 메시지 표시 문구를 스크립트하지 마세요.
메시지 표시, 단말기에 쓰기, 로깅 해제
gcloud CLI의 --quiet 옵션(또는 -q)은 gcloud CLI 명령어 실행 시 모든 대화형 메시지 표시를 중지하며, 스크립트 작성 시 유용합니다. 입력이 필요하면 기본값이 사용됩니다. 기본값이 없으면 오류가 발생합니다.
터미널에서 명령어 결과를 표준 출력 및 표준 오류로 인쇄하지 않으려면 --no-user-output-enabled 옵션을 사용합니다.
로그의 세부정보 수준을 조정하려면 --verbosity 옵션을 사용하여 세부정보 수준(디버그, 정보, 경고, 오류, 심각 또는 없음)을 지정합니다.
출력 구조 결정
기본적으로 gcloud CLI 명령어가 리소스 목록을 반환하면 리소스는 쉽게 읽을 수 있는 표준 출력으로 표시됩니다. 보다 의미 있는 출력을 생성하려면 format, filter, projection 옵션을 사용하여 출력을 미세 조정하면 됩니다.
출력 형식만 정의하려면 --format 옵션을 사용하여 출력의 테이블 형식이나 플랫 버전(대화형 디스플레이의 경우)을 또는 머신에서 읽을 수 있는 출력 버전(json, csv, yaml, value)을 생성합니다.
리소스 데이터 값을 선택하는 키 목록 형식을 지정하려면 projections를 사용합니다. 정의할 기준에 맞게 출력을 미세 조정하려면 filter를 사용합니다.
다음 단계
- gcloud CLI 참조에서 gcloud CLI 명령어 자세히 알아보기