Verbindung über Cloud Run herstellen

Auf dieser Seite erfahren Sie, wie Sie mit der Google Cloud Console und einer Clientanwendung eine Beispielanwendung in einem Cloud Run-Dienst bereitstellen. In dieser Beispielanwendung wird eine Verbindung zwischen Cloud Run und AlloyDB for PostgreSQL hergestellt.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Aktivieren Sie die Cloud APIs, die zum Ausführen einer AlloyDB for PostgreSQL-Beispielanwendung in Cloud Run erforderlich sind.

    APIs aktivieren

    1. Klicken Sie im Schritt Projekt bestätigen auf Weiter, um den Namen des Projekts zu bestätigen, an dem Sie Änderungen vornehmen möchten.

    2. Klicken Sie im Schritt APIs aktivieren auf Aktivieren, um Folgendes zu aktivieren:

      • AlloyDB API
      • Cloud Run Admin API
      • Compute Engine API
      • Cloud Build API
      • Container Registry API
      • Service Networking API
      • Cloud Resource Manager API

Cluster und primäre Instanz erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie auf Cluster erstellen.

    In der Google Cloud Console können Sie verschiedene Clustertypen auswählen. Wählen Sie Hochverfügbar aus.

  3. Klicken Sie auf Weiter.

    Der Bereich Cluster konfigurieren wird maximiert.

  4. Geben Sie unter Allgemeine Informationen im Feld Cluster-ID my-cluster ein.

  5. Geben Sie im Feld Passwort ein beliebiges Passwort ein. Notieren Sie sich dieses Passwort. Sie verwenden ihn später in dieser Kurzanleitung noch einmal.

  6. Wählen Sie im Feld Region us-central1 (Iowa) aus.

  7. Wählen Sie unter Netzwerk die Option default aus.

    Wenn Sie den Zugriff auf private Dienste noch nicht eingerichtet haben, wird das Dialogfeld Verbindung für privaten Zugriff auf Dienste erforderlich angezeigt.

    Führen Sie im Dialogfeld Verbindung für privaten Zugriff auf Dienste erforderlich die folgenden Schritte aus, um eine Verbindung für den Zugriff auf private Dienste zu erstellen:

    1. Klicken Sie auf Verbindung einrichten.

      Ein neuer Bereich mit der Bezeichnung Service Networking API aktivieren wird angezeigt.

    2. Wählen Sie im Bereich die Option Automatisch zugewiesenen IP-Bereich verwenden aus.

    3. Klicken Sie auf Weiter.

    4. Klicken Sie auf Verbindung erstellen und warten Sie, bis die Verbindungskonfiguration abgeschlossen ist.

      Der Bereich wird entfernt.

  8. Klicken Sie auf Weiter.

    Der Abschnitt Primäre Instanz konfigurieren wird maximiert.

  9. Geben Sie unter Allgemeine Informationen im Feld Instanz-ID den Wert my-primary ein.

  10. Wählen Sie für den Wert Machine die Option 2 vCPU, 16 GB aus.

  11. Klicken Sie auf Cluster erstellen.

    Warten Sie, bis der Cluster erstellt wurde.

Verbindung zur Instanz herstellen und Datenbank erstellen

  1. Wenn Sie sich nicht auf der Seite Übersicht des neu erstellten Clusters befinden, rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie auf den Clusternamen my-cluster, um die Übersichtsseite des Clusters aufzurufen.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Wählen Sie auf der Seite In AlloyDB Studio anmelden in der Liste Datenbank die Option postgres aus.

  5. Wählen Sie in der Drop-down-Liste User (Nutzer) die Option postgres aus.

  6. Geben Sie im Feld Passwort das Passwort ein, das Sie unter Cluster und primäre Instanz erstellen erstellt haben.

  7. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in Ihrer Datenbank angezeigt.

  8. Erstellen Sie auf dem Tab Editor 1 eine Datenbank:

    CREATE DATABASE quickstart_db;

  9. Klicken Sie auf Ausführen. Warten Sie, bis die Meldung Statement executed successfully im Bereich Ergebnisse angezeigt wird.

Suchen Sie Ihre Projekt-ID.

  1. Rufen Sie in der Google Cloud Console die Seite Dashboard auf.

    Zum Dashboard

  2. Sie finden die Projekt-ID auf der Karte Projektinformationen.

  3. Notieren Sie sich die Projekt-ID. Sie benötigen ihn für den nächsten Schritt dieser Kurzanleitung.

Artifact Registry mit einem Image der Beispielanwendung füllen

  1. Öffnen Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell öffnen

  2. Klonen Sie mit dem folgenden Befehl im Cloud Shell-Editor das Repository mit dem Code der Beispielanwendung von GitHub:

    cloudshell_open --repo_url \
"https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
--dir \
"examples/go" \
--force_new_clone

  3. Erstellen Sie in Artifact Registry ein Repository für Docker-Images:

    gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die ID Ihres Projekts.

  4. Klicken Sie im Dialogfeld Cloud Shell autorisieren auf Autorisieren. Diese Aufforderung wird nicht angezeigt, wenn Sie diesen Schritt bereits ausgeführt haben.

  5. Verwenden Sie den folgenden Befehl, um einen Docker-Container zu erstellen und in Artifact Registry zu veröffentlichen:

     gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

    Ersetzen Sie PROJECT_ID durch die ID Ihres Projekts.

IP-Adresse für die neue Instanz ermitteln

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Suchen Sie in der Tabelle die Zeile, deren Ressourcenname my-primary ist.

  3. Notieren Sie sich die private IP-Adresse dieser Zeile. Sie benötigen ihn für den nächsten Schritt dieser Kurzanleitung.

    Ein Beispiel für das Format der IP-Adresse ist 172.19.209.2:5432.

Dienst für Cloud Run erstellen

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

    Zu Cloud Run

  2. Klicken Sie auf dem Tab Dienste auf Dienst erstellen.

  3. Klicken Sie im Feld Container-Image-URL auf Auswählen.

  4. Führen Sie im Bereich Container-Image auswählen die folgenden Schritte aus:

    1. Wählen Sie den Tab Artifact Registry aus.
    2. Maximieren Sie us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
    3. Maximieren Sie run-sql.
    4. Wählen Sie das aktuelle Image aus.
    5. Klicken Sie auf Auswählen.

  5. Geben Sie im Feld Name des Dienstkontos quickstart-service ein.

  6. Achten Sie darauf, dass in der Liste Region standardmäßig us-central1 (Iowa) ausgewählt ist.

  7. Wählen Sie im Bereich Authentifizierung die Option Nicht authentifizierte Aufrufe zulassen aus.

  8. Achten Sie darauf, dass im Abschnitt CPU-Zuordnung und -Preise die Option CPU wird nur während der Anfrageverarbeitung zugewiesen ausgewählt ist.

  9. Maximieren Sie den Abschnitt Container, Volumes, Netzwerk, Sicherheit.

  10. Wählen Sie auf dem Tab Container den Tab Variablen und Secrets aus und führen Sie die folgenden Schritte aus:

    1. Klicken Sie im Bereich Umgebungsvariablen auf Variable hinzufügen.

    2. Geben Sie Folgendes in die Felder Name und Value ein:

      • DB_NAME: quickstart_db
      • DB_USER: postgres
      • DB_PASS: Das Passwort, das Sie beim Erstellen des Clusters unter Cluster und primäre Instanz erstellen eingegeben haben.
      • DB_PORT: 5432
      • INSTANCE_HOST: Die IP-Adresse der primären Instanz Ihres Clusters, die Sie unter IP-Adresse für die neue Instanz ermitteln ermittelt haben. Geben Sie keine Portnummer an, z. B. 172.19.209.2 und nicht 172.19.209.2:5432.

  11. Wechseln Sie vom Tab Container zum Tab Netzwerk und führen Sie die folgenden Schritte aus:

    1. Aktivieren Sie das Kästchen Mit einer VPC für ausgehenden Traffic verbinden.

    2. Wählen Sie die Option Traffic direkt an eine VPC senden aus.

    3. Wählen Sie in der Drop-down-Liste Netzwerk den Wert default aus.

    4. Achten Sie darauf, dass in der Drop-down-Liste Subnetz der Wert default ausgewählt ist.

  12. Klicken Sie auf Erstellen, um den Cloud Run-Dienst zu erstellen.

    Nachdem der Cloud Run-Dienst bereitgestellt wurde, wird auf der Seite quickstart-service im Feld URL die URL der Beispielanwendung angezeigt.

    Die Anwendung verwendet AlloyDB als Datenspeicher.

Beispielanwendung ansehen

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

    Zu Cloud Run

  2. Klicken Sie auf der Seite quickstart-service auf  In die Zwischenablage kopieren, um die URL der Anwendung zu kopieren.

  3. Fügen Sie die kopierte Anwendungs-URL in einen neuen Browsertab ein und klicken Sie auf die Eingabetaste.

    Die angezeigte Beispiel-Webanwendung zum Erfassen von Stimmen sieht in etwa so aus:

    Beispielanwendung für Tabs und Gruppenbereiche

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Cluster bereinigen

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie neben dem my-cluster-Cluster, den Sie löschen möchten, auf Aktionen und dann auf Löschen.

  3. Geben Sie im angezeigten Dialogfeld Cluster löschen my-cluster in das Feld my-cluster ein, um zu bestätigen, dass Sie ihn löschen möchten.

  4. Klicken Sie auf Löschen.

Dienst bereinigen

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run.

    Zu Cloud Run

  2. Klicken Sie auf das Kästchen neben dem Dienstnamen quickstart-service.

  3. Klicken Sie oben auf der Seite Cloud Run auf Löschen.

  4. Klicken Sie im Dialogfeld Quickstart-Dienst löschen auf Löschen, um den Vorgang zu bestätigen.

Nächste Schritte