구성요소란 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 작업을 실행하는 기존 도구입니다. 대신 gcloud storage 명령어를 사용하세요. |
|
core |
gcloud CLI 핵심 라이브러리 | gcloud CLI가 내부적으로 사용하는 라이브러리입니다. |
알파 및 베타 구성요소
gcloud CLI는 gcloud CLI 알파 및 베타 명령어를 포함하는 2개 구성요소를 제공합니다. 이러한 구성요소는 기본적으로 설치되지 않지만 초기 gcloud CLI 설치 후 언제든지 수동으로 설치할 수 있습니다. 이러한 구성요소는 다음과 같습니다.
| ID | 이름 | 설명 |
|---|---|---|
alpha |
gcloud CLI 알파 명령어 | 알파 출시 레벨에서의 gcloud CLI 명령어입니다. |
beta |
gcloud CLI 베타 명령어 | 베타 출시 레벨에서의 gcloud CLI 명령어입니다. |
정식 버전 출시 레벨에서의 gcloud CLI 명령어는 gcloud CLI 구성요소의 일부이며 gcloud CLI 설치 시 자동으로 설치됩니다.
사용할 수 있는 모든 추가 구성요소와 외부 패키지 관리자(기본적으로 설치되지 않음) 목록이 아래에 있습니다.
gcloud CLI 구성요소 관리
필요에 따라 gcloud CLI 구성요소를 나열, 설치, 업데이트, 삭제할 수 있습니다.
참고: APT 또는yum 같은 패키지 관리자를 사용하여 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 명령어 | 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
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 |