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. Dieser Kurs auf L100-Niveau bietet einen schnellen Einstieg in die Integration von fortschrittlichen KI-Anwendungen in die anspruchsvollen Datenfunktionen von AlloyDB.

Aufgaben

Eine einfache Webanwendung

Dabei gehen Sie so vor:

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

Die Anwendung stellt nur eine Verbindung zur Datenbank her, die Sie in Schritt 1 eingerichtet 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 zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

Für dieses Codelab können Sie den Link für das GCP-Testabrechnungsguthaben verwenden: https://bit.ly/ez-alloydb

Wie löse ich Guthaben über diesen Link ein? Empfehlen:

3. Sie verwenden Cloud Shell, eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird. Klicken Sie oben in der Google Cloud Console auf „Cloud Shell aktivieren“.

4. Wenn Sie mit Cloud Shell verbunden sind, können Sie mit dem folgenden Befehl prüfen, ob Sie bereits authentifiziert sind und das Projekt auf Ihre Projekt-ID festgelegt ist:

gcloud auth list

5. Führen Sie den folgenden Befehl in Cloud Shell 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. Informationen zu gcloud-Befehlen und deren Verwendung finden Sie in der Dokumentation.

3. Datenbank einrichten

In diesem Lab verwenden wir AlloyDB als Datenbank für die Testdaten. Darin 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. Tabellen enthalten die tatsächlichen Daten.

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

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

One Click & Run

2. Sobald dieser Schritt abgeschlossen ist, wird das Repository in Ihren lokalen Cloud Shell-Editor geklont und Sie können den folgenden Befehl über den Projektordner ausführen. Achten Sie darauf, dass Sie sich im Projektverzeichnis befinden:

sh run.sh

3. Verwenden Sie jetzt die Benutzeroberfläche (klicken Sie auf den Link im Terminal oder auf den Link „Vorschau im Web“ im Terminal).
4. Geben Sie die Details für Projekt-ID, Cluster- und Instanznamen ein, um zu beginnen.
5. Holen Sie sich einen Kaffee, während die Logs durchlaufen. Hier können Sie nachlesen, 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 Ihre 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 Verbindung lokal oder von einem beliebigen Ort aus testen möchten, rufen Sie die AlloyDB-Instanz auf, klicken Sie auf „BEARBEITEN“ und dann auf „Öffentliche IP aktivieren“ oder „Öffentliche IP-Verbindung“ (nicht die ausgehende) und geben Sie für Entwicklungszwecke „0.0.0.0/0“ in „Autorisierte externe Netzwerke“ ein. Entfernen und deaktivieren Sie die öffentliche IP-Verbindung jedoch, sobald Sie fertig sind.

5. In Cloud Run bereitstellen

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

Wenn Sie sich sicher sind, dass 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.

Sie können in der Google Cloud Console zu AlloyDB navigieren und die neu erstellte Instanz öffnen. Klicken Sie im Navigationsbereich auf der linken Seite auf AlloyDB Studio und stellen Sie eine Verbindung mit Ihren Anmeldedaten 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 der Einfügevorgang erfolgreich war:

7. Bereinigen

Vergessen Sie nicht, den AlloyDB-Cluster und die Instanz zu löschen, wenn Sie dieses Test-Lab abgeschlossen haben.

Rufen Sie https://console.cloud.google.com/alloydb/clusters auf. Wählen Sie den Cluster aus, den Sie löschen möchten, indem Sie auf das vertikale Dreipunkt-Menü daneben klicken, und klicken Sie auf „LÖSCHEN“.

Dadurch sollte der Cluster zusammen mit seinen Instanzen bereinigt werden.

8. Fazit

Erste Schritte mit der Einrichtung Ihrer Daten mit AlloyDB – schnell und einfach!!!