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.niveles de lanzamiento o un paquete que contenga dependencias usadas por una herramienta en la CLI de gcloud.
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 instalar eso. Si la respuesta es afirmativa, se instala el componente y, luego, se ejecuta el comando. La CLI de gcloud instala otros componentes a pedido 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 la CLI de gcloud, se instalan los siguientes componentes de forma 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
| 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 de la CLI de gcloud | Bibliotecas que usan internamente las herramientas de la CLI de gcloud. |
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 manera 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:
ID | Nombre | Descripción |
---|---|---|
alpha |
Comandos Alfa de la CLI de gcloud | Comandos de la CLI de gcloud a nivel de versión Alfa. |
beta |
Comandos Beta de la CLI de gcloud | Comandos de la CLI de gcloud a nivel de versión Beta |
Los comandos de la CLI de gcloud en el nivel de actualización de disponibilidad general son parte del componente de la CLI de gcloud y se instalan de forma automática cuando instalas la CLI de gcloud.
A continuación, aparece una lista de todos los componentes adicionales disponibles y los administradores de paquetes externos, que no están instalados de forma predeterminada.
Administra los componentes de la CLI de gcloud
Puedes enumerar, instalar, actualizar y quitar componentes de la CLI de gcloud para satisfacer 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 de la CLI de gcloud y ejecuta gcloud components list
.
Estado | Nombre del componente | ID | Tamaño |
---|---|---|---|
Instalado | Extensiones de Go para App Engine | app-engine-go | 97.7 MiB |
No instaladas | AppCtl | appctl | 21.0 MiB |
Instalado | Herramienta de línea de comandos de Cloud Bigtable | cbt | 4.0 MiB |
Instalado | Emulador de Cloud Bigtable | bigtable | 3.8 MiB |
Instalado | Herramienta de línea de comandos de Cloud Datalab | datalab | Menos de 1 MiB |
Instalado | Cloud Datastore Emulator | emulador de cloud-datastore | 17.8 MiB |
No instaladas | Cloud Datastore Emulator | cloud-firestore-emulador | 60.4 MiB |
Instalado | Emulador de Cloud Pub/Sub | emulador de pubsub | 33.2 MiB |
Instalado | Proxy de Cloud SQL | cloud-sql-proxy | 7.6 MiB |
Instalado | Emulador de Cloud Spanner | emulador de cloud-spanner | 21.8 MiB |
Instalado | Compilador local de Google Cloud Build | cloud-build-local | 4.4 MiB |
Instalado | Extensiones de Java de la app de gcloud | app-engine-java | 118.9 MiB |
Instalado | Extensiones de aplicación PHP de la aplicación de gcloud | app-engine-php | 21.9 MiB |
Instalado | Aplicaciones de gcloud para extensiones de Python (bibliotecas adicionales) | app-engine-python-extras | 27.8 MiB |
Instalado | kubectl | kubectl | 12.2 MiB |
Instalado | Herramienta de línea de comandos de Cloud BigQuery | bq | Menos de 1 MiB |
Instalado | Bibliotecas principales del SDK de Cloud | core | 7.2 MiB |
Instalado | Herramienta de línea de comandos de Cloud Storage | gsutil | 3.3 MiB |
Instalado | Comandos Alfa de gcloud | Alfa | Menos de 1 MiB |
Instalado | Comandos Beta de gcloud | Beta | Menos de 1 MiB |
Instalado | Extensiones de Python para la aplicación de gcloud | app-engine-python | 6.1 MiB |
Instala componentes
Para instalar un componente en la versión actual de la instalación de la CLI de gcloud, 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 de la CLI de gcloud:
gcloud components update
Si tienes instalada una versión anterior de la CLI de gcloud, la CLI de gcloud actualiza todos los componentes instalados.
Si necesitas volver a una versión anterior, que sea buena, y también instalaste la CLI de gcloud directamente (fuera de un administrador de paquetes, incluido el uso del instalador interactivo, las versiones estáticas, el instalador de Windows o Homebrew), usa el siguiente comando: gcloud components update
para volver a la versión especificada:
gcloud components update --version VERSION
Para cambiar a una versión inferior de la CLI de gcloud instalada con un administrador de paquetes, consulta estas instrucciones a fin de especificar versiones cuando realices descargas conapt-get
oyum
,
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 CLI de gcloud también están disponibles en la CLI de gcloud, pero no se instalan de forma predeterminada. Si quieres 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
.
Administradores de paquetes externos
Si instalaste la CLI de gcloud a través de los administradores de paquetes apt
o yum
, también puedes instalar componentes adicionales de la CLI de gcloud 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 de la CLI de gcloud | 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 |