Administra componentes del SDK

¿Qué son los componentes?

Los componentes son las partes del SDK que se pueden instalar. 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 usadas por una herramienta en el SDK.

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.

Componentes predeterminados

Cuando instalas el SDK, se instalan los componentes a continuación de manera 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 Herramienta de línea de comandos BigQuery. Herramienta para trabajar con datos en Google BigQuery
gsutil Herramienta de línea de comandos de Cloud Storage Herramienta para ejecutar tareas relacionadas con Google Cloud Storage.
core Bibliotecas principales del SDK de Cloud Bibliotecas usadas internamente por las herramientas del SDK.

Componentes Alfa y Beta

El SDK proporciona dos componentes que contienen comandos Alfa y Beta de la CLI de gcloud. Estos componentes no se instalan de manera predeterminada, pero los puedes instalar manualmente en cualquier momento luego de la instalación inicial del SDK. Estos componentes son los siguientes:

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

Los comandos de la CLI de gcloud en los niveles de actualización Disponibilidad general y Versión preliminar son parte del componente de la CLI de gcloud y se instalan automáticamente cuando se instala el SDK.

A continuación, aparece una lista de componentes adicionales disponibles y de administradores de paquetes externos (no instalados de manera predeterminada).

Cómo administrar los componentes del SDK de Cloud

Puedes enumerar, instalar, actualizar y quitar componentes del SDK de Google Cloud 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
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                          │
├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status    │                         Name                  │            ID            │    Size   │
├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
│ Installed     │ Cloud Datastore Emulator (Legacy)             │ gcd-emulator             │  38.1 MiB │
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ BigQuery Command Line Tool                    │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└───────────────┴───────────────────────────────────────────────┴──────────────────────────┴───────────┘

Ten en cuenta que el resultado que se muestra previamente no es una lista completa de todos los componentes disponibles. Para ver las últimas ofertas de componentes, actualiza tu instalación del SDK de Cloud y ejecuta gcloud components list.

Instala componentes

Para instalar un componente en la versión actual de la instalación del SDK de Cloud, 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 del SDK de Cloud:

gcloud components update

Si tienes instalada una versión anterior del SDK de Cloud, la CLI de gcloud actualiza todos los componentes instalados.

Si necesitas volver a una versión anterior, pero instalaste el SDK directamente (fuera de un administrador de paquetes, incluido mediante el instalador interactivo, las versiones estáticas, el instalador de Windows o Homebrew), puedes usar gcloud components update para volver a la versión especificada:

gcloud components update --version VERSION

Si deseas regresar a versiones anteriores del SDK de Cloud instalado a través de un administrador de paquetes, consulta estas instrucciones para especificar las versiones durante la descarga a través de 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 varios comandos de la CLI de gcloud también están disponibles en el SDK, pero no se instalan de forma predeterminada. Puedes ejecutar la lista de componentes de gcloud $ para obtener una lista completa de componentes. Los componentes adicionales que se pueden instalar estarán marcados con el estado Not Installed.

Administradores de paquetes externos

Si instalaste el SDK de Cloud a través de los administradores de paquetes apt o yum, también puedes instalar componentes adicionales del SDK de Cloud 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 del SDK de Cloud Paquete de APT Paquete de YUM
app-engine-go google-cloud-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr Aún no está disponible. Aún no está disponible.
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator