Cómo configurar tu entorno

En esta página, se explican los pasos de configuración necesarios para usar la API de Cloud Spanner con Google Cloud CLI, 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.

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 de Google Cloud nuevo o haz clic en el nombre del proyecto para abrir uno existente.
  3. Abre una ventana de la terminal, configura tu proyecto como el proyecto predeterminado para Google Cloud CLI y reemplaza MY_PROJECT_ID por el ID de tu proyecto (no el nombre de tu proyecto):

    gcloud config set project MY_PROJECT_ID
  4. Make sure that billing is enabled for your Google Cloud project.

  5. También puedes obtener más información sobre los precios de Spanner.
  6. 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

Select the tabs for how you plan to access the API:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

A fin de configurar la CLI de gcloud para usar la identidad temporal como cuenta de servicio y autenticarse en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el siguiente comando:

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 el código de Terraform en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Para obtener más información, consulta Set up authentication for a local development environment.

Bibliotecas cliente

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

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Para obtener más información, consulta Set up authentication for a local development environment.

Si deseas configurar tu archivo ADC local para usar la identidad temporal como cuenta de servicio a fin de 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 proporcionas a gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

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

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

Ejecuta Google Cloud CLI

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

gcloud spanner instance-configs list

Deberías ver una lista de las opciones de configuración de las instancias de Spanner a las que puede acceder tu proyecto, lo que incluye 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 de Cloud y los controladores para crear una instancia, una base de datos, índices y tablas de Spanner. Luego, almacena, consulta y lee datos en Spanner.