Administra los componentes de la CLI de gcloud

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

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

Pruébalo tú mismo

Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Comenzar gratis

Componentes predeterminados

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

ID Nombre Descripción
gcloud Comandos predeterminados de la CLI de gcloud Herramienta para la interacción con Google Cloud. Con este componente, solo se instalan comandos que están en los niveles de actualización Disponibilidad general y Vista previa. Debes instalar los comandos gcloud alpha o los componentes del comando gcloud beta por separado si deseas 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 de línea de comandos de Cloud Storage Herramienta para ejecutar tareas relacionadas con Cloud Storage.
core Bibliotecas principales de la CLI de gcloud Bibliotecas usadas internamente por las herramientas de la CLI de gcloud.

Componentes Alfa y Beta

La CLI de gcloud proporciona dos componentes que contienen comandos Alfa y Beta de la CLI de gcloud. Estos componentes no se instalan de forma predeterminada, pero puedes instalarlos de forma manual en cualquier momento después de la instalación inicial de la CLI de gcloud. Estos componentes son los siguientes:

ID Nombre Descripción
alpha Comandos Alfa de la CLI de gcloud Comandos de la CLI de gcloud en el nivel de actualización Alfa.
beta Comandos beta de la CLI de gcloud Comandos de la CLI de gcloud en el nivel de actualización Beta.

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

A continuación, aparece una lista de todos los componentes adicionales disponibles y los administradores de paquetes externos que no están instalados de forma predeterminada.

Administra los componentes de la CLI de gcloud

Puedes enumerar, instalar, actualizar y quitar componentes de la CLI de gcloud según tus necesidades.

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

El siguiente ejemplo no es una lista completa de todos los componentes disponibles. Para ver las últimas ofertas de componentes, actualiza tu instalación de la CLI de gcloud y, luego, ejecuta gcloud components list.

Estado Nombre del componente ID Tamaño
Instalado Extensiones de Go en App Engine app-motor-ir 97.7 MiB
No instalada Ctrl kubectl 21.0 MiB
Instalado Herramienta de línea de comandos de Cloud Bigtable cbt 4.0 MiB
Instalado Emulador de Cloud Bigtable bigtable 3.8 MiB
Instalado Herramienta de línea de comandos de Cloud Datalab datalab Menos de 1 MiB
Instalado Emulador de Cloud Datastore cloud-datastore-emulator 17.8 MiB
No instalada Emulador de Cloud Datastore cloud-firestore-emulator 60.4 MiB
Instalado Emulador de Cloud Pub/Sub Emulador de pubsub 33.2 MiB
Instalado Proxy de Cloud SQL cloud-sql-proxy 7.6 MiB
Instalado Emulador de Cloud Spanner emulador de cloud-spanner 21.8 MiB
Instalado Compilador local de Google Cloud Build cloud-build-local 4.4 MiB
Instalado Extensiones de Java para la app de gcloud app-motor-java 118.9 MiB
Instalado Extensiones de PHP en la app de gcloud app-motor-php 21.9 MiB
Instalado Extensiones de Python de aplicaciones de gcloud (bibliotecas adicionales) app-motor-python-extras 27.8 MiB
Instalado kubectl kubectl 12.2 MiB
Instalado Herramienta de línea de comandos de Cloud BigQuery bq Menos de 1 MiB
Instalado Bibliotecas principales del SDK de Cloud core 7.2 MiB
Instalado Herramienta de línea de comandos de Cloud Storage gsutil 3.3 MiB
Instalado Comandos Alfa de gcloud Alfa Menos de 1 MiB
Instalado Comandos Beta de gcloud Beta Menos de 1 MiB
Instalado Extensiones de Python para aplicaciones de gcloud app-motor-python 6.1 MiB

Instala componentes

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

gcloud components install [COMPONENT-ID]

La CLI de gcloud 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 última versión disponible de la CLI de gcloud:

gcloud components update

Si tienes instalada una versión anterior de la CLI de gcloud, la CLI de gcloud actualizará todos los componentes instalados.

Si necesitas volver a una versión anterior conocida, pero instalaste la CLI de gcloud 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 una versión inferior de la CLI de gcloud instalada con un administrador de paquetes, consulta estas instrucciones a fin de especificar versiones cuando se descarga 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

Los componentes adicionales que contienen dependencias para los comandos de la CLI de gcloud también están disponibles en la CLI de gcloud, 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 están marcados con el estado Not Installed.

Administradores de paquetes externos

Si instalaste la CLI de gcloud a través de los administradores de paquetes apt o yum, también puedes instalar componentes adicionales de la CLI de gcloud 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 la CLI de gcloud 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
datalab google-cloud-cli-datalab google-cloud-cli-datalab
docker-credential-gcr Aún no está disponible. Aún no está disponible.
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