Cómo inicializar el SDK de Cloud

Esta página muestra cómo inicializar el SDK de Google Cloud.

Luego de que instales el SDK de Cloud, el paso siguiente generalmente es ejecutar el comando gcloud init para realizar las tareas de configuración inicial. Más adelante también puedes ejecutar gcloud init para cambiar tu configuración o para crear una nueva.

gcloud init realiza los pasos de configuración a continuación:

• Autoriza a las herramientas del SDK de Cloud para que usen tus credenciales de cuenta de usuario a fin de acceder a Google Cloud Platform, o te permite seleccionar una cuenta si ya tienes una autorización de acceso previa.
• Establece una configuración del SDK de Cloud y fija 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 Google 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. Útil para la autorización no interactiva y sin un navegador web.
gcloud config [COMMAND] gcloud config configurations [COMMAND]	Crea y administra propiedades y configuraciones del SDK de Cloud.

Ejecuta gcloud init

Para inicializar el SDK de Cloud, haz lo siguiente:

1. Ejecuta gcloud init:

   gcloud init
   

   Si estás en una sesión de terminal remota, puedes usar la marca --console-only para evitar que el comando lance un flujo de autorización basado en navegador, si corresponde:

   gcloud init --console-only
   

2. Crea o selecciona una configuración si se te solicita.

   Si estás inicializando una instalación nueva del SDK de Cloud, gcloud init crea una nueva llamada default para ti y la establece con la configuración activa. Si tienes configuraciones existentes, gcloud init te solicita que elijas entre tres opciones: volver a inicializar la activa, cambiar a otra y volver a inicializarla, o crear una nueva.

3. Completa el paso de autorización cuando se te solicite.

   Dependiendo de si has autorizado previamente el acceso a Cloud Platform, se te puede solicitar que accedas y que concedas acceso en un navegador web, o que selecciones una cuenta existente.

   Si usaste la marca --console-only y es necesario el acceso, debes entonces cortar y pegar la URL de autorización proporcionada en otra ventana del navegador y seguir los mensajes proporcionados.

   Cuando se completa este paso, gcloud init establece la propiedad account en la configuración de la cuenta especificada.

4. Elige un proyecto actual de Cloud Platform, si se te solicita.

   Si solo tienes acceso a un proyecto, incluido el proyecto predeterminado para tu cuenta de usuario, gcloud init lo selecciona por ti. De lo contrario, puedes seleccionar un proyecto de una lista de proyectos para los que tengas permisos de Propietario, Editor o Lector. gcloud init establece la propiedad project en la configuración de la propiedad que hayas elegido.

5. Elige una zona predeterminada de Google 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 de proyecto, no verás este paso. gcloud init establece las propiedades region y zone en la configuración mediante la zona que selecciones.

Cuando gcloud init finaliza, imprime las propiedades en la configuración activa en la terminal:

[compute]
region = us-east1
zone = us-east1-b
[core]
account = [e-mail]
disable_usage_reporting = False
project = example-project

Puedes ver estas propiedades en cualquier otro momento con el comando gcloud config list.

¿Qué sigue?

• Lee Cómo autorizar las herramientas del SDK de Cloud para obtener más información sobre la autorización de herramientas.
• Lee Configuraciones del SDK de Cloud para obtener más información sobre las configuraciones.
• Lee las Propiedades del SDK de Cloud para obtener más información sobre las configuraciones.