Verbindung über Cloud Run herstellen

Hinweise

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.

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. 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 Konsole können Sie einen Clustertyp 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 benötigen ihn später in dieser Kurzanleitung wieder.

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

7. Wählen Sie unter Verbindung im Drop-down-Menü 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.

   Gehen Sie im Dialogfeld Verbindung für privaten Zugriff auf Dienste erforderlich so vor, um eine Verbindung für den Zugriff auf private Dienste zu erstellen:

   1. Klicken Sie auf Verbindung einrichten.

      Ein neuer Bereich mit dem Label Service Networking API aktivieren wird angezeigt.

   2. Wählen Sie im Bereich 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 Maschine 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. Die Projekt-ID finden Sie auf der Karte Projektinformationen.

3. Notieren Sie sich Ihre 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. Verwenden Sie im Cloud Shell Editor den folgenden Befehl, um das Repository mit dem Beispielanwendungscode von GitHub zu klonen:

   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. Rufen Sie in der Google Cloud -Console die Seite Cloud Run auf.

   Zu Cloud Run

2. Klicken Sie auf dem Tab Dienste auf Container bereitstellen.

3. Wählen Sie auf der Seite Dienst erstellen die Option Eine Überarbeitung aus einem vorhandenen Container-Image bereitstellen aus.

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

5. 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.

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

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

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

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

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

11. 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 gefunden haben. Geben Sie die Portnummer nicht an, z. B. 172.19.209.2 statt 172.19.209.2:5432.

12. 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.

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

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

    Die Anwendung verwendet AlloyDB als Datenspeicher.

Beispielanwendung ansehen

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

   Zu Cloud Run

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

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

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

   

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite 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 Cluster my-cluster, den Sie löschen möchten, auf more_vert Aktionen und dann auf delete Löschen.

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

4. Klicken Sie auf Löschen.

Dienst bereinigen

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

   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 delete Löschen.

4. Klicken Sie im angezeigten Dialogfeld Schnellstartdienst löschen zur Bestätigung auf Löschen.

Nächste Schritte

• Projektzugriff auf AlloyDB aktivieren

• Anderen Nutzern Zugriff auf AlloyDB gewähren

• Zugriff auf private Dienste aktivieren

• Cluster und primäre Instanz erstellen