¿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 |