Anwendung mit Cloud SQL-Daten verbinden und in Cloud Run bereitstellen

1. Übersicht

In diesem Codelab zeigen wir eine einfache Methode zum Einrichten von Cloud SQL und zum Herstellen einer Verbindung zwischen unserer Anwendung und Cloud SQL. Es handelt sich um einen schnellen Kurs auf L100-Niveau, um die Entwicklerfreundlichkeit für die Integration fortschrittlicher KI-Anwendungen in anspruchsvolle Datenfunktionen zu verbessern, die Cloud SQL bietet.

Aufgaben

Eine einfache Webanwendung

Dabei gehen Sie so vor:

1. Cloud SQL for PostgreSQL-Instanz mit Ein-Klick-Installation erstellen
2. Beispielanwendung erstellen, um eine Verbindung zu dieser Instanz herzustellen und Daten einzurichten

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.

Wenn Sie dieses Codelab ausprobieren möchten, können Sie den folgenden Link für GCP-Testguthaben verwenden: https://bit.ly/ez-cloudsql1

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. Sobald die Verbindung mit Cloud Shell hergestellt ist, können Sie mit dem folgenden Befehl prüfen, ob Sie bereits authentifiziert sind und für das Projekt schon Ihre Projekt-ID eingestellt 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 Cloud SQL for PostgreSQL als Datenbank für die Testdaten.

Erstellen wir eine Cloud SQL-Instanz, 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 der Google Cloud Console-Nutzer angemeldet ist.

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 Ihre Daten für die Projekt-ID und den 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 die folgenden Befehle nacheinander aus:

git clone https://github.com/flazer99/verify-easy-cloud-sql-connection

cd verify-easy-cloud-sql-connection

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

# Replace this with the Private IP of your Cloud SQL Instance
DB_HOST = <<>> 
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual Cloud SQL password    
DB_PASS = <<>>

Wenn Sie die Verbindung lokal oder von einem beliebigen Ort aus testen möchten, rufen Sie die Cloud SQL-Instanz auf, klicken Sie auf „BEARBEITEN“ und dann auf „Öffentliche IP aktivieren“ oder „Verbindung über öffentliche IP“ (nicht die ausgehende) und geben Sie für Entwicklungszwecke „0.0.0.0/0“ in „Autorisierte externe Netzwerke“ ein. Entfernen Sie die Verbindung über öffentliche IP und deaktivieren Sie sie, sobald Sie fertig sind.

5. In Cloud Run bereitstellen

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

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

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

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

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

6. Demo

Ob es funktioniert hat, können Sie im Browser oder im Log-Explorer sehen.

Sie können in der Google Cloud Console zu Cloud SQL wechseln und die neu erstellte Instanz öffnen. Klicken Sie im Navigationsbereich auf der linken Seite auf Cloud SQL 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 der Einfügevorgang erfolgreich war:

7. Bereinigen

Vergessen Sie nicht, die Cloud SQL-Instanz zu löschen, wenn Sie dieses Test-Lab abgeschlossen haben.

Rufen Sie https://console.cloud.google.com/sql/instances auf. Wählen Sie die Instanz aus, die Sie löschen möchten, indem Sie auf die vertikalen Ellipsen daneben klicken, und klicken Sie auf „LÖSCHEN“.

Dadurch sollte der Cluster zusammen mit seinen Instanzen bereinigt werden.

8. Fazit

Erste Schritte zum Einrichten Ihrer Daten mit Cloud SQL – schnell und einfach!