Anwendung mit AlloyDB-Daten verbinden und in Cloud Run bereitstellen

1. Übersicht

In diesem Codelab zeigen wir eine einfache Methode zum Einrichten von AlloyDB und zum Verbinden unserer Anwendung damit. Es ist ein kurzer L100-Kurs, mit dem die Entwicklererfahrung bei der Integration fortschrittlicher KI-Anwendungen in die anspruchsvollen Datenfunktionen von AlloyDB verbessert werden soll.

Aufgaben

Eine einfache Webanwendung.

Dabei werden folgende Schritte ausgeführt:

1. AlloyDB-Instanz und -Cluster mit einer Ein-Klick-Installation erstellen
2. Beispielanwendung erstellen, um eine Verbindung zu dieser Instanz herzustellen und Daten einzurichten

Die Anwendung stellt nur eine Verbindung zur Datenbankeinrichtung her, die Sie in Schritt 1 vorgenommen haben, erstellt eine Tabelle und fügt einen Datensatz ein.

Voraussetzungen

• Ein Browser, z. B. Chrome oder Firefox
• Google Cloud-Projekt mit aktivierter Abrechnungsfunktion.

2. Hinweis

Projekt erstellen

1. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. Informationen zum Prüfen, ob die Abrechnung für ein Projekt aktiviert ist .
3. Sie verwenden die Cloud Shell, eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird. Klicken Sie oben in der Google Cloud Console auf Cloud Shell aktivieren.

4. Sobald die Verbindung mit der Cloud Shell hergestellt ist, prüfen Sie mit dem folgenden Befehl, ob Sie bereits authentifiziert sind und für das Projekt schon Ihre Projekt-ID eingestellt ist:

gcloud auth list

5. Führen Sie in der Cloud Shell den folgenden Befehl aus, um zu bestätigen, dass der gcloud-Befehl Ihr Projekt kennt.

gcloud config list project

6. Wenn Ihr Projekt nicht festgelegt ist, verwenden Sie den folgenden Befehl, um es festzulegen:

gcloud config set project <YOUR_PROJECT_ID>

7. Aktivieren Sie die erforderlichen APIs: Folgen Sie dem Link und aktivieren Sie die APIs.

Alternativ können Sie dazu den gcloud-Befehl verwenden. Weitere Informationen finden Sie in der Dokumentation zu gcloud-Befehlen und deren Verwendung.

3. Datenbank einrichten

In diesem Lab verwenden wir AlloyDB als Datenbank für die Testdaten. Dabei werden Cluster verwendet, um alle Ressourcen wie Datenbanken und Logs zu speichern. Jeder Cluster hat eine primäre Instanz, die einen Zugriffspunkt auf die Daten bietet. Die eigentlichen Daten werden in Tabellen gespeichert.

Erstellen wir einen AlloyDB-Cluster, eine AlloyDB-Instanz und eine AlloyDB-Tabelle, in die das Test-Dataset geladen wird.

1. Klicken Sie auf die Schaltfläche oder kopieren Sie den Link unten in Ihren Browser, in dem der Google Cloud Console-Nutzer angemeldet ist.

Ein Klick und Ausführen

2. Nach Abschluss dieses Schritts wird das Repository in den lokalen Cloud Shell-Editor geklont und Sie können den folgenden Befehl im Projektordner ausführen. Achten Sie darauf, dass Sie sich im Projektverzeichnis befinden:

sh run.sh

3. Verwenden Sie jetzt die Benutzeroberfläche, indem Sie auf den Link im Terminal oder auf den Link „Vorschau im Web“ im Terminal klicken.
4. Geben Sie Ihre Details für Projekt-ID, Cluster- und Instanznamen ein, um zu beginnen.
5. Holen Sie sich einen Kaffee, während die Logs durchlaufen. Hier erfahren Sie, wie das im Hintergrund funktioniert.

4. Beispielanwendung zum Testen der Verbindung erstellen

Führen Sie im Cloud Shell-Terminal den folgenden Befehl aus:

git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection

Nehmen Sie Änderungen an der Datei „verify_connection.py“ für die AlloyDB-Einrichtung vor, die Sie gerade im letzten Abschnitt konfiguriert haben:

# 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 = <<>>

Wenn Sie die Einrichtung lokal oder von überall aus testen möchten, rufen Sie die AlloyDB-Instanz auf, klicken Sie auf „BEARBEITEN“ und dann auf „Öffentliche IP aktivieren“ oder „Öffentliche IP-Konnektivität“ (nicht die ausgehende). Geben Sie für Entwicklungszwecke „0.0.0.0/0“ unter „Autorisierte externe Netzwerke“ ein. Entfernen und deaktivieren Sie die öffentliche IP-Konnektivität aber, sobald Sie fertig sind.

5. In Cloud Run bereitstellen

Achten Sie im Cloud Shell-Terminal darauf, dass Sie sich im Hauptordner und im Projektordner befinden.

Wenn Sie sich im Projektordner befinden, führen Sie den folgenden Befehl aus:

gcloud beta run deploy verify-alloydb \
    --source . \
    --region=us-central1 \
    --network=easy-alloydb-vpc \
    --subnet=easy-alloydb-subnet \
    --allow-unauthenticated \
    --vpc-egress=all-traffic

Nach der Bereitstellung sollten Sie einen bereitgestellten Cloud Run-Endpunkt erhalten, der so aussieht:

https://verify-alloydb-**********-uc.a.run.app/

6. Demo

Sie können das Ergebnis im Browser oder im Log-Explorer sehen, um zu bestätigen, dass alles funktioniert hat.

Rufen Sie AlloyDB in der Google Cloud Console auf und öffnen Sie die neu erstellte Instanz. Klicken Sie im Navigationsbereich auf der linken Seite auf "AlloyDB Studio" und stellen Sie mit Ihren Anmeldedaten eine Verbindung her.

Aktualisieren Sie im Studio im linken Bereich die Datenbankobjekte. Die neu erstellte Tabelle sollte angezeigt werden:

Sie können schnell eine Abfrage ausführen, um zu prüfen, ob das Einfügen erfolgreich war:

7. Bereinigen

Vergessen Sie nicht, den AlloyDB-Cluster und die AlloyDB-Instanz zu löschen, wenn Sie mit diesem Test-Lab fertig sind.

Rufen Sie https://console.cloud.google.com/alloydb/clustersauf. Wählen Sie den Cluster aus, den Sie löschen möchten, indem Sie auf die vertikalen Auslassungspunkte daneben klicken, und klicken Sie auf LÖSCHEN.

Dadurch werden der Cluster und seine Instanzen bereinigt.

8. Fazit

Legen Sie los und richten Sie Ihre Daten schnell und einfach mit AlloyDB ein.