1. Présentation
Dans cet atelier de programmation, nous allons vous montrer une méthode simple et facile à mettre en œuvre pour configurer AlloyDB et y connecter votre application. Il s'agit d'un apprentissage rapide de niveau 100 qui permet d'améliorer l'expérience des développeurs en intégrant des applications d'IA avancées à des fonctionnalités de données sophistiquées qu'AlloyDB a à offrir.
Objectifs de l'atelier
Une application Web simple.
Dans le cadre de cet atelier, vous allez :
- créer un cluster et une instance AlloyDB en un seul clic ;
- créer un exemple d'application pour vous connecter à cette instance et configurer des données.
L'application se connectera simplement à la configuration de la base de données que vous avez effectuée à l'étape 1, puis créera une table et y insérera un enregistrement.
Conditions requises
2. Avant de commencer
Créer un projet
- Dans la console Google Cloud, sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud.
- Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée pour un projet.
- Vous allez utiliser Cloud Shell, un environnement de ligne de commande exécuté dans Google Cloud. Cliquez sur Activer Cloud Shell en haut de la console Google Cloud.
- Une fois connecté à Cloud Shell, vérifiez que vous êtes déjà authentifié et que le projet est défini sur votre ID de projet à l'aide de la commande suivante :
gcloud auth list
- Exécutez la commande suivante dans Cloud Shell pour vérifier que la commande gcloud reconnaît votre projet.
gcloud config list project
- Si votre projet n'est pas défini, utilisez la commande suivante pour le définir :
gcloud config set project <YOUR_PROJECT_ID>
- Activez les API requises : suivez le lien et activez les API.
Vous pouvez également utiliser la commande gcloud pour cela. Consultez la documentation pour connaître les commandes gcloud ainsi que leur utilisation.
3. Configuration de la base de données
Dans cet atelier, nous allons utiliser AlloyDB comme base de données pour les données de test. Il utilise des clusters pour contenir toutes les ressources, telles que les bases de données et les journaux. Chaque cluster possède une instance principale qui fournit un point d'accès aux données. Les tables contiendront les données réelles.
Créons un cluster, une instance et une table AlloyDB dans lesquels l'ensemble de données de test sera chargé.
- Cliquez sur le bouton ou copiez le lien ci-dessous dans votre navigateur dans lequel l'utilisateur de la console Google Cloud est connecté.
- Une fois cette étape terminée, le dépôt sera cloné dans votre éditeur Cloud Shell local. Vous pourrez ensuite exécuter la commande ci-dessous à partir du dossier du projet (il est important de vous assurer que vous vous trouvez dans le répertoire du projet) :
sh run.sh
- Utilisez maintenant l'interface utilisateur (en cliquant sur le lien dans le terminal ou sur le lien "Aperçu sur le Web" dans le terminal).
- Saisissez vos informations pour l'ID de projet, le cluster et les noms d'instance pour commencer.
- Allez chercher un café pendant que les journaux défilent. Vous pouvez découvrir comment cela fonctionne en arrière-plan ici.
4. Créer l'exemple d'application pour tester la connexion
Dans le terminal Cloud Shell, exécutez la commande suivante :
git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection
Modifiez le fichier verify_connection.py pour la configuration AlloyDB que vous venez de configurer dans la dernière section :
# Replace this with the Private IP of your AlloyDB Instance
DB_HOST = <<>>
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual AlloyDB password
DB_PASS = <<>>
5. Déployer dans Cloud Run
Dans le terminal Cloud Shell, assurez-vous que vous vous trouvez dans votre dossier principal et dans le dossier du projet.
Une fois que vous êtes sûr de vous trouver dans le dossier du projet, exécutez la commande suivante :
gcloud beta run deploy verify-alloydb \
--source . \
--region=us-central1 \
--network=easy-alloydb-vpc \
--subnet=easy-alloydb-subnet \
--allow-unauthenticated \
--vpc-egress=all-traffic
Une fois le déploiement effectué, vous devriez recevoir un point de terminaison Cloud Run déployé qui ressemble à ceci :
https://verify-alloydb-**********-uc.a.run.app/
6. Démo
Pour vérifier que cela a fonctionné, vous pouvez consulter le résultat dans le navigateur ou l'explorateur de journaux.
Vous pouvez accéder à AlloyDB dans la console Google Cloud et ouvrir l'instance que vous venez de créer. Cliquez sur AlloyDB Studio dans le volet de navigation de gauche, puis connectez-vous avec vos identifiants.
Dans le studio, dans le volet de gauche, actualisez les objets de la base de données. La table que vous venez de créer devrait s'afficher :
Vous pouvez rapidement l'interroger pour vérifier que l'insertion a bien été effectuée :
7. Nettoyage
Une fois cet atelier d'essai terminé, n'oubliez pas de supprimer le cluster et l'instance AlloyDB.
Le cluster et ses instances devraient être nettoyés.
8. Conclusion
Commencez à configurer vos données avec AlloyDB rapidement et facilement.