En esta página, se muestra cómo inicializar gcloud CLI.
Después de instalar la CLI de gcloud, ejecuta gcloud init
para realizar las tareas de configuración inicial. También puedes ejecutar gcloud init
para cambiar los parámetros de configuración o crear uno nuevo.
gcloud init
realiza los siguientes pasos de configuración:
- Autoriza a gcloud CLI para usar tu credenciales de cuenta de usuario para acceder a Google Cloud, o te permite si ya autorizaste el acceso
- Establece una configuración de gcloud CLI. y establece un conjunto base de propiedades, que incluye la cuenta activa del paso anterior, el proyecto actual y, si aplicable, la región y la zona predeterminadas de Compute Engine
Puedes ejecutar lo siguiente como alternativas a gcloud init
:
Comando | Descripción |
---|---|
gcloud auth login
|
Autoriza una cuenta de usuario sin establecer una configuración. |
gcloud auth activate-service-account
|
Autoriza una cuenta de servicio en lugar de una de usuario. Es útil para autorizar de forma no interactiva y sin un navegador web. |
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
|
Crea y administra propiedades y configuraciones de la CLI de gcloud. |
Inicializa la CLI de gcloud
Para inicializar la CLI de gcloud, haz lo siguiente:
Ejecuta
gcloud init
:gcloud init
Si te encuentras 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 el navegador, si es necesario:gcloud init --no-launch-browser
Crea o selecciona una configuración si se te solicita.
Si estás inicializando una nueva instalación de gcloud CLI,
gcloud init
crea una configuración llamadadefault
para ti y establece que la configuración activa. Si tienes configuraciones existentes,gcloud init
te indica que elijas entre tres opciones: volver a inicializar la activa, cambiar a otra y volver a inicializarla o crear una nueva.Completa el paso de autorización cuando se te solicite.
Según si has autorizado previamente el acceso a Google Cloud, es posible que se te solicite que accedas y que concedas acceso en un navegador web, o que selecciones una cuenta existente.
Si usaste la marca
--no-launch-browser
y es necesario el acceso, debes copiar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir los mensajes que aparecen.Cuando se completa este paso,
gcloud init
establece la propiedadaccount
en la configuración de la cuenta especificada.Elige un proyecto actual de Google Cloud si se te solicita.
Si solo tienes acceso a un proyecto, incluido el proyecto predeterminado para tu cuenta de usuario,
gcloud init
lo selecciona automáticamente.De lo contrario, puedes seleccionar un proyecto de una lista de proyectos para los cuales tienes permisos de propietario, editor o visualizador.
gcloud init
establece la propiedadproject
en la configuración de la propiedad que elijas. Si tienes acceso a más de 200 proyectos, se te pedirá que ingreses un ID del proyecto, que crees un proyecto nuevo o enumeres 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:
Elige una zona predeterminada de Compute Engine, si se te solicita.
Si no tienes habilitada la API de Compute Engine o ya tienes una zona predeterminada en tus metadatos a nivel del proyecto, no verás este paso.
gcloud init
establece las propiedadesregion
yzone
en el de Terraform con la zona que elijas.
Para ver las propiedades establecidas con 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
¿Qué sigue?
- Para obtener más información sobre la autorización de herramientas, consulta Autoriza 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 cliente de Cloud (y las bibliotecas cliente de las APIs de Google), consulta Cómo proporcionar credenciales para ADC.
- Para más información sobre la administración de configuraciones, consulta Configuración de la CLI de gcloud.
- Para obtener más información sobre la administración de propiedades, consulta Propiedades de la CLI de gcloud.