Descripción general de gcloud CLI

En esta página, se incluye una descripción general de Google Cloud CLI y sus patrones y capacidades de comandos comunes.

¿Qué es gcloud CLI?

Google Cloud CLI es un conjunto de herramientas para crear y administrar Google Cloud recursos. Puedes usar estas herramientas para realizar varias tareas comunes en la plataforma, ya sea desde la línea de comandos o con 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
  • Clústeres y trabajos de Managed Service para Apache Spark
  • 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 589.0.0.

Aunque te recomendamos que uses la versión actual de la 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 necesitas instalarla. De lo contrario, descarga e instala la CLI de gcloud y, luego, inicialízala.

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, beta, y preview. Estos componentes te permiten usar la gcloud CLI para trabajar con Bigtable, Dataflow y otras partes de Cloud Google Cloud en niveles de actualizaciones 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 de uso general y una descripción de cómo se estructuran estos comandos, consulta la hoja de referencia de la CLI de gcloud.

Niveles de actualización

Los comandos de la gcloud CLI 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 interrumpen la funcionalidad actual, consulta las notas de la versión.
Vista previa preview Los comandos están en el nivel de versión preliminar, que se usa para recopilar comentarios de los clientes. Las ofertas de versión preliminar a menudo se anuncian de forma pública, pero no necesariamente cuentan con todas las funciones y no se proporcionan ANS ni se realizan compromisos de asistencia técnica para ellas. A menos que Google indique lo contrario, las ofertas de versión preliminar están destinadas solo para el uso en entornos de pruebas. La etapa de versión preliminar promedio dura alrededor de seis meses.
Beta beta Los comandos están completos desde el punto de vista funcional, pero aún podrían tener algunos problemas pendientes. Los cambios rotundos en estos comandos se pueden realizar sin previo aviso.
Alfa alpha Los comandos están en su actualización temprana y pueden cambiar sin aviso.

Los componentes alpha, beta y preview no se instalan de forma predeterminada cuando instalas gcloud CLI. Debes instalar estos componentes por separado con el comando gcloud components install. Si intentas ejecutar un comando alfa, beta o de vista previa y no está instalado el componente correspondiente, gcloud CLI te solicitará que lo instales.

Grupos de comandos

Dentro de cada nivel de actualización, 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 instancias de Compute Engine en disponibilidad general
gcloud beta compute Comandos relacionados con Compute Engine en Beta
gcloud preview Comandos relacionados con Google Cloud en vista previa
gcloud alpha app Comandos relacionados con la administración de implementaciones de App Engine en Alfa

Ejecuta comandos de gcloud CLI

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 Google Cloud tareas.

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 con opciones globales o de comandos, en cuyo caso, el valor establecido por la opción tiene prioridad.

Habilita las funciones de accesibilidad

Para una experiencia más optimizada del lector de pantalla, 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 incluye la herramienta de línea de comandos de gcloud, consulta la guía Habilita las funciones de accesibilidad.

Parámetros de configuración

Un parámetro de configuración es un conjunto de propiedades de gcloud CLI. Un parámetro de configuración funciona como un perfil.

Cuando comiences a usar gcloud CLI, trabajarás con un solo parámetro de configuración llamado default y podrás 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 varios parámetros de configuración con gcloud config configurations create y cambiar entre ellos. Dentro de un parámetro de configuración, puedes personalizar las propiedades. Por ejemplo, para establecer tu proyecto dentro de un parámetro de configuración activo, 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

La 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 anulan los valores establecidos en las propiedades de gcloud CLI.

Argumentos y opciones de posición

Si bien los argumentos posicionales y las opciones afectan el resultado de un comando de la gcloud CLI, existe una diferencia sutil en sus casos de uso. Un argumento de posición se usa para definir una entidad en la que opera 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 respuestas (instrucciones, advertencias y errores) se escriben en stderr. No crees secuencias de comandos en función de las respuestas escritas en stderr, ya que estas respuestas no son estables.

Para obtener instrucciones sobre el manejo de resultados, consulta la guía de creación de secuencias de comandos.

Instrucciones

Para protegerte de 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 las instrucciones, usa la opción --quiet.

No crees secuencias de comandos en función de la redacción de las instrucciones, ya que la redacción puede cambiar.

Suprime los mensajes, escribe en la terminal y registra

La opción --quiet (también -q) para la CLI de gcloud inhabilita todas las instrucciones interactivas cuando se ejecutan comandos de gcloud CLI y es útil para la creación de secuencias de comandos. Si se requiere una entrada, se usan los valores predeterminados. Si no hay un valor predeterminado, se genera un error.

Para evitar que se imprima el resultado del comando en la salida estándar y el 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 --verbosity opción.

Determina la estructura del resultado

De forma predeterminada, cuando un comando de la gcloud CLI muestra una lista de recursos, los recursos se imprimen de forma legible en la salida estándar. Para producir un resultado más significativo, las opciones format, filter y projection te permiten ajustar el resultado.

Para definir solo el formato de tu resultado, usa la --format opción para producir una versión tabulada o aplanada de tu resultado (para la visualización interactiva) o una versión legible por máquina del resultado (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?