Esta página contiene una descripción general de Google Cloud CLI y sus patrones y capacidades de comando 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 de la plataforma desde la línea de comandos o a través de secuencias de comandos y otras automatizaciones.
Por ejemplo, puedes usar gcloud CLI para crear y administrar lo siguiente:
- Instancias de máquina virtual de Google Compute Engine y otros recursos
- Instancias de Cloud SQL
- Clústeres de Google Kubernetes Engine
- Trabajos y clústeres de Dataproc
- Zonas administradas y conjuntos de registros de Cloud DNS
- Implementaciones de Cloud Deployment Manager
También puedes usar gcloud CLI para implementar aplicaciones de App Engine, administrar la autenticación, personalizar la configuración local y realizar otras tareas.
Descarga y, luego, instala gcloud CLI
La versión actual de gcloud CLI es 502.0.0.
Aunque te recomendamos que uses la versión actual de gcloud CLI, también puedes descargar e instalar versiones anteriores desde el archivo de descarga.
Si usas Cloud Shell, gcloud CLI está disponible automáticamente y no es necesario que la instales. De lo contrario, descarga e instala la CLI de gcloud y, luego, inicialízala.
De forma predeterminada, gcloud CLI instala los comandos que están en el nivel de Disponibilidad general. Hay funciones adicionales disponibles en los componentes de gcloud CLI llamados alpha y beta. Estos componentes te permiten usar gcloud CLI para trabajar con Bigtable, Dataflow y otras partes de Google Cloud en niveles de versiones anteriores a la Disponibilidad general.
La hoja de referencia de gcloud CLI
Para obtener una introducción rápida a gcloud CLI, una lista de los comandos más utilizados y ver cómo están estructurados estos comandos, consulta la hoja de referencia de la CLI de gcloud.
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 obtener un aviso anticipado de los cambios en los comandos que generan errores en la funcionalidad actual, consulta las notas de la versión. |
| Beta | beta |
Los comandos son completos en cuanto a sus funciones, pero aún pueden tener algunos problemas. Pueden realizarse cambios rotundos en estos comandos sin 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 se instala 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 pedirá que lo instales.
Grupos de comandos
Dentro de cada nivel de actualización, los comandos de gcloud CLI están organizados en una jerarquía anidada de grupos de comandos, cada uno de los cuales representa un producto o una función 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 desde secuencias de comandos y otras automatizaciones, por ejemplo, cuando usas Jenkins para automatizar tareas de Google Cloud.
Propiedades
Las propiedades de la CLI de gcloud son parámetros de configuración que afectan el comportamiento de las herramientas de gcloud CLI. Algunas de estas propiedades se pueden configurar mediante opciones globales o de comando, en cuyo caso, tiene prioridad el valor establecido por la opción.
Habilita las funciones de accesibilidad
Para ofrecer una experiencia de lector de pantalla más optimizada, gcloud CLI incluye una propiedad accessibility/screen_reader.
Para habilitar la propiedad de accesibilidad, ejecuta lo siguiente:
gcloud config set accessibility/screen_reader true
Para obtener más detalles sobre las funciones de accesibilidad que vienen con la herramienta de línea de comandos de gcloud, consulta la guía para habilitar funciones de accesibilidad.
Configuraciones
Una configuración es un conjunto de propiedades de gcloud CLI. Una configuración funciona como un perfil.
Cuando comiences a usar gcloud CLI, trabajarás con una única configuración 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 establecer varias configuraciones con gcloud config configurations create y cambiar entre ellas. Dentro de una configuración, puedes personalizar las propiedades.
Por ejemplo, para establecer 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 la CLI de gcloud que determinan el comportamiento de los comandos en un nivel por invocación. Las opciones anula los valores establecidos en las propiedades de gcloud CLI.
Argumentos y opciones posicionales
Si bien los argumentos posicionales y las opciones afectan el resultado de un comando de gcloud CLI, existe una diferencia sutil en sus casos de uso. Se usa un argumento posicional para definir una entidad en la que opera un comando, mientras que es necesaria una opción para configurar una variación en el comportamiento de un comando.
Uso de stdout y stderr
El resultado de los comandos de gcloud CLI que se ejecutan correctamente se escribe en stdout. Cualquier otro tipo de respuesta (mensajes, advertencias y errores) se escribe en stderr. No crees secuencias de comandos con las respuestas escritas en stderr porque estas respuestas no son estables.
Para obtener lineamientos sobre el manejo de resultados, consulta la Guía de secuencias de comandos.
Mensajes
Como 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 información adicional.
Por ejemplo, se te pedirá que elijas una zona cuando crees una instancia de máquina virtual de Compute Engine con gcloud compute instances create test-instance.
Para inhabilitar los mensajes, usa la opción --quiet.
No crees secuencias de comandos con las palabras de las solicitudes porque las palabras puede cambiar.
Elimina mensajes, escribe a la terminal y haz registros
La opción --quiet (también, -q) para la CLI de gcloud inhabilita todos los mensajes interactivos cuando se ejecutan los comandos de gcloud CLI y resulta útil para crear secuencias de comandos. Si se necesita una entrada, se usarán los valores predeterminados. Si no hay una opción predeterminada, se genera un error.
Para eliminar la impresión del resultado del comando como una salida estándar o un 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 muestra una lista de recursos, estos se imprimen con formato de salida estándar. Para producir resultados más significativos, las opciones format, filter y projection te permiten ajustar tus resultados.
Para definir solo el formato del resultado, usa la opción --format para producir una versión tabulada o plana de este (para pantalla interactiva), o una versión del resultado que la máquina pueda procesar (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.
¿Qué sigue?
- Obtén más información sobre los comandos de gcloud CLI en la referencia de gcloud CLI.