Gestionar componentes de la CLI de gcloud

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 la CLI de gcloud en las versiones alfa o beta, o un paquete que contenga dependencias usadas por una herramienta de la CLI de gcloud.

Los componentes más utilizados se instalan de forma 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 quieres instalarlo. Si respondes afirmativamente, se instalará el componente y, a continuación, se ejecutará el comando. Otros componentes se instalan a petición mediante la CLI de gcloud cuando ejecutas comandos que los requieren.

Componentes predeterminados

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

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 manualmente en cualquier momento después de la instalación inicial de la CLI de gcloud. Estos componentes son los siguientes:

Los comandos de la interfaz de línea de comandos de gcloud en la versión de disponibilidad general forman parte del componente de la interfaz de línea de comandos de gcloud y se instalan automáticamente al instalar la interfaz de línea de comandos de gcloud.

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

Gestionar componentes de la CLI de gcloud

Puedes enumerar, instalar, actualizar y quitar componentes de la CLI de gcloud para adaptarlos a tus necesidades.

Mostrar componentes

Para ver una lista de los componentes disponibles y actualmente instalados, 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 ejecuta gcloud components list.

Instalar 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]

gcloud CLI instala el componente especificado.

Por ejemplo, si quieres instalar el comando kubectl:

gcloud components install kubectl

Actualizar 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 que funcionaba correctamente y has instalado la CLI de gcloud directamente (fuera de un gestor de paquetes, incluido el 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

Eliminar componentes

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

gcloud components remove [COMPONENT-ID]

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

Componentes adicionales

La CLI de gcloud también incluye componentes adicionales que contienen dependencias para los comandos de 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.

Gestores de paquetes externos

Si has instalado la CLI de gcloud mediante los gestores de paquetes apt o yum, también puedes instalar componentes adicionales de la CLI de gcloud con esos mismos gestores de paquetes. Si tu gestor de paquetes no encuentra estos paquetes, consulta las guías sobre instalación con apt o instalación con yum para saber cómo configurar https://packages.cloud.google.com/ como fuente de paquetes.