gcloud compute

Google Cloud CLI te permite gestionar tus recursos de Compute Engine mediante el grupo de comandos gcloud compute. gcloud compute es una alternativa a la API Compute Engine.

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

Si nunca has usado Compute Engine, empieza con la guía de inicio rápido de Linux o la guía de inicio rápido de Windows.

Antes de empezar

  • Si quieres ejecutar gcloud compute en una petición de comando, instala, actualiza e inicializa la CLI de Google Cloud.
  • Si no tienes un símbolo del sistema disponible, prueba a usar gcloud compute en Cloud Shell. Cloud Shell se instala, actualiza e inicializa automáticamente con la versión más reciente de Google Cloud CLI.

Propiedades predeterminadas

Cuando creas una instancia de máquina virtual, Compute Engine configura una VM con las propiedades predeterminadas del servidor de metadatos. Para consultar las propiedades predeterminadas de tu VM, ejecuta el siguiente comando:

gcloud compute project-info describe --project PROJECT_ID

Sustituye PROJECT_ID por el ID del proyecto.

Proyecto predeterminado

Si defines un proyecto predeterminado al configurar e inicializar la CLI de Google Cloud, todos los comandos gcloud compute usarán ese ID de proyecto de forma predeterminada.

Puedes anular el ID de proyecto predeterminado con uno de los siguientes métodos:

  • Ejecuta cada comando gcloud compute con la marca --project.

  • Definir la variable de entorno CLOUDSDK_CORE_PROJECT

    Linux y macOS

    Usa el comando export para definir la variable de entorno del proyecto.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Sustituye PROJECT_ID por el ID del proyecto que quieras usar como predeterminado.

    Eliminar variables de entorno de un proyecto

    Si necesitas anular las variables de entorno de tu proyecto, usa los siguientes comandos de unset:

    unset CLOUDSDK_CORE_PROJECT

    Windows

    Usa el comando set para definir la variable de entorno del proyecto.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID

    Sustituye PROJECT_ID por el ID del proyecto que quieras usar como predeterminado.

    Eliminar variables de entorno de un proyecto

    Si necesitas anular las variables de entorno de tu proyecto, usa el siguiente comando:

    set CLOUDSDK_CORE_PROJECT=

Si no defines 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 de gcloud compute requieren las marcas --region o --zone. En lugar de especificar estas marcas cada vez que ejecutes comandos, puedes definir una región y una zona predeterminadas para tu proyecto. Si no defines una región o una zona predeterminadas y ejecutas un comando que depende de una región o una zona, la CLI de Google Cloud puede pedirte que proporciones una marca --region o --zone, o devolver un error.

Puedes definir la región y la zona predeterminadas de tres formas:

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

Puedes anular la región y la zona predeterminadas en el servidor de metadatos, en tu cliente local o en las variables de entorno. Para ello, proporciona las marcas --region y --zone al ejecutar los comandos.

Ver la región y la zona predeterminadas

Para ver tu región y zona predeterminadas, ejecuta los siguientes comandos:

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

Si el resultado es (unset), no se ha definido ninguna región ni zona predeterminadas.

Ver las regiones y zonas disponibles

Para ver una lista de regiones y zonas, ejecuta los siguientes comandos:

gcloud compute regions list
 
gcloud compute zones list

Definir la región y la zona predeterminadas en el servidor de metadatos

La región y la zona predeterminadas del servidor de metadatos se aplican a todas las configuraciones de tu proyecto. Para definir la región y la zona predeterminadas en el servidor de metadatos, sigue estos pasos:

  1. Define la región y la 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. Inicializa el cambio en tu cliente local:

    gcloud init

Para anular la región y la zona predeterminadas definidas en el servidor de metadatos, puedes definir la región y la zona predeterminadas en tu cliente local, definir la región y la zona predeterminadas en variables de entorno o incluir la marca --zone o --region en tus comandos.

Anular la región y la zona predeterminadas en el servidor de metadatos

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

  1. Metadatos sin definir:

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

  2. Inicializa el cambio en tu cliente local:

    gcloud init

Definir la región y la zona predeterminadas en el cliente local

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

Para definir la región y la zona predeterminadas en tu cliente local, ejecuta los siguientes comandos:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Anular la región y la zona predeterminadas en el cliente local

Para anular la región o la zona predeterminadas en tu cliente local, ejecuta los siguientes comandos:

gcloud config unset compute/zone

gcloud config unset compute/region

Puedes anular la región y la zona predeterminadas definidas en tu cliente local configurando la región y la zona predeterminadas en variables de entorno o incluyendo la marca --zone o --region en tus comandos.

Definir la región y la zona predeterminadas en las variables de entorno

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

Linux y macOS

Usa el comando export para definir 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, incluye estos comandos en tu archivo ~/.bashrc y reinicia la terminal.

Windows

Usa el comando set para definir las variables de región y zona.

set CLOUDSDK_COMPUTE_REGION=REGION

set CLOUDSDK_COMPUTE_ZONE=ZONE

Puedes anular las variables de entorno incluyendo las marcas --zone o --region en tus comandos.

Anular la región y la zona predeterminadas en las variables de entorno

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

Linux y macOS

Para anular las variables de entorno de la región y la zona, usa los siguientes comandos unset:

unset CLOUDSDK_COMPUTE_REGION

unset CLOUDSDK_COMPUTE_ZONE

Windows

Para anular las variables de entorno de región y zona, usa los siguientes comandos:

set CLOUDSDK_COMPUTE_REGION=

set CLOUDSDK_COMPUTE_ZONE=

Anular la zona predeterminada con marcas

Usa la marca --zone para anular la zona predeterminada definida en el servidor de metadatos, tu cliente local y las variables de entorno.

Por ejemplo:

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

Configuraciones

gcloud topic configurations son una función avanzada que puedes usar para influir en el comportamiento de la CLI de gcloud. Para la mayoría de los usuarios, es suficiente con usar las configuraciones predeterminadas.

Las configuraciones pueden ser útiles para los usuarios que:

  • Trabajar con varios proyectos. Puedes crear una configuración independiente para cada proyecto.
  • Utiliza varias cuentas. Por ejemplo, una cuenta de usuario y una cuenta de servicio.
  • Realizar varias 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, gestionar las configuraciones de red de la región asia-east-1, etc.)

Para cambiar de una configuración a otra, ejecuta el siguiente comando:

gcloud config configurations activate CONFIGURATION_NAME

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

Siguientes pasos