Cómo configurar tu entorno

En esta página, se describen los pasos de configuración necesarios para usar la API de Cloud Spanner con la CLI de Google Cloud, las bibliotecas cliente y los controladores de Spanner.

Si deseas usar Spanner con la consola de Google Cloud , consulta la guía de inicio rápido para usar la consola.

Roles obligatorios

Para obtener los permisos que necesitas para usar bases de datos de Spanner y, también, interactuar con ellas, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Configura un proyecto de Google Cloud

  1. Ve a la página Proyectos en la consola de Google Cloud .

    Ir a la página Proyectos

  2. Crea un proyecto Google Cloud nuevo o abre uno existente haciendo clic en el nombre del proyecto.

  3. Abre una ventana de terminal y configura tu proyecto como el proyecto predeterminado para Google Cloud CLI. Para ello, reemplaza MY_PROJECT_ID por el ID de tu proyecto (no el nombre): 

    gcloud config set project MY_PROJECT_ID

  4. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

    5. También puedes obtener más información sobre los precios de Spanner.

  5. Habilita la API de Cloud Spanner para el proyecto.

    Habilitar la API de Cloud Spanner.

    Nota: Si usas una cuenta de servicio en un proyecto diferente para acceder a tu instancia de Spanner, debes habilitar la API de Spanner en ambos proyectos.

Configura la autenticación

Selecciona las pestañas según cómo planeas acceder a la API:

Console

Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

gcloud

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

gcloud init

Para configurar la gcloud CLI con el objetivo de usar la identidad temporal como cuenta de servicio y autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el comando siguiente: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Para obtener más información, consulta Identidad temporal como cuenta de servicio.

Terraform

Para usar código de Terraform en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.

  2. Configura gcloud CLI para usar tu identidad federada.

    Para obtener más información, consulta Accede a gcloud CLI con tu identidad federada.

  3. Crea credenciales de autenticación locales para tu cuenta de usuario: 

    gcloud auth application-default login

    Si se devuelve un error de autenticación, confirma que accediste a gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

Bibliotecas cliente

Para usar bibliotecas cliente en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.

  2. Configura gcloud CLI para usar tu identidad federada.

    Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

  3. Crea credenciales de autenticación locales para tu cuenta de usuario: 

    gcloud auth application-default login

    Si se devuelve un error de autenticación, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

Para configurar tu archivo ADC local con el objetivo de usar la identidad temporal como cuenta de servicio y autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando: 

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Para obtener más información, consulta Identidad temporal como cuenta de servicio.

REST

Para usar la API de REST en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

    Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Puedes usar la identidad temporal como cuenta de servicio y generar un token de acceso para solicitudes a la API de REST. Para obtener más información, consulta Cuenta de servicio con identidad temporal.

Ejecuta Google Cloud CLI

Ahora que configuraste el entorno de desarrollo y la autenticación, ejecuta la herramienta de línea de comandos de gcloud para interactuar con Spanner:

gcloud spanner instance-configs list

Deberías ver una lista de las configuraciones de instancias de Spanner a las que puede acceder tu proyecto, incluidas las configuraciones regionales, birregionales y multirregionales. Para obtener más información, consulta la descripción general de las instancias.

Terminaste la configuración.

¿Qué sigue?

Aprende a usar las bibliotecas cliente y los controladores de Cloud para crear una instancia, una base de datos, tablas e índices de Spanner. Luego, almacena, consulta y lee datos en Spanner.