Administración de componentes de la CLI de gcloud

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 las versiones Alfa o Beta, o un paquete que contiene dependencias utilizadas por una herramienta de la CLI de gcloud.

Los componentes más utilizados se instalan de forma predeterminada. Si ejecuta un comando de gcloud alpha o gcloud beta de forma interactiva y el componente alpha o beta no está instalado, la CLI de gcloud le preguntará si desea instalarlo. Si responde afirmativamente, instalará el componente y ejecutará el comando. La CLI de gcloud instala otros componentes a petición cuando ejecuta comandos que los requieren.

Pruébelo usted mismo

Si eres nuevo en Google CloudCree una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los nuevos clientes también reciben $300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Empieza gratis

Componentes predeterminados

Al instalar la CLI de gcloud, los siguientes componentes se instalan de forma predeterminada:

IDENTIFICACIÓN Nombre Descripción
gcloud Comandos CLI de gcloud predeterminados Herramienta para interactuar con Google CloudCon este componente, solo se instalan los comandos de las versiones de Disponibilidad General y Vista Previa. Debe instalar por separado los componentes Comandos gcloud alpha y/o Comandos gcloud beta si desea usar comandos de otras versiones.
bq Herramienta de línea de comandos de BigQuery Herramienta para trabajar con datos en BigQuery
gsutil Herramienta heredada para realizar tareas de almacenamiento en la nube. Use los comandos gcloud storage .
core bibliotecas principales de la CLI de gcloud Bibliotecas utilizadas internamente por las herramientas CLI de gcloud.

Componentes alfa y beta

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

IDENTIFICACIÓN Nombre Descripción
alpha Comandos alfa de la CLI de gcloud Comandos CLI de gcloud en el nivel de versión alfa.
beta Comandos beta de la CLI de gcloud Comandos CLI de gcloud en el nivel de versión beta.

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

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

Administración de componentes de la CLI de gcloud

Puede enumerar, instalar, actualizar y eliminar componentes de gcloud CLI para adaptarlos a sus necesidades.

Nota: Estas instrucciones no funcionarán si instaló gcloud CLI con un gestor de paquetes como APT o yum ya que el gestor de componentes de gcloud CLI está deshabilitado al usar ese método de instalación. Utilice estos paquetes en su lugar.

Listado de componentes

Para ver una lista de componentes que están disponibles e instalados actualmente, ejecute gcloud components list :

gcloud components list

El siguiente ejemplo no es una lista completa de todos los componentes disponibles. Para ver los componentes más recientes, actualice la instalación de la CLI de gcloud y ejecute gcloud components list .

Estado Nombre del componente IDENTIFICACIÓN Tamaño
Instalado Extensiones Go de App Engine motor de aplicaciones go 97,7 MiB
No instalado Control de aplicación aplicación 21,0 MiB
Instalado Herramienta de línea de comandos de Cloud Bigtable terapia cognitivo conductual 4.0 MiB
Instalado Emulador de Bigtable en la nube mesa grande 3,8 MiB
Instalado Emulador de almacén de datos en la nube emulador de almacén de datos en la nube 17,8 MiB
No instalado Emulador de Cloud Firestore emulador de Cloud Firestore 60,4 MiB
Instalado Emulador de publicación y suscripción en la nube emulador de pubsub 33,2 MiB
Instalado Proxy de Cloud SQL proxy_sql_en_la_nube 7,6 MiB
Instalado Emulador de Cloud Spanner emulador de llave de nube 21,8 MiB
Instalado Constructor local de Google Cloud Build construcción en la nube local 4,4 MiB
Instalado Extensiones Java de la aplicación gcloud motor de aplicaciones java 118,9 MiB
Instalado Extensiones PHP de la aplicación gcloud motor de aplicaciones php 21,9 MiB
Instalado Extensiones de Python de la aplicación gcloud (bibliotecas adicionales) extras de Python para el motor de aplicaciones 27,8 MiB
Instalado kubectl kubectl 12,2 MiB
Instalado Herramienta de línea de comandos de Cloud BigQuery bq < 1 MiB
Instalado Bibliotecas principales del SDK de Cloud centro 7,2 MiB
Instalado Herramienta de línea de comandos de almacenamiento en la nube gsutil 3,3 MiB
Instalado Comandos de gcloud Alpha alfa < 1 MiB
Instalado Comandos beta de gcloud beta < 1 MiB
Instalado Extensiones de Python de la aplicación gcloud motor de aplicaciones Python 6,1 MiB

Instalación de componentes

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

gcloud components install [COMPONENT-ID]

La CLI de gcloud instala el componente especificado.

Por ejemplo, si desea instalar el comando kubectl :

gcloud components install kubectl

Actualización de componentes

Utilice el comando gcloud components update para actualizar todos los componentes instalados a la última versión disponible de gcloud CLI:

gcloud components update

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

Si necesita volver a una versión previamente conocida como buena e instaló directamente la CLI de gcloud (fuera de un administrador de paquetes, incluido el uso del instalador interactivo, versiones estáticas, instalador de Windows o Homebrew), use gcloud components update para volver a la versión especificada:

gcloud components update --version VERSION
Para degradar las versiones de gcloud CLI instaladas mediante un administrador de paquetes, consulte estas instrucciones para especificar versiones al descargar usando apt-get o yum .

Quitar componentes

Utilice el comando gcloud components remove para eliminar un componente específico por su ID:

gcloud components remove [COMPONENT-ID]

Puede reinstalar un componente utilizando 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 completa de componentes, ejecute gcloud components list . Los componentes adicionales que se pueden instalar están marcados con el estado ` Not Installed .

Gestores de paquetes externos

Si instaló la CLI de gcloud mediante los administradores de paquetes apt o yum , también puede instalar componentes adicionales de la CLI de gcloud con esos mismos administradores. Si su administrador de paquetes no encuentra estos paquetes, consulte las guías de instalación con apt o con yum para aprender a configurar https://packages.cloud.google.com/ como origen de paquetes.

componente CLI de gcloud Paquete APT Paquete 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 Aún no disponible. Aún no 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