Hoja de trucos de la CLI de gcloud

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

(También se incluye: manual introductorio , comprensión de comandos y un PDF imprimible ).

Hoja de trucos

Empezando

Comience a utilizar la CLI de gcloud.

• gcloud init : inicializa, autoriza y configura la CLI de gcloud.
• gcloud version : muestra la versión y los componentes instalados.
• gcloud components install : instala componentes específicos.
• gcloud components update : actualice su CLI de gcloud a la última versión.
• gcloud config set project : Establecer un valor predeterminado Google Cloud Proyecto en el que trabajar.
• gcloud info : muestra los detalles del entorno CLI de gcloud actual.

Ayuda

gcloud CLI estará encantado de ayudarle.

• gcloud help : busque términos específicos en los documentos de referencia de la CLI de gcloud.
• gcloud feedback : proporcione comentarios al equipo CLI de gcloud.
• gcloud topic : Material de ayuda complementario para temas no relacionados con los comandos, como accesibilidad, filtrado y formato.

Personalización

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

• gcloud config set : define una propiedad (como cómputo/zona) para la configuración actual.
• gcloud config get : obtiene el valor de una propiedad CLI de gcloud.
• gcloud config list : muestra todas las propiedades de la configuración actual.
• gcloud config configurations create : crea una nueva configuración con nombre.
• gcloud config configurations list : muestra una lista de todas las configuraciones disponibles.
• gcloud config configurations activate : cambiar a una configuración con nombre existente.

Autorización y Credenciales

Otorgar y revocar autorización a la CLI de gcloud y administrar credenciales.

• gcloud auth login : AutorizarGoogle Cloud acceso para la CLI de gcloud conGoogle Cloud credenciales de usuario y establecer la cuenta actual como activa.
• gcloud auth activate-service-account : Autorizar Google Cloud acceso similar al gcloud auth login pero con credenciales de cuenta de servicio.
• gcloud auth application-default : administra tus credenciales de aplicación predeterminadas (ADC) para las bibliotecas de cliente en la nube.
• gcloud auth list : enumera todas las cuentas con credenciales.
• gcloud auth print-access-token : muestra el token de acceso de la cuenta actual.
• gcloud auth revoke : elimina las credenciales de acceso para una cuenta.

Proyectos

Administrar las políticas de acceso al proyecto.

• gcloud projects describe : Muestra metadatos de un proyecto (incluido su ID).
• gcloud projects add-iam-policy-binding : agrega un enlace de política de IAM a un proyecto específico.

SOY

Configurar preferencias y cuentas de servicio de administración de identidad y acceso (IAM).

• gcloud iam list-grantable-roles : enumera los roles que IAM puede otorgar a un recurso.
• gcloud iam roles create : crea un rol personalizado para un proyecto u organización.
• gcloud iam service-accounts create : crea una cuenta de servicio para un proyecto.
• gcloud iam service-accounts add-iam-policy-binding : agrega un enlace de política de IAM a una cuenta de servicio.
• gcloud iam service-accounts set-iam-policy-binding : reemplaza el enlace de política de IAM existente.
• gcloud iam service-accounts keys list : enumera las claves de una cuenta de servicio.

Docker y Google Kubernetes Engine (GKE)

Administrar aplicaciones en contenedores en Kubernetes.

• gcloud auth configure-docker : registra la CLI de gcloud como un ayudante de credenciales de Docker.
• gcloud container clusters create : crea un clúster para ejecutar contenedores de GKE.
• gcloud container clusters list : enumera los clústeres para ejecutar contenedores de GKE.
• gcloud container clusters get-credentials : actualiza kubeconfig para lograr que kubectl use un clúster de GKE.
• gcloud container images list-tags : lista de etiquetas y metadatos de resumen para una imagen de contenedor.

Máquinas virtuales y Compute Engine

Cree, ejecute y administre máquinas virtuales en Google Cloud infraestructura.

• gcloud compute zones list : enumera las zonas de Compute Engine.
• gcloud compute instances create : crea una instancia de VM.
• gcloud compute instances describe : muestra los detalles de una instancia de VM.
• gcloud compute instances list : enumera todas las instancias de VM en un proyecto.
• gcloud compute disks snapshot : crea una instantánea de discos persistentes.
• gcloud compute snapshots describe : muestra los detalles de una instantánea.
• gcloud compute snapshots delete : eliminar una instantánea.
• gcloud compute ssh : Conéctese a una instancia de VM mediante SSH.

Sin servidor y App Engine

Cree aplicaciones altamente escalables en una plataforma sin servidor totalmente administrada

• gcloud app deploy : implementa el código y la configuración de tu aplicación en el servidor de App Engine.
• gcloud app versions list : enumera todas las versiones de todos los servicios implementados en el servidor de App Engine.
• gcloud app browse : abre la aplicación actual en un navegador web.
• gcloud app create : crea una aplicación de App Engine dentro de tu proyecto actual.
• gcloud app logs read : muestra los últimos registros de aplicaciones de App Engine.

Misceláneas

Comandos que podrían resultar útiles

• gcloud kms decrypt : descifra texto cifrado (a un archivo de texto simple) utilizando una clave del Servicio de administración de claves en la nube.
• gcloud logging logs list : enumera los registros de tu proyecto.
• gcloud sql backups describe : muestra información sobre una copia de seguridad de una instancia de Cloud SQL.
• gcloud sql export sql : exporta datos de una instancia de Cloud SQL a un archivo SQL.

Manual introductorio

Una introducción rápida para comenzar a utilizar la CLI de gcloud.

Instalación de la CLI de Google Cloud

Instale la CLI de Google Cloud con estas instrucciones de instalación .

Banderas, argumentos y otras adiciones maravillosas

Los argumentos pueden ser argumentos posicionales o banderas:

• Argumentos posicionales: se establecen después del nombre del comando; debe respetarse el orden de los argumentos posicionales.

• Banderas: se establecen después de los argumentos posicionales; el orden de las banderas no importa.

  Una bandera puede ser:

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

  Además, las banderas pueden ser:

  • Requerido
  • Opcional: si no se define un indicador opcional, se utiliza el valor predeterminado

Banderas globales

Algunas banderas están disponibles durante toda la experiencia de gcloud CLI, como:

• --help : Para cuando tenga dudas; muestra ayuda detallada para un comando.
• --project : Si se utiliza un proyecto distinto al actual.
• --quiet : deshabilita la solicitud interactiva (y aplica valores predeterminados para las entradas).
• --verbosity : puede establecer niveles de verbosidad en debug , info , warning , error , critical y none .
• --version : Muestra información de la versión gcloud .
• --format : establece el formato de salida como config , csv , default , diff , disable , flattened , get , json , list , multi , none , object , table , text , value o yaml .

Resultados de limpieza

Aproveche al máximo su salida con los indicadores de filtro , formato , límite y ordenación.

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

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 del más antiguo al más nuevo, presentados como una tabla con número de proyecto, identificación del proyecto y columnas de hora de creación con fechas y horas en la zona horaria local:

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):

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

Comprensión de comandos

Los patrones subyacentes de los comandos CLI de gcloud; para facilitar el autodescubrimiento de comandos.

Encontrar comandos CLI de gcloud

La CLI de gcloud es un árbol; los nodos que no son hojas son grupos de comandos y los nodos hoja son comandos. (Además, la función de completar con tabulación funciona con 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 lanzamiento

El nivel de lanzamiento se refiere al estado de lanzamiento del comando.

Ejemplo: alpha para comandos alfa, beta para comandos beta, no se necesita nivel de lanzamiento para comandos GA.

Componente

El componente se refiere a los diferentes Google Cloud servicios.

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

Entidad

Entidad se refiere a la forma plural de un elemento o colección de elementos bajo un componente.

Ejemplo: disks , firewalls , images , instances , regions , zones para cómputo

Operación

Operación se refiere a la forma verbal imperativa de la operación que se debe realizar en la entidad.

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

Argumentos posicionales

Los argumentos posicionales se refieren a los argumentos requeridos y específicos del orden necesarios para ejecutar el comando.

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

Banderas

Las banderas 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 indicadores opcionales para gcloud compute instances create .