gcloud compute


La herramienta de línea de comandos de gcloud te permite administrar los 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 herramienta de gcloud forma parte del SDK de Cloud y es una herramienta de línea de comandos unificada que incluye funciones como el autocompletado de declaraciones, la actualización local, la ayuda de la línea de comandos, los formatos de resultado legibles y procesables, además de la integración con el SDK de Cloud.

Si nunca usaste Compute Engine, comienza con la guía de inicio rápido de Linux o la guía de inicio rápido de Windows.

Antes de comenzar

  • Si deseas ejecutar gcloud compute en un símbolo del sistema, instala, actualiza e inicializa el SDK de Cloud.
  • Si no tienes un símbolo del sistema disponible, intenta usar gcloud compute en Cloud Shell. Cloud Shell se instala, actualiza e inicializa de manera automática con el SDK de Cloud más reciente.

Propiedades predeterminadas

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

gcloud compute project-info describe --project PROJECT_ID

Reemplaza PROJECT_ID con el ID del proyecto.

Proyecto predeterminado

Si configuras un proyecto predeterminado cuando configuras y, luego, inicializas el SDK de Cloud, todos los comandos de gcloud compute usan ese ID del proyecto de forma predeterminada.

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

  • Ejecuta cada comando gcloud compute con la marca --project
  • Configura la variable de entorno CLOUDSDK_CORE_PROJECT.

    Linux y macOS

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

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto que deseas usar como el predeterminado.

    Desconfigura variables de entorno del proyecto

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

    unset CLOUDSDK_CORE_PROJECT
    

    Windows

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

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto que deseas usar como el predeterminado.

    Desconfigura variables de entorno del proyecto

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

    set CLOUDSDK_CORE_PROJECT=
    

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

Región y zona predeterminadas

Algunos comandos gcloud compute requieren marcas --region o --zone. En lugar de especificar estas marcas cada vez que ejecutes comandos, puedes establecer una región y zona predeterminadas para tu proyecto. Si no configuras una región o una zona predeterminada y ejecutas un comando de región o zona, la herramienta de línea de comandos de gcloud podría solicitar que proporciones una marca --region o --zone, o mostrar un error.

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

  • En el servidor de metadatos. La región y la zona predeterminadas establecidas 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 el cliente local anulan las establecidas en el servidor de metadatos.
  • En las variables de entorno. La región y la zona predeterminadas establecidas en las variables de entorno anulan la región y zona predeterminadas del cliente local y el servidor de metadatos.

Puedes anular la región y zona predeterminadas en el servidor de metadatos, en el cliente local o en las variables de entorno si proporcionas las marcas --region y --zone cuando ejecutas comandos.

Visualiza 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 establece ninguna región o zona predeterminada.

Visualiza las regiones y zonas disponibles

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

gcloud compute regions list
gcloud compute zones list

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

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

  1. Establece 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

Puedes anular la región y zona predeterminadas en el servidor de metadatos si las configuras en el cliente local, si estableces la región y zona predeterminadas en las variables de entorno o si incluyes la marca --zone o --region en tus comandos.

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

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

  1. Quita los metadatos:

    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

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

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

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

gcloud config set compute/region REGION
gcloud config set compute/zone ZONE

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

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

gcloud config unset compute/zone
gcloud config unset compute/region

Puedes anular la región y zona predeterminadas establecidas en el cliente local si configuras la región y zona predeterminadas en las variables de entorno o si incluyes la marca --zone o --region en tus comandos.

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

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

Linux y macOS

Usa el comando export para establecer las variables de región y zona.

export CLOUDSDK_COMPUTE_REGION=REGION
export CLOUDSDK_COMPUTE_ZONE=ZONE

Para hacer que estas variables de entorno sean permanentes, incluye estos comandos en el archivo ~/.bashrc y reinicia la terminal.

Windows

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

set CLOUDSDK_COMPUTE_REGION=REGION
set CLOUDSDK_COMPUTE_ZONE=ZONE

Puedes anular las variables de entorno si incluyes la marca --zone o --region en tus comandos.

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

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

Linux y macOS

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

unset CLOUDSDK_COMPUTE_REGION
unset CLOUDSDK_COMPUTE_ZONE

Windows

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

set CLOUDSDK_COMPUTE_REGION=
set CLOUDSDK_COMPUTE_ZONE=

Anula la zona predeterminada con marcas

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

Por ejemplo:

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

Configuraciones

Las gcloud topic configurations son una función avanzada que puedes usar para influir en el comportamiento de la herramienta de gcloud. Para la mayoría de los usuarios, basta con usar las opciones de configuración predeterminadas.

Las opciones de configuración pueden ser útiles para los usuarios que realizan las siguientes tareas:

  • Trabajan con varios proyectos. Puedan crear una configuración distinta para cada proyecto.
  • Usan varias cuentas. Por ejemplo, una cuenta de usuario y una de servicio.
  • Realizan varias tareas independientes (trabajan en una app de App Engine en un proyecto, administran un clúster de Compute Engine en la zona us-central-1a, administran las opciones de configuración de red para la región asia-east-1, etcétera).

Para alternar entre los parámetros de configuración, ejecuta el siguiente comando:

gcloud config configurations activate CONFIGURATION_NAME

Para obtener más información sobre la administración de configuraciones, consulta gcloud config configurations.

Próximos pasos