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 notre application. Ce cours de niveau 100 vous permet d'améliorer rapidement l'expérience des développeurs pour l'intégration d'applications d'IA avancées aux fonctionnalités de données sophistiquées qu'AlloyDB a à offrir.
Ce que vous allez faire
Une application Web simple.
Dans ce cadre, vous allez :
- Créer une instance et un cluster AlloyDB en un clic
- Créer un exemple d'application pour se connecter à cette instance et configurer les 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 sur 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 connaî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 ce lien et activez les API.
Vous pouvez également utiliser la commande gcloud. 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 utiliserons AlloyDB comme base de données pour les données de test. Il utilise des clusters pour stocker 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 contiennent 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 le 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 (assurez-vous d'être dans le répertoire du projet) :
sh run.sh
- Utilisez maintenant l'UI (en cliquant sur le lien dans le terminal ou sur le lien "Prévisualiser sur le Web" dans le terminal).
- Saisissez les informations requises pour l'ID de projet, ainsi que les noms du cluster et de l'instance pour commencer.
- Allez prendre un café pendant que les journaux défilent. Pour en savoir plus sur le fonctionnement en coulisses, cliquez 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 section précédente :
# 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 d'être dans votre dossier principal et dans le dossier du projet.
Une fois que vous êtes sûr d'être 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 l'opération 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 panneau de navigation de gauche, puis connectez-vous avec vos identifiants.
Dans le studio, dans le volet de gauche, actualisez les objets de base de données. La table que vous venez de créer devrait s'afficher :
Vous pouvez l'interroger rapidement 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.
Il devrait nettoyer le cluster ainsi que ses instances.
8. Conclusion
Commencez à configurer vos données avec AlloyDB rapidement et facilement !