Google Cloud CLI 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 CLI de gcloud forma parte de Google Cloud CLI y es una herramienta de línea de comandos unificada que incluye funciones como el autocompletado de declaraciones, la actualización in situ y la ayuda de la línea de comandos, formatos de salida legibles y procesables, además de integración en Google Cloud CLI.
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 Google Cloud CLI. - 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 Google Cloud CLI 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 Google Cloud CLI, 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, Google Cloud CLI 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:
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
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:
Quita los metadatos:
gcloud compute project-info remove-metadata \ --keys=google-compute-default-region,google-compute-default-zone
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 CLI 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
- Sigue la guía de inicio rápido para Google Cloud CLI.
- Revisa las sugerencias de uso de
gcloud compute
. - Descubre los comandos comunes de
gcloud compute
.