gcloud CLI 구성요소 관리

구성요소란 Google Cloud CLI 중 설치 가능한 부분입니다. 구성요소는 명령줄 도구(gcloud, bq, gsutil), 알파 또는 베타 출시 단계의 gcloud CLI 명령어 집합 또는 gcloud CLI의 도구가 사용하는 종속 항목을 포함하는 패키지일 수 있습니다.

가장 일반적으로 사용되는 구성요소는 기본적으로 설치됩니다. gcloud alpha 또는 gcloud beta 명령어를 대화형으로 실행하고 alpha 또는 beta 구성요소가 설치되지 않은 경우, gcloud CLI는 구성요소를 설치할지 여부를 묻습니다. 여기에 '예'로 답하면 구성요소가 설치된 후 명령어가 실행됩니다. 다른 구성요소가 필요한 명령어를 실행하면 gcloud CLI에 의해 이러한 구성요소가 필요에 따라 설치됩니다.

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

무료로 시작하기

기본 구성요소

gcloud CLI를 설치하면 다음 구성요소가 기본적으로 설치됩니다.

ID 이름 설명
gcloud 기본 gcloud CLI 명령어 Google Cloud와 상호작용하기 위한 도구입니다. 정식 버전 및 미리보기 출시 레벨의 명령어만 이 구성요소와 함께 설치됩니다. 다른 출시 레벨에서 명령어를 사용하려면 gcloud alpha 명령어 구성요소와 gcloud beta 명령어 구성요소를 따로 설치해야 합니다.
bq BigQuery 명령줄 도구 BigQuery의 데이터를 처리하기 위한 도구입니다.
gsutil Cloud Storage 명령줄 도구 Cloud Storage와 관련된 작업을 수행하기 위한 도구입니다.
core gcloud CLI 코어 라이브러리 gcloud CLI가 내부적으로 사용하는 라이브러리입니다.

알파 및 베타 구성요소

gcloud CLI는 gcloud CLI 알파 및 베타 명령어를 포함한 두 개의 구성요소를 제공합니다. 이러한 구성요소는 기본적으로 설치되지 않지만 초기 gcloud CLI 설치 후 언제든지 수동으로 설치할 수 있습니다. 이러한 구성요소는 다음과 같습니다.

ID 이름 설명
alpha gcloud CLI 알파 명령어 알파 출시 레벨에서의 gcloud CLI 명령어입니다.
beta gcloud CLI 베타 명령어 베타 출시 레벨에서의 gcloud CLI 명령어입니다.

정식 버전 출시 레벨에서의 gcloud CLI 명령어는 gcloud CLI 구성요소의 일부이며 gcloud CLI 설치 시 자동으로 설치됩니다.

사용할 수 있는 모든 추가 구성요소외부 패키지 관리자(기본적으로 설치되지 않음) 목록이 아래에 있습니다.

gcloud CLI 구성요소 관리

필요에 따라 gcloud CLI 구성요소를 나열, 설치, 업데이트, 삭제할 수 있습니다.

구성요소 나열

현재 설치된 사용 가능한 구성요소 목록을 보려면 gcloud components list를 실행합니다.

gcloud components list

다음 샘플은 사용 가능한 모든 구성요소의 전체 목록이 아닙니다. 제공되는 최신 구성요소를 확인하려면 gcloud CLI 설치를 업데이트하고 gcloud components list를 실행합니다.

상태 구성요소 이름 ID 크기
설치됨 App Engine Go 확장 프로그램 app-engine-go 97.7MiB
설치되지 않음 AppCtl appctl 21.0MiB
설치됨 Cloud Bigtable 명령줄 도구 cbt 4.0MiB
설치됨 Cloud Bigtable 에뮬레이터 bigtable 3.8MiB
설치됨 Cloud Datastore 에뮬레이터 cloud-datastore-emulator 17.8MiB
설치되지 않음 Cloud Firestore 에뮬레이터 cloud-firestore-emulator 60.4MiB
설치됨 Cloud Pub/Sub 에뮬레이터 pubsub-emulator 33.2MiB
설치됨 Cloud SQL 프록시 cloud_sql_proxy 7.6MiB
설치됨 Cloud Spanner 에뮬레이터 cloud-spanner-emulator 21.8MiB
설치됨 Google Cloud Build 로컬 빌더 cloud-build-local 4.4MiB
설치됨 gcloud 앱 자바 확장 프로그램 app-engine-java 118.9MiB
설치됨 gcloud 앱 PHP 확장 프로그램 app-engine-php 21.9MiB
설치됨 gcloud 앱 Python 확장 프로그램(Extra Libraries) app-engine-python-extras 27.8MiB
설치됨 kubectl kubectl 12.2MiB
설치됨 Cloud BigQuery 명령줄 도구 bq 1MiB 미만
설치됨 Cloud SDK 핵심 라이브러리 core 7.2MiB
설치됨 Cloud Storage 명령줄 도구 gsutil 3.3MiB
설치됨 gcloud Alpha 명령어 알파 1MiB 미만
설치됨 gcloud 베타 명령어 베타 1MiB 미만
설치됨 gcloud 앱 Python 확장 프로그램 app-engine-python 6.1MiB

구성요소 설치

현재 gcloud CLI 설치 버전에서 구성요소를 설치하려면 gcloud components install을 실행합니다.

gcloud components install [COMPONENT-ID]

gcloud CLI는 지정된 구성요소를 설치합니다.

예를 들어 kubectl 명령어를 설치하려는 경우 다음과 같이 실행합니다.

gcloud components install kubectl

구성요소 업데이트

gcloud components update 명령어를 사용하여 설치된 모든 구성요소를 사용 가능한 최신 gcloud CLI 버전으로 업데이트합니다.

gcloud components update

이전 버전의 gcloud CLI가 설치되어 있는 경우 gcloud CLI가 설치된 모든 구성요소를 업데이트합니다.

이전에 알려진 올바른 버전으로 되돌려야 하고, 대화형 설치 프로그램, 정적 버전, Windows 설치 프로그램 또는 Homebrew 등을 통해 패키지 관리자 외부에 gcloud CLI를 직접 설치한 경우, gcloud components update를 사용하여 지정된 버전으로 되돌릴 수 있습니다.

gcloud components update --version VERSION

패키지 관리자를 통해 설치된 gcloud CLI 버전을 다운그레이드하려면 apt-get 또는 yum을 통해 다운로드 시 버전 지정 안내를 참조하세요.

구성요소 삭제

gcloud components remove 명령어를 사용하여 ID로 지정된 구성요소를 삭제합니다.

gcloud components remove [COMPONENT-ID]

gcloud components install 명령어를 사용하면 언제든지 구성요소를 다시 설치할 수 있습니다.

추가 구성요소

gcloud CLI 명령어의 종속 항목을 포함하는 추가 구성요소도 gcloud CLI에서 사용할 수 있지만 기본적으로 설치되지는 않습니다. 전체 구성요소 목록을 보려면 gcloud components list를 실행하세요. 설치할 수 있는 추가 구성요소는 Not Installed 상태로 표시됩니다.

외부 패키지 관리자

apt 또는 yum 패키지 관리자를 통해 gcloud CLI를 설치한 경우, 동일한 패키지 관리자를 사용하여 추가 gcloud CLI 구성요소도 설치할 수 있습니다. 패키지 관리자가 이러한 패키지를 찾지 못하는 경우, apt를 사용하여 설치 또는 yum을 사용하여 설치 가이드에서 https://packages.cloud.google.com/을 패키지 소스로 구성하는 방법을 읽어 보세요.

gcloud CLI 구성요소 APT 패키지 YUM 패키지
app-engine-go google-cloud-cli-app-engine-go google-cloud-cli-app-engine-go
app-engine-java google-cloud-cli-app-engine-java google-cloud-cli-app-engine-java
app-engine-python google-cloud-cli-app-engine-python google-cloud-cli-app-engine-python
bigtable google-cloud-cli-bigtable-emulator google-cloud-cli-bigtable-emulator
cbt google-cloud-cli-cbt google-cloud-cli-cbt
cloud-build-local google-cloud-cli-cloud-build-local google-cloud-cli-cloud-build-local
docker-credential-gcr 아직 사용할 수 없음 아직 사용할 수 없음
gcd-emulator google-cloud-cli-datastore-emulator google-cloud-cli-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-pubsub-emulator