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 herramienta 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 herramienta de gcloud te preguntará si deseas instalarlo. Si la respuesta es afirmativa, se instala el componente y, luego, se ejecuta el comando. La herramienta de gcloud instala otros componentes según demanda cuando ejecutas comandos que los requieren.
Pruébalo tú mismo
Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Comenzar gratisComponentes predeterminados
Cuando instalas el SDK, se instalan los componentes a continuación de manera predeterminada:
| ID | Nombre | Descripción |
|---|---|---|
gcloud |
Comandos de la herramienta de gcloud predeterminados |
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
| La herramienta de línea de comandos de BigQuery | Herramienta para trabajar con datos en BigQuery |
gsutil |
Herramienta de línea de comandos de Cloud Storage | Herramienta para ejecutar tareas relacionadas con Cloud Storage. |
core |
Bibliotecas principales del SDK de Cloud | Bibliotecas usadas internamente por las herramientas de Cloud SDK. |
Componentes Alfa y Beta
El SDK de Cloud proporciona dos componentes que contienen comandos Alfa y Beta de la herramienta de gcloud. Estos componentes no se instalan de manera predeterminada, pero puedes instalarlos manualmente en cualquier momento después de la instalación inicial del SDK de Cloud. Estos componentes son los siguientes:
| ID | Nombre | Descripción |
|---|---|---|
alpha |
Comandos Alfa de la herramienta de gcloud |
Comandos de la herramienta de gcloud en el nivel de actualización Alfa. |
beta |
Comandos Beta de la herramienta de gcloud |
Comandos de la herramienta de gcloud en el nivel de actualización Beta. |
Los comandos de la herramienta de gcloud a nivel de la disponibilidad general forman parte del componente de la herramienta de gcloud y se instalan de forma automática cuando instalas el SDK de Cloud.
A continuación, aparece una lista de componentes adicionales disponibles y de administradores de paquetes externos (no instalados de manera predeterminada).
Administración de los componentes del SDK de Cloud
Puedes enumerar, instalar, actualizar y quitar componentes del SDK de 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
El siguiente ejemplo no es una lista completa de todos los componentes disponibles. Para ver las ofertas de componentes más recientes, actualiza la instalación del SDK de Cloud y, luego, ejecuta gcloud components list.
┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Components │ ├───────────────┬─────────────────────────────────────────────────┬──────────────────────────┬───────────┤ │ Status │ Name │ ID │ Size │ ├───────────────┼─────────────────────────────────────────────────┼──────────────────────────┼───────────┤ │ Installed │ App Engine Go Extensions │ app-engine-go │ 97.7 MiB │ │ Not Installed │ AppCtl │ appctl │ 21.0 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 │ | Not Installed | Cloud Datastore Emulator | cloud-firestore-emulator | 60.4 MiB | │ Installed │ Cloud Pub/Sub Emulator │ pubsub-emulator │ 33.2 MiB │ │ Installed │ Cloud SQL Proxy │ cloud-sql-proxy │ 7.6 MiB │ │ Installed │ Cloud Spanner Emulator │ cloud-spanner-emulator │ 21.8 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 │ Cloud 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 │ └────────────────┴────────────────────────────────────────────────┴───────────────────────────┴───────────┘
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 herramienta 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 herramienta de gcloud actualiza todos los componentes instalados.
Si necesitas volver a una versión anterior, pero instalaste el SDK de Cloud 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 los comandos de la herramienta de gcloud también están disponibles en el SDK de Cloud, pero no se instalan de forma predeterminada. Para obtener una lista exhaustiva de los componentes, ejecuta $gcloudcomponents list.
Los componentes adicionales que se pueden instalar está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 |