Esta página contiene una descripción general de Google Cloud CLI y sus patrones de comando y capacidades comunes.
¿Qué es gcloud CLI?
Google Cloud CLI es un conjunto de herramientas para crear y administrar recursos de Google Cloud. Puedes usar estas herramientas para realizar muchas tareas comunes tareas de la plataforma desde la línea de comandos o mediante secuencias de comandos y otras automatizaciones.
Por ejemplo, puedes usar gcloud CLI para crear y administrar los siguientes elementos:
- Instancias de máquina virtual de Google Compute Engine y otros recursos
- Instancias de Cloud SQL
- Clústeres de Google Kubernetes Engine
- Clústeres y trabajos de Dataproc
- Zonas administradas y conjuntos de registros de Cloud DNS
- Implementaciones de Cloud Deployment Manager
También puedes usar gcloud CLI para implementar App Engine aplicaciones, administrar la autenticación, personalizar la configuración local y realizar otras tareas.
Descarga e instala gcloud CLI
La versión actual de gcloud CLI es 484.0.0.
Si bien te recomendamos que uses la versión actual de con gcloud CLI, también puedes descargar e instalar versiones anteriores en el archivo de descargas.
Si usas Cloud Shell, gcloud CLI está disponible automáticamente y no tendrás que instalarlo. De lo contrario, descarga e instala gcloud CLI y, luego, inicializarlo.
De forma predeterminada, gcloud CLI instala
que están en el nivel de disponibilidad general. La funcionalidad adicional es
disponible en gcloud CLI
componentes llamados alpha y beta. Estos componentes
te permiten usar gcloud CLI para trabajar con Bigtable,
Dataflow y otras partes de Google Cloud de versiones anteriores
que la Disponibilidad general.
Hoja de referencia de gcloud CLI
Para una introducción rápida a gcloud CLI, una lista de las instancias que usaste y para ver cómo se estructuran, consulta la Hoja de referencia de gcloud CLI.
Niveles de actualización
Los comandos de la CLI de gcloud tienen los siguientes niveles de actualización:
| Nivel de actualización | Etiqueta | Descripción |
|---|---|---|
| Disponibilidad general | Ninguna | Los comandos se consideran totalmente estables y disponibles para su uso en producción. Para avisos anticipados de cambios en comandos que interrumpen la corriente en la nube, consulta la notas de la versión. |
| Beta | beta |
Los comandos están completos en cuanto a funcionalidad, pero aún podrían tener algunos problemas. Se pueden realizar cambios rotundos en estos comandos sin previo aviso. |
| Alfa | alpha |
Los comandos están en su actualización temprana y pueden cambiar sin aviso. |
Los componentes alpha y beta no se instalan de forma predeterminada cuando lo instalas.
con gcloud CLI. Debes instalar estos componentes por separado con el comando gcloud components install. Si intentas ejecutar un
comando Alfa o Beta, y el componente correspondiente no está instalado,
gcloud CLI te solicitará que lo instales.
Grupos de comandos
Dentro de cada nivel de actualización, los comandos de gcloud CLI se organizan jerarquía anidada de grupos de comandos, cada uno de los cuales representa un producto o de Google Cloud o sus subgrupos funcionales.
Por ejemplo:
| Grupo de comandos | Descripción |
|---|---|
gcloud compute |
Comandos relacionados con Compute Engine disponibles de forma general |
gcloud compute instances |
Comandos relacionados con instancias de Compute Engine disponibles de forma general |
gcloud beta compute |
Comandos relacionados con Compute Engine en Beta |
gcloud alpha app |
Comandos relacionados con la administración de implementaciones de App Engine en Alfa |
Ejecuta los comandos de la CLI de gcloud
Puedes ejecutar comandos de gcloud CLI desde la línea de comandos y de secuencias de comandos y otras automatizaciones ejemplo, cuando se usa Jenkins para automatizar tareas de Google Cloud.
Propiedades
Las propiedades de la CLI de gcloud son parámetros de configuración que afectará el comportamiento de gcloud CLI con herramientas de visualización. Algunas de estas propiedades se pueden configurar mediante reglas o de comandos, en cuyo caso, prevalecerá el valor establecido por la opción.
Habilita las funciones de accesibilidad
Para una experiencia de lector de pantalla más optimizada, gcloud CLI
incluye una propiedad accessibility/screen_reader.
Para habilitar la propiedad de accesibilidad, ejecuta el siguiente comando:
gcloud config set accessibility/screen_reader true
Para obtener más detalles sobre las funciones de accesibilidad que vienen con la API de de herramienta de línea de comandos, consulta la Cómo habilitar las funciones de accesibilidad .
Configuraciones
Una configuración es un conjunto de propiedades de gcloud CLI. R actual funciona como un perfil.
Cuando comiences a usar gcloud CLI, trabajarás con un solo
de Terraform llamada default y puedes establecer propiedades ejecutando
gcloud init o gcloud config set. Esta única configuración predeterminada es adecuada para la mayoría de los casos prácticos.
Para trabajar con varios proyectos o cuentas de autorización, puedes configurar
varias configuraciones con gcloud config configurations create y switch
entre los parámetros de configuración. En una configuración, puedes personalizar las propiedades.
Por ejemplo, para configurar tu proyecto dentro de una configuración activa
Usa la propiedad project:
gcloud config set project <project-id>
Para obtener una cuenta detallada de estos conceptos, consulta la guía de configuración.
Opciones globales
Gcloud CLI proporciona un conjunto de Opciones de CLI de gcloud que rigen el comportamiento de los comandos en un nivel por invocación. Anulación de opciones establecidos en las propiedades de gcloud CLI.
Opciones y argumentos posicionales
Mientras que las opciones y los argumentos posicionales afectan la salida de un comando de gcloud CLI, existe una diferencia sutil en su uso diferentes. Se usa un argumento posicional para definir una entidad en la que un comando mientras que se requiere una opción para establecer una variación en el comportamiento de un comando.
Uso de stdout y stderr
El resultado de los comandos exitosos de gcloud CLI se escribe en
stdout. Todos los demás tipos de respuesta (mensajes, advertencias y errores) se
escrito en stderr. No uses la secuencia de comandos en función de las respuestas escritas en stderr porque
estas respuestas no son estables.
Para conocer los lineamientos sobre el manejo de resultados, consulta el Guía de escritura de secuencias de comandos.
Mensajes
Para brindar protección contra acciones destructivas no deseadas, gcloud CLI
confirma tus intenciones antes de ejecutar comandos como
gcloud projects delete.
Es posible que se te solicite cuando se necesite información adicional.
Por ejemplo, se te pedirá que elijas una zona cuando crees una Compute Engine
virtual de Compute Engine con gcloud compute instances create test-instance.
Para inhabilitar los mensajes, usa la opción --quiet.
No uses la secuencia de comandos contra la redacción de los mensajes, ya que puede cambiar.
Elimina mensajes, escribe a la terminal y haz registros
La opción --quiet (también, -q) para el
CLI de gcloud
Inhabilita todos los mensajes interactivos cuando se ejecutan comandos de gcloud CLI.
y es útil para crear secuencias de comandos. Si se necesita una entrada, se usan los valores predeterminados. Si
no es un valor predeterminado, se genera un error.
Para eliminar la impresión del resultado del comando como resultado estándar y error estándar en
la terminal, usa la opción --no-user-output-enabled.
Para ajustar la verbosidad de los registros, especifica un nivel de verbosidad (depuración, información, advertencia,
error, crítico o ninguno) con la
Opción --verbosity.
Determina la estructura del resultado
De forma predeterminada, cuando un comando de gcloud CLI devuelve una lista de recursos,
los recursos están impresos en formato de salida estándar. Para producir resultados más significativos
de salida, las opciones format, filter y projection te permiten ajustar
tu archivo de salida.
Para definir solamente el formato de tu salida, usa la
Opción --format para producir una tabla tabular
o una versión plana del resultado (para visualización interactiva)
una versión del resultado legible por máquina (json, csv, yaml, value)
Para dar formato a una lista de claves que seleccionan valores de datos de recursos, usa projections. Para definir aún mejor los resultados según criterios que deseas especificar, usa filter.
Para familiarizarte con la funcionalidad de filtro y formato, puedes completar un rápido instructivo interactivo haciendo clic en Abrir en Cloud Shell.
¿Qué sigue?
- Obtén más información sobre los comandos de gcloud CLI en la Referencia de la CLI de gcloud