computación de gcloud

La CLI de Google Cloud te permite administrar tus recursos de Compute Engine mediante el grupo de comandos gcloud compute . gcloud compute es una alternativa al uso de la API de Compute Engine.

La CLI de gcloud es parte de la CLI de Google Cloud y es una herramienta de línea de comandos unificada que incluye funciones como autocompletado de declaraciones, actualización in situ, ayuda de línea de comandos, formatos de salida legibles por humanos y analizables por máquinas, e integración con la CLI de Google Cloud.

Si nunca has usado Compute Engine, comienza con el inicio rápido de Linux o el inicio rápido de Windows .

Antes de comenzar

Propiedades predeterminadas

Cuando creas una instancia de máquina virtual, Compute Engine configura una VM usando propiedades predeterminadas del servidor de metadatos . Puede verificar las propiedades predeterminadas de su VM ejecutando el siguiente comando:

gcloud compute project-info describe --project PROJECT_ID

Reemplace PROJECT_ID con su ID de proyecto.

Proyecto predeterminado

Si configuras un proyecto predeterminado cuando configuras e inicializas la CLI de Google Cloud, todos los comandos gcloud compute usan ese ID de proyecto de manera predeterminada.

Puede anular el ID del proyecto predeterminado mediante cualquiera de los siguientes métodos:

  • Ejecute cada comando gcloud compute con la marca --project

  • Establecer la variable de entorno CLOUDSDK_CORE_PROJECT

    Linux y macOS

    Utilice el comando export para configurar la variable de entorno del proyecto.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Reemplace PROJECT_ID con el ID del proyecto que desea utilizar como predeterminado.

    Desarmar variables de entorno del proyecto

    Si necesita desarmar las variables de entorno de su proyecto, use los siguientes comandos unset :

    unset CLOUDSDK_CORE_PROJECT

    ventanas

    Utilice el comando set para configurar la variable de entorno del proyecto.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Reemplace PROJECT_ID con el ID del proyecto que desea utilizar como predeterminado.

    Desarmar variables de entorno del proyecto

    Si necesita desarmar las variables de entorno de su proyecto, use el siguiente comando:

    set CLOUDSDK_CORE_PROJECT=

Si no configuras un proyecto predeterminado o una variable de entorno, debes incluir una marca --project en cada comando gcloud compute que ejecutes.

Región y zona predeterminadas

Algunos comandos gcloud compute requieren marcas --region o --zone . En lugar de especificar estos indicadores cada vez que ejecuta comandos, puede establecer una región y zona predeterminadas para su proyecto. Si no configura una región o zona predeterminada y ejecuta un comando dependiente de la región o zona, es posible que la CLI de Google Cloud le solicite que proporcione una marca --region o --zone , o que devuelva un error.

Puede configurar la región y zona predeterminadas de tres maneras:

  • En el servidor de metadatos . La región y zona predeterminadas configuradas en el servidor de metadatos se aplican a tu cliente local cuando ejecutas gcloud init .
  • En tu cliente local . La región y zona predeterminadas establecidas en su cliente local anulan la región y zona predeterminadas establecidas en el servidor de metadatos.
  • En variables de entorno . La región y zona predeterminadas establecidas en las variables de entorno anulan la región y zona predeterminadas establecidas en su cliente local y en el servidor de metadatos.

Puede anular la región y zona predeterminadas en el servidor de metadatos, en su cliente local o en las variables de entorno, proporcionando los indicadores --region y --zone cuando ejecuta comandos.

Ver región y zona predeterminadas

Para ver su región y zona predeterminadas, ejecute los siguientes comandos:

gcloud config get-value compute/region
gcloud config get-value compute/zone

Si la salida es (unset) , no se establece ninguna región o zona predeterminada.

Ver regiones y zonas disponibles

Puede ver una lista de regiones y zonas ejecutando los siguientes comandos:

gcloud compute regions list
gcloud compute zones list

Establecer región y zona predeterminadas en el servidor de metadatos

La región y zona predeterminadas en el servidor de metadatos se aplican a todas las configuraciones de su proyecto. Para configurar la región y zona predeterminadas en el servidor de metadatos, haga lo siguiente:

  1. Establezca la región y zona predeterminadas: 

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE

    Por ejemplo: 

    gcloud compute project-info add-metadata \
   --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b

  2. Inicialice el cambio en su cliente local: 

    gcloud init

Puede anular la región y zona predeterminadas establecidas en el servidor de metadatos configurando la región y zona predeterminadas en su cliente local, configurando la región y zona predeterminadas en variables de entorno o incluyendo la marca --zone o --region en sus comandos.

Desarmar región y zona predeterminadas en el servidor de metadatos

Para anular la configuración de la región y zona predeterminadas en el servidor de metadatos, haga lo siguiente:

  1. Metadatos no configurados: 

    gcloud compute project-info remove-metadata \
   --keys=google-compute-default-region,google-compute-default-zone

  2. Inicialice el cambio en su cliente local: 

    gcloud init

Establezca la región y zona predeterminadas en su cliente local

La región y zona predeterminadas establecidas en su cliente local anulan la región y zona predeterminadas establecidas en el servidor de metadatos.

Para configurar la región y zona predeterminadas en su cliente local, ejecute los siguientes comandos: 

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Desarme la región y zona predeterminadas en su cliente local

Para desarmar la región o zona predeterminada en su cliente local, ejecute los siguientes comandos: 

gcloud config unset compute/zone

gcloud config unset compute/region

Puede anular la región y la zona predeterminadas establecidas en su cliente local configurando la región y la zona predeterminadas en las variables de entorno, o incluyendo la marca --zone o --region en sus comandos.

Establecer región y zona predeterminadas en variables de entorno

La región y zona predeterminadas establecidas en las variables de entorno anulan la región y zona predeterminadas establecidas en su cliente local y en el servidor de metadatos.

Linux y macOS

Utilice el comando export para configurar las variables de región y zona. 

export CLOUDSDK_COMPUTE_REGION=REGION

export CLOUDSDK_COMPUTE_ZONE=ZONE

Para que estas variables de entorno sean permanentes, incluya estos comandos en su archivo ~/.bashrc y reinicie su terminal.

ventanas

Utilice el comando set para configurar las variables de región y zona. 

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Puede anular las variables de entorno incluyendo el indicador --zone o --region en sus comandos.

Desarmar región y zona predeterminadas en variables de entorno

Utilice los siguientes comandos para anular la configuración de la región y zona predeterminadas en las variables de entorno.

Linux y macOS

Para desarmar las variables de entorno de su región y zona, use los siguientes comandos unset : 

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

ventanas

Para desarmar las variables de entorno de su región y zona, use los siguientes comandos: 

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Anular la zona predeterminada con banderas

Utilice el indicador --zone para anular la zona predeterminada establecida en el servidor de metadatos, su cliente local y las variables de entorno.

Por ejemplo: 

gcloud compute instances create example-instance \
    --zone=ZONE

Configuraciones

gcloud topic configurations son una característica avanzada que puedes usar para influir en el comportamiento de la CLI de gcloud. Para la mayoría de los usuarios, utilizar configuraciones predeterminadas es suficiente.

Las configuraciones pueden resultar útiles para los usuarios que:

  • Trabajar con múltiples proyectos. Puede crear una configuración separada para cada proyecto.
  • Utilice varias cuentas. Por ejemplo, una cuenta de usuario y una cuenta de servicio.
  • Realizar una variedad de tareas independientes (trabajar en una aplicación de App Engine en un proyecto, administrar un clúster de Compute Engine en la zona us-central-1a, administrar las configuraciones de red para la región asia-east-1, etc.)

Para cambiar entre configuraciones, ejecute el siguiente comando: 

gcloud config configurations activate CONFIGURATION_NAME

Para obtener más información sobre cómo administrar configuraciones, consulta gcloud config configurations .

¿Qué sigue?