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:
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
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:
Metadatos sin definir:
gcloud compute project-info remove-metadata \ --keys=google-compute-default-region,google-compute-default-zone
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
- Sigue la guía de inicio rápido de la CLI de Google Cloud.
- Consulta los consejos de uso de
gcloud compute
. - Descubre los comandos
gcloud compute
habituales.