En esta página se explica cómo inicializar gcloud CLI.
Después de instalar gcloud CLI, realiza las tareas de configuración inicial ejecutando gcloud init
. También puedes ejecutar gcloud init
para cambiar los ajustes o crear una nueva configuración.
gcloud init
sigue estos pasos de configuración:
- Autoriza a la CLI de gcloud a usar las credenciales de tu cuenta de usuario para acceder a Google Cloudo te permite seleccionar una cuenta si ya has autorizado el acceso.
- Configura una configuración de la CLI de gcloud y establece un conjunto básico de propiedades, incluidas la cuenta activa del paso anterior, el proyecto actual y, si procede, la región y la zona predeterminadas de Compute Engine.
Puedes ejecutar lo siguiente como alternativa a gcloud init
:
Comando | Descripción |
---|---|
gcloud auth login
|
Autorizar con una cuenta de usuario sin configurar nada. |
gcloud auth activate-service-account
|
Autoriza con una cuenta de servicio en lugar de con una cuenta de usuario. Útil para autorizar de forma no interactiva y sin un navegador web. |
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
|
Crea y gestiona configuraciones y propiedades de la CLI de gcloud. |
Inicializar la CLI de gcloud
Para inicializar gcloud CLI, haz lo siguiente:
Ejecuta
gcloud init
:gcloud init
Si estás en una sesión de terminal remota, puedes usar la marca
--no-launch-browser
para evitar que el comando inicie un flujo de autorización basado en navegador, si es necesario:gcloud init --no-launch-browser
Crea o selecciona una configuración si se te pide.
Si estás inicializando una nueva instalación de la CLI de gcloud,
gcloud init
crea una configuración llamadadefault
y la establece como configuración activa. Si ya tienes configuraciones,gcloud init
te pedirá que elijas entre tres opciones: reinicializar la activa, cambiar a otra y reinicializarla, o crear una nueva.Completa el paso de autorización cuando se te solicite.
En función de si has autorizado previamente el acceso aGoogle Cloud, es posible que se te pida que inicies sesión y concedas acceso en un navegador web o que selecciones una cuenta.
Si ha usado la marca
--no-launch-browser
y se requiere iniciar sesión, debe copiar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir las indicaciones.Cuando se completa este paso,
gcloud init
define la propiedadaccount
en la configuración de la cuenta especificada.Elige un proyecto actual Google Cloud si se te solicita.
Si solo tienes acceso a un proyecto, incluido el proyecto predeterminado de tu cuenta de usuario,
gcloud init
lo selecciona automáticamente.De lo contrario, puede seleccionar un proyecto de una lista de proyectos en los que tenga permisos de propietario, editor o lector.
gcloud init
asigna la propiedadproject
de la configuración a la propiedad que elijas. Si tienes acceso a más de 200 proyectos, se te pedirá que introduzcas un ID de proyecto, que crees un proyecto o que muestres una lista de proyectos.This account has a lot of projects! Listing them all can take a while. [1] Enter a project ID [2] Create a new project [3] List projects Please enter your numeric choice:
Si se te pide, elige una zona de Compute Engine predeterminada.
Si no tienes habilitada la API de Compute Engine o ya tienes una zona predeterminada en los metadatos a nivel de proyecto, no verás este paso.
gcloud init
define las propiedadesregion
yzone
en la configuración mediante la zona que elijas.
Para ver las propiedades definidas mediante el comando gcloud init
, usa el comando gcloud config list
.
[compute] region = us-east1 zone = us-east1-b [core] account = dana@example.com disable_usage_reporting = False project = example-project
Siguientes pasos
- Para obtener más información sobre la autorización de herramientas, consulta Autorizar la CLI de gcloud.
- Para obtener más información sobre cómo autorizar las credenciales predeterminadas de la aplicación (ADC) para las bibliotecas de cliente de Cloud (y las bibliotecas de cliente de las APIs de Google), consulta el artículo Configurar credenciales predeterminadas de la aplicación.
- Para obtener más información sobre cómo gestionar las configuraciones, consulta Configuraciones de la CLI de gcloud.
- Para obtener más información sobre cómo gestionar propiedades, consulta Propiedades de la CLI de gcloud.