Cómo administrar componentes del SDK

¿Qué son los componentes?

Los componentes son las partes instalables del SDK. Un componente puede ser una herramienta de línea de comandos (gcloud, bq y gsutil), un conjunto de comandos 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 manera interactiva y el componente alpha o beta no está instalado, gcloud te preguntará si quieres instalarlo. Si la respuesta es afirmativa, se instala el componente y luego se ejecuta el comando. gcloud instala otros componentes según demanda cuando ejecutas comandos que los necesitan.

Componentes predeterminados

Cuando instalas el SDK, se instalan los componentes a continuación de manera predeterminada:

ID Nombre Descripción
gcloud Comandos gcloud predeterminados Herramienta para la interacción con Google Cloud Platform. Con este componente, solo se instalan comandos que están en los niveles de actualización Disponibilidad general y Vista previa. Debes instalar por separado los comandos gcloud alpha o los componentes de comandos gcloud beta si quieres 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 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 gcloud Comandos de gcloud en el nivel de actualización Alfa.
beta Comandos Beta de gcloud Comandos de gcloud en el nivel de actualización Beta.

Los comandos de gcloud que están en los niveles de actualización Disponibilidad general y Vista previa forman parte del componente gcloud y se instalan automáticamente cuando instalas el SDK.

A continuación, hay disponible 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.

Cómo instalar 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]

gcloud instala el componente especificado.

Por ejemplo, si deseas instalar el comando kubectl:

gcloud components install kubectl

Cómo actualizar 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, gcloud actualiza todos los componentes instalados.

Si necesitas volver a una versión anterior conocida, que funcionaba correctamente, y también instalar el SDK directamente (fuera de un administrador de paquetes, que incluye el instalador interactivo, 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

Para 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 de yum.

Cómo quitar componentes

Usa el comando gcloud components remove para quitar componentes específicos según su ID:

gcloud components remove [COMPONENT-ID]

Puedes volver a instalar los componentes con el comando gcloud components install en cualquier momento.

Componentes adicionales

Los componentes adicionales que contienen dependencias para varios comandos gcloud también están disponibles en el SDK, pero no se instalan de manera predeterminada. Algunos de estos componentes son los siguientes (ejecuta $ lista de componentes gcloud para obtener una lista completa):

ID Nombre Descripción
app-engine-python Extensiones de aplicación Python de gcloud Paquetes del SDK de Google App Engine para Python. Se instalan cuando usas el comando gcloud app deploy para implementar un aplicación Python en App Engine.
app-engine-java Extensiones de aplicación Java de gcloud Paquetes del SDK de Google App Engine para Java. Se instalan cuando usas el comando gcloud app deploy para implementar una aplicación Java en App Engine.
app-engine-go Extensiones de aplicación Go de gcloud Paquetes del SDK de Google App Engine para Go. Se instalan cuando usas el comando gcloud app deploy para implementar una aplicación Go en App Engine.
gcd-emulator Emulador de Cloud Datastore Emulador para Google Cloud Datastore. Se instala cuando usas los comandos en el grupo de comandos gcloud beta emulators datastore.
pubsub-emulator Emulador de Cloud Pub/Sub Emulador para Google Cloud Pub/Sub. Se instala cuando usas los comandos en el grupo de comandos gcloud beta emulators pubsub.
cbt CLI de Cloud Bigtable Herramienta de línea de comandos de Google Cloud Bigtable
cloud-build-local Compilador local de Cloud Build Compilador local de Google Cloud Build
bigtable Emulador de Cloud Bigtable Emulador para Google Cloud Bigtable. Se instala cuando usas los comandos en el grupo de comandos gcloud beta emulators bigtable.
kubectl kubectl Herramienta de línea de comandos de Kubernetes. Cuando ejecutas comandos en el grupo de comandos gcloud container, se te solicita que instales este componente. kubectl no es necesario para crear clústeres de contenedor, pero se necesita para ejecutarlos.
docker-credential-gcr docker-credential-gcr Auxiliar de credenciales de Docker para Google Container Registry. Luego de la instalación, ejecuta docker-credential-gcr configure-docker para habilitar el auxiliar de credenciales. Para obtener más información, consulta el proyecto en GitHub.
datalab datalab Herramienta de línea de comandos de Cloud Datalab.
cloud-build-local Google Cloud Build Local Compilador local para Cloud Build. Luego de la instalación, puedes ejecutar compilaciones en tu máquina local. Para obtener más información, consulta Compilación y depuración local.

Administradores de paquetes externos

Si usaste un administrador de paquetes externos, como APT (mediante formato deb) o YUM, para instalar el SDK de Cloud, puedes instalar componentes adicionales por medio de la tabla a continuación.

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
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del SDK de Cloud