Descripción general de gcloud

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

¿Qué es gcloud?

gcloud es una herramienta que proporciona la interfaz de línea de comandos primaria a Google Cloud Platform. Puedes usar esta herramienta para realizar varias tareas de plataforma comunes, ya sea desde la línea de comandos o en secuencias de comandos y otras automatizaciones.

Por ejemplo, puedes usar gcloud para crear y administrar lo siguiente:

  • Instancias de máquina virtual de Google Compute Engine y otros recursos
  • Instancias de Google Cloud SQL
  • Clústeres de Google Kubernetes Engine
  • Trabajos y clústeres de Google Cloud Dataproc
  • Zonas administradas y conjuntos de registros de Google Cloud DNS
  • Implementaciones de Google Cloud Deployment Manager

También puedes usar gcloud para implementar aplicaciones de App Engine y realizar otras tareas. Lee la referencia de gcloud para obtener más información sobre las capacidades de esta herramienta.

gcloud y el SDK

gcloud forma parte del SDK de Google Cloud. Además de descargar y de instalar el SDK en tu sistema, primero debes inicializarlo para poder usar gcloud.

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

Las actualizaciones de gcloud tienen el mismo número de versión que el SDK. La versión actual del SDK es 231.0.0. Puedes descargar y también instalar versiones previas del SDK desde el archivo de descargas.

Cómo descargar gcloud

Puedes descargar la última versión del SDK de Cloud, que incluye gcloud, desde la página de descargas.

Niveles de actualización

Los comandos 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. Se realizarán advertencias anticipadas para los comandos que rompen la funcionalidad actual y se documentarán en 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.
Vista previa preview Los comandos pueden ser inestables y cambiar sin aviso.

Los componentes alpha y beta no se instalan de manera predeterminada cuando instalas el SDK. Debes instalarlos por separado usando el comando gcloud components install. Si tratas de ejecutar un comando alfa o beta y su componente correspondiente no está instalado, gcloud te pedirá que lo instales.

Grupos de comandos

Dentro de cada nivel de actualización, los comandos 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

Cómo ejecutar comandos de gcloud

Puedes ejecutar comandos 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 gcloud desde secuencias de comandos y otras automatizaciones, por ejemplo, cuando usas Jenkins para automatizar tareas de Cloud Platform.

Propiedades

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

Puedes encontrar una lista de propiedades disponibles aquí.

Configuraciones

Una configuración es un conjunto determinado de propiedades de gcloud. Fundamentalmente, funciona como un perfil.

Comenzando con el SDK de Cloud, 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.

Si deseas trabajar con varios proyectos o cuentas de autorización, puedes establecer varias configuraciones con gcloud config configurations create y alternar entre ellas según corresponda.

Para una cuenta detallada de estos conceptos, consulta estas exploraciones de configuraciones y su administración.

Marcas globales

gcloud proporciona un conjunto de marcas para todo gcloud que determinan el comportamiento de los comandos en un nivel por invocación. Las marcas anulan cualquier valor configurado en las propiedades de SDK.

Marcas y argumentos posicionales

Si bien tanto las marcas como los argumentos posicionales afectan el resultado de un comando de gcloud, existe una diferencia sutil en los 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 exitoso de un comando de gcloud se escribe en stdout. Cualquier otro tipo de respuesta —mensajes, advertencias y errores— se escribe en stderr. Ten en cuenta que todo lo que se escribe en stderr no es estable y no debe incluirse en la secuencia de comandos.

Para obtener una lista definitiva de lineamientos sobre el manejo de resultados, lee esta sección.

Mensajes

Como protección contra acciones destructivas no deseadas, gcloud confirmará tus intenciones antes de ejecutar comandos como gcloud projects delete.

También puedes esperar mensajes si intentas crear una instancia de máquina virtual de Google Compute Engine, es decir una 'instancia de prueba', usando gcloud compute instances create test-instance. Se te pedirá que selecciones una zona en la cual crear la instancia.

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

Ten en cuenta que la redacción de los mensajes puede cambiar y no debe incluirse en la secuencia de comandos.

Cómo eliminar mensajes, escribir a la terminal y hacer registros

La marca --quiet (también, -q) para gcloud inhabilita todos los mensajes interactivos cuando se ejecutan los comandos de gcloud y es útil al momento de realizar secuencias de comandos. En el caso de que sea necesaria una entrada, se usarán los valores predeterminados. Si no existen, se generará un error.

Para eliminar la impresión del resultado del comando para resultado estándar y error estándar en la terminal, usa la marca --no-user-output-enabled.

En cambio, para ajustar la verbosidad de los registros, usa la marca --verbosity y define el nivel apropiado.

Cómo determinar la estructura del resultado

De forma predeterminada, cuando un comando de gcloud muestra una lista de recursos, se imprimen con formato en el resultado estándar. Para producir resultados más significativos, las marcas de formato, filtro y proyección te permiten ajustar tus resultados.

Si deseas definir únicamente el formato de tu resultado, usa la marca --format para producir una versión tabulada o plana de tus resultados (para pantalla interactiva) o una versión procesable del resultado (json, csv, yaml, value).

Para dar formato a una lista de claves que selecciona valores de datos de recursos, usa projections. Para definir aún mejor tus resultados según criterios que deseas definir, usa filter.

Si deseas realizar un instructivo interactivo rápido para familiarizarte con la funcionalidad de filtro y formato, sigue el vínculo a continuación.

Abrir en Cloud Shell

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del SDK de Cloud