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 a usar tus credenciales de cuenta de usuario para acceder a Google Cloud, o te permite seleccionar una cuenta si ya tienes una autorización de acceso previa.
- Establece una configuración de gcloud CLI y un conjunto base de propiedades, que incluye 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]
|
Crea y administra parámetros de configuración y propiedades de gcloud CLI. |
Inicializa gcloud CLI
Para inicializar gcloud CLI, 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 inicializas 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 el acceso, debes copiar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir las instrucciones proporcionadas.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.
Para ver las propiedades configuradas a través del 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.
- Si deseas obtener más información sobre la autorización de 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 obtener más información sobre cómo administrar parámetros de configuración, consulta los parámetros de configuración de la CLI de gcloud.
- Para obtener más información sobre cómo administrar propiedades, consulta las propiedades de gcloud CLI.