La hoja de referencia de la CLI de gcloud

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Una lista de comandos útiles para Google Cloud CLI, la herramienta de línea de comandos principal de Google Cloud.

También se incluyen: guías de introducción, comprensión de los comandos y un PDF imprimible).

Hoja de referencia

Cómo comenzar

Comience a usar la CLI de gcloud.

Help

La CLI de gcloud te ayudará.

  • gcloud help: busca términos específicos en los documentos de referencia de la CLI de gcloud.
  • gcloud feedback: Proporciona comentarios al equipo de la CLI de gcloud.
  • gcloud topic: Material de ayuda complementario para temas que no son sobre comandos, como la accesibilidad, el filtrado y el formato.

Personalización

Personalice su CLI de gcloud y personalice su configuración con propiedades.

Autorización y credenciales

Otorga y revoca la autorización a la CLI de gcloud y administra las credenciales.

Proyectos

Administrar las políticas de acceso del proyecto

IAM

Configurar las preferencias y las cuentas de servicio de la administración de identidades y accesos (IAM)

Docker y Google Kubernetes Engine (GKE)

Administra aplicaciones en contenedores en Kubernetes.

Máquinas virtuales y Compute Engine

Crea, ejecuta y administra VM en la infraestructura de Google Cloud.

App Engine y sin servidores

Compila aplicaciones muy escalables en una plataforma completamente administrada y sin servidores

Varios

Comandos que pueden resultar útiles

Guía de introducción

Una guía rápida para comenzar a usar la CLI de gcloud.

Instala Google Cloud CLI

Instala Google Cloud CLI con estas instrucciones de instalación.

Marcas, argumentos y otras excelentes adiciones

Los argumentos pueden ser marcas o argumentos posicionales:

  • Argumentos posicionales: Se configuran después del nombre del comando debe respetar el orden de los argumentos posicionales.
  • Marcas: se configuran después de los argumentos posicionales. El orden de las marcas no importa.

    Una marca puede ser una de las siguientes opciones:

    • Par nombre-valor (--foo=bar) o
    • Booleano (--force/no-force).

    Además, las marcas pueden ser de la siguiente manera:

    • Obligatorio
    • Opcional: Si no se define una marca opcional, se usa el valor predeterminado

Marcas globales

Algunas marcas están disponibles en la experiencia de la CLI de gcloud, como las siguientes:

  • --help: para cuando tengas dudas, muestra la ayuda detallada de un comando.
  • --project: si usas un proyecto que no sea el actual.
  • --quiet: inhabilita los mensajes interactivos (y aplica valores predeterminados para las entradas).
  • --verbosity: Puede establecer niveles de verbosidad en debug, info, warning, error, critical y none.
  • --version: Muestra la información de la versión de gcloud.
  • --format : Establece formato de salida como config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, o yaml.

Realiza una limpieza de los resultados

Usa los filtros, el formato, el límite y las marcas de clasificación para sacar el máximo provecho de tus resultados.

Para instancias de Compute Engine con el prefijo us y no el tipo de máquina f1-micro usa lo siguiente:

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

Para obtener una lista de proyectos creados a partir del 15 de enero de 2018, ordenados desde los más antiguos hasta los más recientes, presentada en una tabla con número de proyecto, ID del proyecto y columnas de tiempo de creación con fechas y horas en la zona horaria local, usa el siguiente comando:

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

Para obtener una lista de diez instancias de Compute Engine con una etiqueta my-label (de cualquier valor), usa el siguiente comando:

gcloud compute instances list --filter="labels.my-label:*" --limit=10

Información acerca de los comandos

Los patrones subyacentes para los comandos de la CLI de gcloud ayudan a descubrir los comandos.

Busca comandos de la CLI de gcloud

La CLI de gcloud es un árbol; los nodos que no son de hoja son grupos de comandos y los nodos de hoja son comandos. Además, el autocompletado con pestañas funciona para comandos y recursos.

La mayoría de los comandos gcloud siguen el siguiente formato:

gcloud + release level (optional) + component + entity + operation + positional args + flags

Por ejemplo: gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

Nivel de actualización

Nivel de actualización hace referencia al estado de la actualización del comando.

Ejemplo: alpha para los comandos Alfa, beta para los comandos Beta, no se necesita un nivel de actualización para los comandos de GA.

Componente

Componente se refiere a los diferentes servicios de Google Cloud.

Ejemplo: compute para Compute Engine, app para App Engine, etcétera.

Entity

Entidad hace referencia a la forma plural de un elemento o una colección de elementos en un componente.

Ejemplo: disks, firewalls, images, instances, regions, zones para el procesamiento

Operación

Operación hace referencia a la forma verbo imperativo de la operación que se realizará en la entidad.

Ejemplo: Las operaciones comunes son describe, list, create/update, delete/clear, import, export, copy, remove, add, reset, restart, restore, run y deploy.

Argumentos posicionales

Los argumentos posicionales hacen referencia a los argumentos obligatorios y específicos de orden necesarios para ejecutar el comando.

Ejemplo: <INSTANCE_NAMES> es el argumento posicional requerido para gcloud compute instances create.

Marcas

Las marcas hacen referencia a los argumentos adicionales, --flag-name(=value), que se pasan al comando después de los argumentos posicionales.

Ejemplo: --machine-type=<MACHINE_TYPE> y --preemptible son marcas opcionales para gcloud compute instances create.