En esta página se ofrece una descripción general de Google Cloud CLI, así como de sus patrones de comandos y funciones habituales.
¿Qué es la CLI de gcloud?
Google Cloud CLI es un conjunto de herramientas para crear y gestionarGoogle Cloud recursos. Puedes usar estas herramientas para realizar muchas tareas comunes de la plataforma desde la línea de comandos o mediante secuencias de comandos y otras automatizaciones.
Por ejemplo, puedes usar la CLI de gcloud para crear y gestionar lo siguiente:
- Instancias de máquinas virtuales de Compute Engine y otros recursos
- Instancias de Cloud SQL
- Clústeres de Google Kubernetes Engine
- Clústeres y tareas de Dataproc
- Zonas gestionadas y conjuntos de registros de Cloud DNS
- Implementaciones de Cloud Deployment Manager
También puedes usar la CLI de gcloud para desplegar aplicaciones de App Engine, gestionar la autenticación, personalizar la configuración local y realizar otras tareas.
Descargar e instalar gcloud CLI
La versión actual de gcloud CLI es la 538.0.0.
Aunque te recomendamos que uses la versión actual de la CLI de gcloud, también puedes descargar e instalar versiones anteriores desde el archivo de descargas.
Si usas Cloud Shell, la CLI de gcloud está disponible automáticamente y no tienes que instalarla. De lo contrario, descarga e instala gcloud CLI y, a continuación, inicialízalo.
De forma predeterminada, gcloud CLI instala 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 la CLI de gcloud para trabajar con Bigtable, Dataflow y otras partes de Google Cloud en versiones anteriores a la disponibilidad general.
Hoja de referencia rápida de la CLI de gcloud
Para obtener una introducción rápida a la CLI de gcloud, una lista de los comandos que se usan con frecuencia y una descripción de cómo se estructuran estos comandos, consulta la hoja de referencia de la CLI de gcloud.
Niveles de lanzamiento
Los comandos de gcloud CLI tienen los siguientes niveles de lanzamiento:
| Nivel de lanzamiento | Etiqueta | Descripción |
|---|---|---|
| Disponibilidad general | Ninguno | Los comandos se consideran totalmente estables y se pueden usar en producción. Para recibir un aviso con antelación sobre los cambios en los comandos que afecten a la funcionalidad actual, consulta las notas de la versión. |
| Beta | beta |
Los comandos están completos desde el punto de vista funcional, pero aún pueden tener algunos problemas pendientes. Se pueden hacer cambios en estos comandos sin previo aviso. |
| Alfa | alpha |
Los comandos están en fase de lanzamiento inicial y pueden cambiar sin previo aviso. |
Los componentes alpha y beta no se instalan de forma predeterminada al instalar la 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, la CLI de gcloud te pedirá que lo instales.
Grupos de comandos
Dentro de cada nivel de lanzamiento, los comandos de gcloud CLI se organizan 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 en disponibilidad general |
gcloud compute instances |
Comandos relacionados con las instancias de Compute Engine en disponibilidad general |
gcloud beta compute |
Comandos relacionados con Compute Engine en versión beta |
gcloud alpha app |
Comandos relacionados con la gestión de los despliegues de App Engine en la versión alfa |
Ejecutar comandos de la CLI de gcloud
Puedes ejecutar comandos de la CLI de gcloud desde la línea de comandos y desde secuencias de comandos y otras automatizaciones. Por ejemplo, puedes usar Jenkins para automatizar Google Cloud tareas.
Propiedades
Las propiedades de gcloud CLI son ajustes que afectan al comportamiento de las herramientas de gcloud CLI. Algunas de estas propiedades se pueden definir mediante opciones globales o de comandos. En ese caso, el valor definido por la opción tiene prioridad.
Habilitar funciones de accesibilidad
Para optimizar la experiencia con el lector de pantalla, la CLI de gcloud incluye la 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 información sobre las funciones de accesibilidad que incluye la herramienta de línea de comandos gcloud, consulta la guía Habilitar funciones de accesibilidad.
Configuraciones
Una configuración es un conjunto de propiedades de la CLI de gcloud. Una configuración funciona como un perfil.
Cuando empieces a usar la CLI de gcloud, trabajarás con una sola configuración llamada default y podrás definir propiedades ejecutando gcloud init o gcloud config set. Esta configuración predeterminada única 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 cambiar entre ellas. En una configuración, puedes personalizar propiedades.
Por ejemplo, para definir tu proyecto en una configuración activa, usa la propiedad project:
gcloud config set project <project-id>
Para obtener una descripción detallada de estos conceptos, consulta la guía de configuraciones.
Opciones globales
La CLI de gcloud proporciona un conjunto de opciones de la CLI de gcloud que rigen el comportamiento de los comandos a nivel de invocación. Las opciones anulan los valores definidos en las propiedades de la CLI de gcloud.
Argumentos y opciones posicionales
Aunque los argumentos posicionales y las opciones afectan al resultado de un comando de la CLI de gcloud, hay una diferencia sutil en sus casos prácticos. Un argumento posicional se usa para definir una entidad en la que opera un comando, mientras que una opción es necesaria para establecer una variación en el comportamiento de un comando.
Uso de stdout y stderr
El resultado de los comandos de la interfaz de línea de comandos de gcloud que se ejecutan correctamente se escribe en
stdout. El resto de los tipos de respuestas (peticiones, advertencias y errores) se escriben en stderr. No escribas secuencias de comandos para las respuestas escritas en stderr porque
estas respuestas no son estables.
Para obtener directrices sobre cómo gestionar la salida, consulta la guía de scripting.
Formulación de peticiones
Para protegerte frente a acciones destructivas no deseadas, la CLI de gcloud confirma tus intenciones antes de ejecutar comandos como gcloud projects delete.
Es posible que se te pida 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 las peticiones, usa la opción --quiet.
No escribas secuencias de comandos basadas en la redacción de las peticiones, ya que puede cambiar.
Suprimir las peticiones, la escritura en el terminal y el registro
La opción --quiet (también -q) de la CLI de gcloud inhabilita todas las peticiones interactivas al ejecutar comandos de la CLI de gcloud y es útil para escribir secuencias de comandos. Si se necesita una entrada, se usan los valores predeterminados. Si no hay ningún valor predeterminado, se produce un error.
Para suprimir la impresión de la salida de comandos en la salida estándar y el error estándar en el terminal, usa la opción --no-user-output-enabled.
Para ajustar el nivel de detalle de los registros, especifica un nivel (depuración, información, advertencia, error, crítico o ninguno) con la opción --verbosity.
Determinar la estructura de salida
De forma predeterminada, cuando un comando de la interfaz de línea de comandos de gcloud devuelve una lista de recursos, estos se muestran con un formato legible en la salida estándar. Para obtener resultados más significativos, las opciones format, filter y projection te permiten ajustar los resultados.
Para definir solo el formato de la salida, usa la opción --format para generar una versión tabulada o simplificada de la salida (para mostrarla de forma interactiva) o una versión legible por máquina de la salida (json, csv, yaml, value).
Para dar formato a una lista de claves que seleccionen valores de datos de recursos, usa projections. Para acotar aún más los resultados según los criterios que definas, usa filter.
Siguientes pasos
- Consulta más información sobre los comandos de la CLI de gcloud en la referencia de la CLI de gcloud.