Administra los componentes de gcloud CLI

Los componentes son las partes instalables de Google Cloud CLI. Un componente puede ser una herramienta de línea de comandos (gcloud, bq y gsutil), un conjunto de comandos de gcloud CLI en los niveles de versión Alfa, Beta o Versión preliminar, o un paquete que contenga dependencias que use una herramienta en gcloud CLI.

Los componentes más usados se instalan de manera predeterminada. Si ejecutas un comando gcloud alpha, gcloud beta o gcloud preview de forma interactiva y el componente alpha, beta o preview no está instalado, gcloud CLI te preguntará si deseas instalarlo. Si la respuesta es afirmativa, se instala el componente y, luego, se ejecuta el comando. La gcloud CLI instala otros componentes a pedido cuando ejecutas comandos que los requieren.

Componentes predeterminados

Cuando instalas gcloud CLI, se instalan los siguientes componentes de forma predeterminada:

ID Nombre Descripción
gcloud Comandos predeterminados de gcloud CLI Es una herramienta para interactuar con Google Cloud. Con este componente, solo se instalan comandos que están en el nivel de versión de disponibilidad general. Debes instalar por separado los componentes de comandos de gcloud alpha, gcloud beta o gcloud preview si quieres usar comandos en otros niveles de actualización.
bq La herramienta de línea de comandos de BigQuery Herramienta para trabajar con datos en BigQuery
gsutil Herramienta heredada para realizar tareas de Cloud Storage. En su lugar, usa los comandos de gcloud storage.
core Bibliotecas principales de gcloud CLI Son bibliotecas que las herramientas de gcloud CLI usan de forma interna.

Componentes alfa, beta y de versión preliminar

gcloud CLI proporciona componentes que contienen comandos alfa, beta y de versión preliminar de gcloud CLI. Estos componentes no se instalan de forma predeterminada, pero puedes instalarlos manualmente en cualquier momento después de la instalación inicial de gcloud CLI. Estos componentes son los siguientes:

ID Nombre Descripción
alpha Comandos alfa de gcloud CLI Comandos de gcloud CLI en el nivel de versión alfa.
beta Comandos beta de gcloud CLI Comandos de gcloud CLI en el nivel de versión beta.
preview Comandos de versión preliminar de gcloud CLI Comandos de gcloud CLI en el nivel de versión preliminar.

Los comandos de gcloud CLI en el nivel de versión de disponibilidad general forman parte del componente de gcloud CLI y se instalan automáticamente cuando instalas gcloud CLI.

A continuación, se muestra una lista de todos los componentes adicionales y administradores de paquetes externos disponibles, que no se instalan de forma predeterminada.

Administra los componentes de gcloud CLI

Puedes enumerar, instalar, actualizar y quitar componentes de gcloud CLI para satisfacer tus necesidades.

Nota: Estas instrucciones no funcionarán si instalaste gcloud CLI con un administrador de paquetes, como APT o yum, porque el administrador de componentes de gcloud CLI se inhabilita cuando se usa ese método de instalación. En su lugar, usa estos paquetes.

Lista de componentes

Para ver una lista de los componentes que están disponibles y también instalados actualmente, ejecuta gcloud components list:

gcloud components list

La siguiente muestra no es una lista completa de todos los componentes disponibles. Para ver las ofertas de componentes más recientes, actualiza la instalación de gcloud CLI y, luego, ejecuta gcloud components list.

Estado Nombre del componente ID Tamaño
Instalada Extensiones de Go para App Engine app-engine-go 97.7 MiB
Instalada Herramienta de línea de comandos de Cloud Bigtable cbt 4.0 MiB
Instalada Emulador de Cloud Bigtable bigtable 3.8 MiB
Instalada Emulador de Cloud Datastore cloud-datastore-emulator 17.8 MiB
No instalada Emulador de Cloud Firestore cloud-firestore-emulator 60.4 MiB
Instalada Emulador de Cloud Pub/Sub pubsub-emulator 33.2 MiB
Instalada Emulador de Cloud Spanner cloud-spanner-emulator 21.8 MiB
Instalada Compilador local de Google Cloud Build cloud-build-local 4.4 MiB
Instalada Extensiones de Java para gcloud app app-engine-java 118.9 MiB
Instalada Extensiones de PHP de gcloud app app-engine-php 21.9 MiB
Instalada Extensiones de Python para gcloud app (bibliotecas adicionales) app-engine-python-extras 27.8 MiB
Instalada kubectl kubectl 12.2 MiB
Instalada Herramienta de línea de comandos de Cloud BigQuery bq Menos de 1 MiB
Instalada Bibliotecas principales del SDK de Cloud core 7.2 MiB
Instalada Herramienta de línea de comandos de Cloud Storage gsutil 3.3 MiB
Instalada Comandos Alfa de gcloud Alfa Menos de 1 MiB
Instalada Comandos Beta de gcloud beta Menos de 1 MiB
No instalada Comandos de gcloud en versión preliminar versión preliminar Menos de 1 MiB
Instalada Extensiones de Python para gcloud app app-engine-python 6.1 MiB

Instala componentes

Para instalar un componente en la versión actual de tu instalación de gcloud CLI, ejecuta gcloud components install:

gcloud components install [COMPONENT-ID]

La gcloud CLI instala el componente especificado.

Por ejemplo, si deseas instalar el comando kubectl:

gcloud components install kubectl

Actualiza componentes

Usa el comando gcloud components update para actualizar todos los componentes instalados a la versión más reciente disponible de gcloud CLI:

gcloud components update

Si tienes instalada una versión anterior de gcloud CLI, esta actualiza todos los componentes instalados.

Si necesitas volver a una versión correcta conocida y, además, instalaste gcloud CLI directamente (fuera de un administrador de paquetes, incluido el uso del instalador interactivo, las versiones estáticas, el instalador de Windows o Homebrew), usa gcloud components update para volver a la versión especificada:

gcloud components update --version VERSION
Para cambiar a versiones anteriores de gcloud CLI instaladas con un administrador de paquetes, consulta estas instrucciones para especificar versiones cuando descargues con apt-get o yum.

Quita componentes

Usa el comando gcloud components remove para quitar un componente especificado por su ID:

gcloud components remove [COMPONENT-ID]

Puedes volver a instalar un componente con el comando gcloud components install en cualquier momento.

Componentes adicionales

En gcloud CLI, también hay disponibles componentes adicionales que contienen dependencias para los comandos de gcloud CLI, pero no se instalan de forma predeterminada. Para obtener una lista exhaustiva de los componentes, ejecuta gcloud components list. Los componentes adicionales que se pueden instalar se marcan con el estado Not Installed.

Administradores de paquetes externos

Si instalaste gcloud CLI con los administradores de paquetes apt o yum, también puedes instalar componentes adicionales de gcloud CLI con esos mismos administradores de paquetes. Si tu administrador de paquetes no puede encontrar estos paquetes, lee las guías sobre instalación con apt o instalación con yum para aprender a configurar https://packages.cloud.google.com/ como una fuente de paquetes.

Componente de gcloud CLI Paquete de APT Paquete de 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 google-cloud-cli-docker-credential-gcr google-cloud-cli-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