Configurer votre environnement

Cette page vous guide à travers les étapes de configuration requises pour utiliser l'API Cloud Spanner avec la Google Cloud CLI, les bibliothèques clientes et les pilotes Spanner.

Si vous souhaitez utiliser Spanner avec la console Google Cloud, consultez le guide de démarrage rapide avec la console.

Configurer un projet Google Cloud

1. Accédez à la page Projets de la console Google Cloud.

   Accéder à la page Projets

2. Créez un projet Google Cloud ou ouvrez un projet existant en cliquant sur son nom.
Important: Le nom que vous utilisez doit comporter entre 4 et 30 caractères. Lorsque vous le saisissez, le formulaire suggère un ID de projet que vous pouvez modifier. L'ID de projet utilisé doit comporter entre 6 et 30 caractères, et commencer par une lettre minuscule. Vous pouvez utiliser un tiret, une lettre minuscule ou un chiffre pour chacun des autres caractères, mais le dernier caractère ne peut pas être un tiret. N'oubliez pas que certains identifiants de ressources (tels que les ID de projet) peuvent être conservés au-delà de la durée de vie du projet. Par conséquent, évitez de stocker des informations sensibles dans des identifiants de ressources.
...consulter les consignes d'attribution de noms

3. Ouvrez une fenêtre de terminal et définissez votre projet comme projet par défaut pour la Google Cloud CLI. Pour ce faire, remplacez MY_PROJECT_ID par l'ID de votre projet (et non pas son nom) dans la commande suivante :

   gcloud config set project MY_PROJECT_ID

4. Make sure that billing is enabled for your Google Cloud project.

Vous pouvez également obtenir plus d'informations sur la tarification de Spanner.

5. Activez l'API Cloud Spanner pour le projet.

   Activer l'API Cloud Spanner

   Remarque: Si vous utilisez un compte de service dans un autre projet pour accéder à votre instance Spanner, vous devez activer l'API Spanner dans les deux projets.

Configurer l'authentification

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

Pour configurer la gcloud CLI afin qu'elle utilise l'emprunt d'identité d'un compte de service pour s'authentifier auprès des Google APIs plutôt que d'utiliser vos identifiants utilisateur, exécutez la commande suivante :

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Pour en savoir plus, consultez Emprunt d'identité d'un compte de service.

Terraform

Pour utiliser le code Terraform dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application avec vos identifiants utilisateur.

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.

Pour en savoir plus, consultez Set up authentication for a local development environment.

Bibliothèques clientes

Pour utiliser des bibliothèques clientes dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application avec vos identifiants utilisateur.

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.

Pour en savoir plus, consultez Set up authentication for a local development environment.

Pour configurer votre fichier ADC local afin d'utiliser l'emprunt d'identité de compte de service pour vous authentifier auprès des Google APIs plutôt que vos identifiants utilisateur, exécutez la commande suivante :

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

Pour en savoir plus, consultez Emprunt d'identité d'un compte de service.

REST

Pour utiliser l'API REST dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

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

gcloud init

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Vous pouvez utiliser l'emprunt d'identité de compte de service pour générer un jeton d'accès pour les requêtes API REST. Pour en savoir plus, consultez la section Compte de service dont l'identité est empruntée.

Exécuter la Google Cloud CLI

Maintenant que vous avez configuré l'environnement de développement et l'authentification, exécutez l'outil de ligne de commande gcloud pour interagir avec Spanner:

gcloud spanner instance-configs list

La liste des configurations d'instance Spanner auxquelles votre projet a accès doit s'afficher. Elle inclut les configurations régionales, birégionales et multirégionales. Pour en savoir plus, consultez la présentation des instances.

Vous avez terminé la configuration.

Étape suivante

Découvrez comment utiliser les bibliothèques clientes Cloud et les pilotes pour créer une instance, une base de données, des tables et des index Spanner. Ensuite, stockez, interrogez et lisez des données dans Spanner.

• Premiers pas avec Spanner en C++
• Premiers pas avec Spanner en C#
• Premiers pas avec Spanner en Go
• Premiers pas avec Spanner en Java
• Premiers pas avec Spanner en JDBC
• Premiers pas avec Spanner en Node.js
• Premiers pas avec Spanner en PHP
• Premiers pas avec Spanner en Python
• Premiers pas avec Spanner en Ruby
• Premiers pas avec Spanner en REST
• Premiers pas avec Spanner dans gcloud

Envoyer des commentaires