En esta página, se muestra cómo inicializar gcloud CLI.
Después de instalar gcloud CLI, ejecuta gcloud init
para realizar las tareas de configuración iniciales. También puedes ejecutar gcloud init
para cambiar la configuración o crear una nueva.
gcloud init
realiza los siguientes pasos de configuración:
- Autoriza a gcloud CLI para que use las credenciales de tu cuenta de usuario a fin de acceder a Google Cloud, o te permite seleccionar una cuenta si ya autorizaste el acceso.
- Establece una configuración de gcloud CLI y establece un conjunto base de propiedades, incluida la cuenta activa del paso anterior, el proyecto actual y, si corresponde, la zona y la región 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]
|
Crear y administrar propiedades y parámetros de configuración de gcloud CLI. |
Inicializa gcloud CLI
Para inicializar gcloud CLI:
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 instalación nueva de gcloud CLI,
gcloud init
crea una configuración llamadadefault
y la establece como 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 se requiere acceso, debes copiar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir las instrucciones.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 si ya tienes una zona predeterminada en tus metadatos a nivel de proyecto, no verás este paso.
gcloud init
establece las propiedadesregion
yzone
en la configuración con la zona que elijas.
Cuando gcloud init
finaliza, imprime las propiedades de la configuración activa en la terminal:
[compute] region = us-east1 zone = us-east1-b [core] account = user@google.com disable_usage_reporting = False project = example-project
Puedes ver estas propiedades en cualquier otro momento con el comando gcloud config list
.
¿Qué sigue?
- Para obtener más información sobre la autorización de herramientas, consulta Autoriza la CLI de gcloud.
- Si deseas obtener más información sobre la autorización de credenciales predeterminadas de la aplicación (ADC) para las bibliotecas cliente de Cloud (y las bibliotecas cliente de la API de Google), consulta Cómo proporcionar credenciales para ADC.
- Para obtener más información sobre la administración de configuraciones, consulta las configuraciones de la CLI de gcloud.
- Si quieres obtener más información para administrar propiedades, consulta las propiedades de la CLI de gcloud.