Connexion depuis Cloud Run

Connexion depuis Cloud Run

Cette page vous explique comment déployer un exemple d'application sur un service Cloud Run à l'aide de la console Google Cloud et d'une application cliente. Cet exemple d'application connecte Cloud Run à AlloyDB pour PostgreSQL.

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Activez les API Cloud nécessaires pour exécuter un exemple d'application AlloyDB pour PostgreSQL sur Cloud Run.

   Activer les API

   1. À l'étape Confirmer le projet, cliquez sur Suivant pour confirmer le nom du projet que vous allez modifier.

   2. À l'étape Activer les API, cliquez sur Activer pour activer les éléments suivants :

      • API AlloyDB
      • API Cloud Run Admin
      • API Compute Engine
      • API Cloud Build
      • API Container Registry
      • API Service Networking
      • API Cloud Resource Manager

Créer un cluster et son instance principale

1. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur Créer un cluster.

   La console Google Cloud vous propose différents types de clusters. Sélectionnez Haute disponibilité.

3. Cliquez sur Continuer.

   La section Configurer votre cluster se développe.

4. Sous Informations de base, dans le champ ID du cluster, saisissez my-cluster.

5. Dans le champ Mot de passe, saisissez le mot de passe de votre choix. Notez ce mot de passe. Vous en aurez à nouveau besoin dans la suite de ce guide de démarrage rapide.

6. Dans le champ Région, sélectionnez us-central1 (Iowa).

7. Dans Connectivité, dans le menu déroulant Réseau, sélectionnez default.

   Si vous n'avez pas encore configuré l'accès privé aux services, une boîte de dialogue intitulée Connexion d'accès aux services privés requise s'affiche.

   Dans la boîte de dialogue Connexion d'accès aux services privés requise, procédez comme suit pour créer une connexion d'accès aux services privés :

   1. Cliquez sur Configurer la connexion.

      Un nouveau volet intitulé Activer l'API Service Networking s'affiche.

   2. Dans le volet, sélectionnez Utiliser une plage d'adresses IP automatiquement allouée.

   3. Cliquez sur Continuer.

   4. Cliquez sur Créer une connexion et attendez que la configuration de la connexion soit terminée.

      Le volet est supprimé.

8. Cliquez sur Continuer.

   La section Configurer votre instance principale se développe.

9. Sous Informations de base, dans le champ ID d'instance, saisissez my-primary.

10. Pour une valeur Machine, sélectionnez 2 vCPU, 16 GB.

11. Cliquez sur Créer un cluster.

    Attendez que le cluster soit créé.

Se connecter à votre instance et créer une base de données

1. Si vous n'êtes pas sur la page Présentation du cluster que vous venez de créer, accédez à la page Clusters dans la console Google Cloud .

   accéder aux clusters

2. Pour afficher la page Présentation du cluster, cliquez sur le nom du cluster my-cluster.

3. Dans le menu de navigation, cliquez sur AlloyDB Studio.

4. Dans la liste Base de données de la page Se connecter à AlloyDB Studio, sélectionnez postgres.

5. Dans la liste déroulante User (Utilisateur), sélectionnez postgres.

6. Dans le champ Mot de passe, saisissez le mot de passe que vous avez créé dans Créer un cluster et son instance principale.

7. Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de votre base de données.

8. Dans l'onglet Éditeur 1, créez une base de données :

   CREATE DATABASE quickstart_db;
   

9. Cliquez sur Exécuter. Attendez que le message Statement executed successfully s'affiche dans le volet Résultats.

Trouver votre ID de projet

1. Accédez à la page Tableau de bord dans la console Google Cloud .

   Accéder à Google Dashboard

2. Recherchez l'ID du projet sur la fiche Informations sur le projet.

3. Notez l'ID de votre projet. Vous en aurez besoin pour l'étape suivante de ce guide de démarrage rapide.

Renseignez Artifact Registry avec une image de l'exemple d'application.

1. Dans la console Google Cloud , ouvrez Cloud Shell.

   Ouvrir Cloud Shell

2. Dans l'éditeur Cloud Shell, utilisez la commande suivante pour cloner le dépôt avec le code de l'exemple d'application à partir de GitHub :

   cloudshell_open --repo_url \
   "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
   --dir \
   "examples/go" \
   --force_new_clone

3. Créez un dépôt dans Artifact Registry pour les images Docker :

   gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

   Remplacez PROJECT_ID par l'ID de votre projet.

4. Dans la boîte de dialogue Autoriser Cloud Shell, cliquez sur Autoriser. Cette invite ne s'affiche pas si vous avez déjà effectué cette étape.

5. Pour créer un conteneur Docker et le publier dans Artifact Registry, utilisez la commande suivante :

    gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

   Remplacez PROJECT_ID par l'ID de votre projet.

Trouver l'adresse IP de votre nouvelle instance

1. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. Recherchez la ligne du tableau dont le nom de ressource est my-primary.

3. Notez l'adresse IP privée de cette ligne. Vous en aurez besoin pour l'étape suivante de ce guide de démarrage rapide.

   L'adresse IP doit être au format 172.19.209.2:5432.

Créer un service pour Cloud Run

1. Dans la console Google Cloud , accédez à la page Cloud Run.

   Accédez à Cloud Run

2. Dans l'onglet Services, cliquez sur Déployer le conteneur.

3. Sur la page Créer un service, sélectionnez l'option Déployer une révision à partir d'une image de conteneur existante.

4. Dans le champ URL de l'image du conteneur, cliquez sur Sélectionner.

5. Dans le volet Sélectionner l'image du conteneur, procédez comme suit :

   1. Sélectionnez l'onglet Artifact Registry.
   2. Développez us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
   3. Développez run-sql.
   4. Sélectionnez la dernière image.
   5. Cliquez sur Sélectionner.

6. Dans le champ Service name (Nom du compte de service), saisissez quickstart-service.

7. Assurez-vous que us-central1 (Iowa) est sélectionné par défaut dans la liste Région.

8. Dans la section Authentification, cochez Autoriser les appels non authentifiés.

9. Assurez-vous que l'option Le processeur n'est alloué que lors du traitement des requêtes est sélectionnée dans la section Allocation du processeur et tarification.

10. Développez la section Conteneur(s), volumes, mise en réseau, sécurité.

11. Dans l'onglet Conteneur(s), sélectionnez l'onglet Variables et secrets, puis procédez comme suit :

    1. Dans la section Variables d'environnement, cliquez sur Ajouter une variable.

    2. Saisissez les informations suivantes dans les champs Name et Value :

       • DB_NAME : quickstart_db
       • DB_USER : postgres
       • DB_PASS : mot de passe que vous avez saisi lorsque vous avez créé le cluster dans Créer un cluster et son instance principale.
       • DB_PORT : 5432
       • INSTANCE_HOST : adresse IP de l'instance principale de votre cluster, que vous avez trouvée dans Trouver l'adresse IP de votre nouvelle instance. N'incluez pas le numéro de port. Par exemple, définissez-le sur 172.19.209.2 et non sur 172.19.209.2:5432.

12. Passez de l'onglet Conteneur(s) à l'onglet Mise en réseau, puis procédez comme suit :

    1. Cochez la case Se connecter à un VPC pour le trafic sortant.

    2. Sélectionnez l'option Envoyer le trafic directement vers un VPC.

    3. Dans la liste déroulante Réseau, sélectionnez la valeur default.

    4. Dans la liste déroulante Sous-réseau, assurez-vous que la valeur default est sélectionnée.

13. Cliquez sur Créer pour créer le service Cloud Run.

    Une fois le service Cloud Run déployé, la page quickstart-service affiche l'URL de l'exemple d'application dans le champ URL.

    L'application utilise AlloyDB comme datastore.

Afficher l'exemple d'application

1. Dans la console Google Cloud , accédez à la page Cloud Run.

   Accédez à Cloud Run

2. Sur la page quickstart-service, cliquez sur Copier dans le presse-papiers pour copier l'URL de l'application.

3. Dans un nouvel onglet du navigateur, collez l'URL de l'application copiée, puis cliquez sur Entrée.

   L'exemple d'application Web de collecte de votes qui s'affiche ressemble à ce qui suit :

   

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

Nettoyer le cluster

1. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. À côté du cluster my-cluster que vous souhaitez supprimer, cliquez sur Actions, puis sur Supprimer.

3. Dans la boîte de dialogue Supprimer le cluster qui s'affiche, saisissez my-cluster dans le champ my-cluster pour confirmer que vous souhaitez le supprimer.

4. Cliquez sur Supprimer.

Nettoyer le service

1. Dans la console Google Cloud , accédez à la page Cloud Run.

   Accédez à Cloud Run

2. Cochez la case à côté du nom du service quickstart-service.

3. Cliquez sur Supprimer en haut de la page Cloud Run.

4. Dans la boîte de dialogue Supprimer quickstart-service qui s'affiche, cliquez sur Supprimer pour confirmer.

Étapes suivantes

• Activer l'accès au projet pour AlloyDB

• Accorder l'accès à AlloyDB à d'autres utilisateurs

• Activer l'accès aux services privés

• Créer un cluster et son instance principale