Descripción general de la herramienta de gcloud

Esta página contiene una descripción general de la herramienta de línea de comandos de gcloud y sus patrones y capacidades de comando comunes.

¿Qué es la herramienta de gcloud?

La herramienta de línea de comandos de gcloud es la herramienta principal de la CLI para crear y administrar recursos de Google Cloud. Puedes usar esta herramienta para realizar muchas tareas comunes en la plataforma, ya sea desde la línea de comandos o en secuencias de comandos y otras automatizaciones.

Por ejemplo, puedes usar la herramienta de gcloud 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 Dataproc
  • Zonas administradas y conjuntos de registros de Cloud DNS
  • Implementaciones de Cloud Deployment Manager

También puedes usar la herramienta de gcloud para implementar aplicaciones de App Engine, administrar la autenticación, personalizar la configuración local y realizar otras tareas. Para obtener más información sobre las capacidades de la herramienta de gcloud, consulta la referencia de la herramienta de gcloud.

Hoja de referencia de la herramienta de gcloud

Para obtener una introducción rápida algcloud, una lista de comandos de uso común y cómo se estructuran estos comandos, consulta elgcloud hoja de referencia de herramientas ,

La herramienta de gcloud y el SDK de Cloud

La herramienta de gcloud forma parte del SDK de Cloud. Para poder usar la herramienta de gcloud, debes descargar e instalar el SDK de Cloud en tu sistema y, luego, inicializar el SDK de Cloud .

De forma predeterminada, el SDK de Cloud instala los comandos de la herramienta de gcloud que están en el nivel de la Disponibilidad general. Hay funcionalidades adicionales disponibles en los componentes del SDK de Cloud llamados alpha y beta. Estos componentes te permiten usar la herramienta de gcloud para trabajar con Cloud Bigtable, Dataflow y otras partes de Google Cloud en niveles de versiones anteriores a la disponibilidad general.

Las versiones de la herramienta de gcloud tienen el mismo número de versión que el SDK de Cloud. La versión actual del SDK de Cloud es 365.0.1. Puedes descargar e instalar versiones anteriores del SDK de Cloud desde el archivo de descarga.

Descarga la herramienta de gcloud

Puedes descargar la versión más reciente del SDK de Cloud, que incluye la herramienta de gcloud, desde la página de descargas.

Niveles de actualización

Los comandos de la herramienta 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 un aviso anticipado de los cambios en los comandos que rompen la funcionalidad actual, consulta las notas de la versión.
Beta beta Los comandos funcionan correctamente, pero aún pueden tener algunos problemas pendientes. 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 manera predeterminada cuando instalas el SDK de Cloud. 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 herramienta de gcloud te solicitará que lo instales.

Grupos de comandos

Dentro de cada nivel de actualización, los comandos de la herramienta de gcloud se organizan en una jerarquía anidada de grupos de comandos, los cuales representan un producto o una característica de Cloud Platform 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 comandos de la herramienta de gcloud

Puedes ejecutar comandos de la herramienta de gcloud desde la línea de comandos de la misma manera que usas otras herramientas de la línea de comandos. También puedes ejecutar comandos de la herramienta de gcloud desde secuencias de comandos y otras automatizaciones, por ejemplo, cuando usas Jenkins para automatizar tareas de Google Cloud.

Propiedades

Las propiedades de la herramienta de gcloud son opciones de configuración que afectan el comportamiento de la herramienta de gcloud y otras herramientas del SDK de Cloud. Algunas de estas propiedades se pueden configurar mediante marcas globales o de comando, en cuyo caso, tendrá prioridad el valor establecido por la marca.

Habilita las funciones de accesibilidad

Para ofrecer una experiencia de lector de pantalla más optimizada, la herramienta de gcloud viene con una propiedad accessibility/screen_reader.

Para habilitarla, 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 Habilita funciones de accesibilidad.

Configuraciones

Una configuración es un conjunto determinado de propiedades de la herramienta de gcloud. Una configuración funciona como un perfil.

Cuando comiences a usar el SDK de Cloud, trabajarás con una sola configuración llamada default y podrás establecer propiedades mediante la ejecución de 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 alternar entre las configuraciones. En 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.

Marcas globales

La herramienta de gcloud proporciona un conjunto de marcas de toda la herramienta de gcloud que rigen el comportamiento de los comandos en un nivel por invocación. Las marcas anulan los valores establecidos en las propiedades del SDK de Cloud.

Marcas y argumentos posicionales

Si bien los argumentos posicionales y las marcas afectan el resultado de un comando de la herramienta de gcloud, hay una diferencia sutil en sus casos prácticos. Se usa un argumento posicional para definir una entidad en la que opera un comando, mientras que es necesaria una marca para configurar una variación en el comportamiento de un comando.

Uso de stdout y stderr

El resultado de los comandos correctos de la herramienta de gcloud se escribe en stdout. Todos los otros tipos de respuestas (mensajes, advertencias y errores) se escriben en stderr. No uses secuencias de comandos en las respuestas escritas en stderr, ya que estas respuestas no son estables.

Para obtener lineamientos sobre el manejo de resultados, consulta la Guía de secuencias de comandos.

Mensajes

Para protegerse de acciones destructivas no deseadas, la herramienta de gcloud confirma tus intenciones antes de ejecutar comandos como gcloud projects delete.

Además, es posible que recibas mensajes si crearías una instancia de máquina virtual de Compute Engine con gcloud compute instances create test-instance. Se te pedirá que elijas una zona para crear la instancia.

Para inhabilitar los mensajes, usa la marca --quiet.

No redactes guiones con las palabras de las solicitudes, ya que estas pueden cambiar.

Elimina mensajes, escribe a la terminal y haz registros

La marca --quiet (también, -q) para la herramienta gcloud inhabilita todos los mensajes interactivos cuando se ejecutan los comandos de la herramienta de gcloud. es útil para la creación de secuencias de comandos. Si se necesita una entrada, se usan los valores predeterminados. Si no hay un valor predeterminado, se genera un error.

A fin de eliminar la impresión del resultado del comando como una salida estándar o un error estándar en la terminal, usa la marca --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 marca --verbosity.

Determina la estructura del resultado

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

Con el fin de definir solo el formato del resultado, usa la marca --format para producir una versión tabular o compacta del resultado (para una visualización interactiva) o una máquina. Es una versión legible 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.

Para familiarizarte con la funcionalidad de filtros y formatos, puedes completar un instructivo interactivo rápido haciendo clic en Abrir en Cloud Shell.

Abrir en Cloud Shell

¿Qué sigue?