Esta página le muestra cómo inicializar la CLI de gcloud.
Después de instalar la CLI de gcloud, ejecute gcloud init
para la configuración inicial. También puede ejecutar gcloud init
para cambiar la configuración o crear una nueva.
gcloud init
realiza los siguientes pasos de configuración:
- Autoriza a la CLI de gcloud a utilizar las credenciales de su cuenta de usuario para acceder Google Cloud, o le permite seleccionar una cuenta si ha autorizado previamente el acceso
- Establece una configuración CLI de gcloud y establece un conjunto base de propiedades , incluida la cuenta activa del paso anterior, el proyecto actual y, si corresponde, la región y zona predeterminadas de Compute Engine.
Puede ejecutar lo siguiente como alternativa a gcloud init
:
Dominio | Descripción |
---|---|
gcloud auth login | Autorizar con una cuenta de usuario sin configurar ninguna configuración. |
gcloud auth activate-service-account | Autorizar con una cuenta de servicio en lugar de una cuenta de usuario. Útil para autorizar de forma no interactiva y sin navegador web. |
gcloud config [COMMAND] gcloud config configurations [COMMAND] | Crear y administrar configuraciones y propiedades de gcloud CLI. |
Inicializar la CLI de gcloud
Para inicializar la CLI de gcloud:
Ejecute
gcloud init
:gcloud init
Si está en una sesión de terminal remota, puede usar el indicador
--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
Cree o seleccione una configuración si se le solicita.
Si está inicializando una nueva instalación de gcloud CLI,
gcloud init
crea una configuracióndefault
y la establece como activa. Si ya tiene configuraciones,gcloud init
le pedirá que elija entre tres opciones: reinicializar la activa, cambiar a otra y reinicializarla, o crear una nueva.Complete el paso de autorización cuando se le solicite.
Dependiendo de si usted ha autorizado previamente el acceso aGoogle CloudEs posible que se le solicite iniciar sesión y otorgar acceso en un navegador web o seleccionar una cuenta existente.
Si utilizó el indicador
--no-launch-browser
y se requiere iniciar sesión, deberá 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 una corriente Google Cloud proyecto si se le solicita.
Si solo tiene acceso a un proyecto, incluido el proyecto predeterminado para su cuenta de usuario,
gcloud init
lo selecciona por usted.De lo contrario, puede seleccionar un proyecto de una lista de proyectos para los que tenga permisos de Propietario , Editor o Visualizador .
gcloud init
establece la propiedadproject
en la configuración con la que elija. Si tiene acceso a más de 200 proyectos, se le solicitará que introduzca un ID de proyecto, cree un nuevo proyecto o enumere los 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:
Elija una zona de Compute Engine predeterminada si se le solicita.
Si no tiene habilitada la API de Compute Engine o ya tiene una zona predeterminada en los metadatos a nivel de proyecto , no verá este paso.
gcloud init
establece las propiedadesregion
yzone
en la configuración usando la zona que elija.
Para ver las propiedades establecidas a través del comando gcloud init
, utilice el comando gcloud config list
.
[compute] region = us-east1 zone = us-east1-b [core] account = [email protected] disable_usage_reporting = False project = example-project
¿Qué sigue?
- Para obtener más información sobre la autorización de herramientas, consulte Autorización de 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 API de Google), consulte Configurar las credenciales predeterminadas de la aplicación .
- Para obtener más información sobre cómo administrar configuraciones, consulte Configuraciones de CLI de gcloud .
- Para obtener más información sobre cómo administrar propiedades, consulte Propiedades de la CLI de gcloud .