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.

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 la región y la zona predeterminadas de tu configuración, 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_CORE_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_CORE_PROJECT=
set CLOUDSDK_COMPUTE_ZONE=

Anula la región y la zona predeterminadas con marcas

Usa las marcas --region y --zone para anular la región y zona predeterminadas en el servidor de metadatos, el cliente local y las variables de entorno.

Por ejemplo:

gcloud compute instances create example-instance \
    --region=REGION \
    --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