Verbindung zu Cloud SQL for PostgreSQL mit Cloud Run herstellen

Erfahren Sie, wie Sie eine Beispielanwendung in Cloud Run bereitstellen, die mit einer PostgreSQL-Instanz verbunden ist. Verwenden Sie dazu die Google Cloud Console und eine Clientanwendung.

Angenommen, Sie führen alle Schritte zeitnah aus. Die in dieser Kurzanleitung erstellten Ressourcen kosten in der Regel weniger als einen Dollar (US-Dollar).

Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:

Anleitung

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Kurzanleitung erforderlich sind.
  7. Aktivieren Sie die Cloud APIs, die zum Ausführen einer Cloud SQL-Beispielanwendung in Cloud Run erforderlich sind.

    Console

    Klicken Sie auf APIs aktivieren, um die für diese Kurzanleitung erforderlichen APIs zu aktivieren.

    APIs aktivieren

    Dadurch werden die folgenden APIs aktiviert:

    • Compute Engine API
    • Cloud SQL Admin API
    • Cloud Run API
    • Container Registry API
    • Cloud Build API
    • Service Networking API

    gcloud

    Klicken Sie auf die folgende Schaltfläche, um Cloud Shell zu öffnen. Cloud Shell bietet Befehlszeilenzugriff auf Ihre Google Cloud Ressourcen direkt über den Browser. Mit Cloud Shell können Sie die in dieser Kurzanleitung vorgestellten gcloud-Befehle ausführen.

    Cloud Shell öffnen

    Führen Sie den folgenden gcloud-Befehl mit Cloud Shell aus:

    gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
containerregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

    Mit diesem Befehl werden die folgenden APIs aktiviert:

    • Compute Engine API
    • Cloud SQL Admin API
    • Cloud Run API
    • Container Registry API
    • Cloud Build API
    • Service Networking API

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, das Sie verwenden möchten, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen einer Beispiel-App in Cloud Run benötigen, die mit einer PostgreSQL-Instanz verbunden ist:

  • Instanz, Datenbank und Nutzer erstellen oder löschen: Cloud SQL-Administratorrolle (roles/cloudsql.admin).
  • IAM-Dienstkonto erstellen oder löschen: Rolle „Dienstkontoadministrator“ (roles/iam.serviceAccountAdmin).
  • Verbindung herstellen:
  • Objekte und ihre Metadaten ansehen: Storage-Objekt-Betrachter (roles/storage.objectViewer)
  • Berechtigungen zum Verwalten von Richtlinien für Projekte gewähren: Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin).
  • Lese- und Schreibzugriff auf alle Cloud Run-Ressourcen: Cloud Run-Entwickler (roles/run.developer).
  • Von Cloud Run-Quelle bereitgestellte Ressourcen bereitstellen und verwalten: Cloud Run Source Developer (roles/run.sourceDeveloper).
  • Öffentlichen Zugriff zulassen: Cloud Run-Administrator (roles/run.admin).
  • So führen Sie Vorgänge als Dienstkonto aus: Dienstkontonutzer (roles/iam.serviceAccountUser).

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Cloud SQL einrichten

Cloud SQL-Instanz erstellen

Datenbank erstellen

So erstellen Sie eine Datenbank:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Wählen Sie quickstart-instance aus.
  3. Wählen Sie im SQL-Navigationsmenü die Option Datenbanken aus.
  4. Klicken Sie auf Create database (Datenbank erstellen).
    1. Geben Sie im Feld Datenbankname des Dialogfelds Neue Datenbank quickstart-db ein.
    2. Klicken Sie auf Erstellen.

gcloud

Führen Sie den Befehl gcloud sql databases create aus, um eine Datenbank zu erstellen.

gcloud sql databases create quickstart-db --instance=quickstart-instance

Nutzer erstellen

So erstellen Sie einen Nutzer:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
  3. Wählen Sie im SQL-Navigationsmenü die Option Nutzer aus.
  4. Klicken Sie auf Nutzerkonto hinzufügen.
  5. Geben Sie auf der Seite Nutzerkonto zur Instanz Instanzname hinzufügen die folgenden Informationen ein:
    • Geben Sie im Feld Nutzername quickstart-user ein.
    • Geben Sie im Feld Passwort ein Passwort für den Datenbanknutzer ein. Notieren Sie dies zur Verwendung in einem späteren Schritt dieser Kurzanleitung.
  6. Klicken Sie auf Hinzufügen.

gcloud

Bevor Sie den folgenden Befehl ausführen, ersetzen Sie die folgenden Werte:

  1. PASSWORD durch ein Passwort für Ihren Datenbanknutzer. Notieren Sie dies zur Verwendung in einem späteren Schritt dieser Kurzanleitung.

Führen Sie den Befehl gcloud sql users create aus, um den Nutzer zu erstellen.

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=PASSWORD

Für Cloud SQL gelten dieselben Längenbeschränkungen für Nutzernamen wie für lokales PostgreSQL.

Beispielanwendung in Cloud Run bereitstellen

Cloud Run-Dienstkonto konfigurieren

Konfigurieren Sie das von Cloud Run verwendete standardmäßige Compute Engine-Dienstkonto so, dass es die Rollen Cloud SQL-Client und Storage-Objekt-Betrachter hat.

Console

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

    IAM-Dienstkonten aufrufen

  2. Klicken Sie neben dem Dienstkonto auf das Menü Aktionen und dann auf Zugriff verwalten.
  3. Klicken Sie auf Weitere Rolle hinzufügen und suchen Sie dann in der Drop-down-Liste Rolle nach Cloud SQL-Client (roles/cloudsql.client) und wählen Sie diese aus.
  4. Klicken Sie auf Weitere Rolle hinzufügen und suchen Sie dann im Drop-down-Menü Rolle nach Storage-Objekt-Betrachter (roles/storage.ObjectViewer) und wählen Sie diese aus.
  5. Klicken Sie auf Speichern.

gcloud

  1. Führen Sie den folgenden gcloud-Befehl aus, um eine Liste der Dienstkonten Ihres Projekts abzurufen: 
    gcloud iam service-accounts list
  2. Kopieren Sie die E-MAIL-ADRESSE des Compute Engine-Standarddienstkontos.
  3. Führen Sie den folgenden Befehl aus, um dem Compute Engine-Standarddienstkonto die Rolle Cloud SQL-Client hinzuzufügen: 
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/cloudsql.client"
  4. Führen Sie den folgenden Befehl aus, um dem Compute Engine-Standarddienstkonto die Rolle Storage-Objekt-Betrachter hinzuzufügen: 
    gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/storage.ObjectViewer"

Cloud SQL-Beispielanwendung konfigurieren

Mit einer Cloud SQL-Instanz, einer Datenbank und einem Dienstkonto mit Clientberechtigungen können Sie jetzt eine Beispielanwendung so konfigurieren, dass sie eine Verbindung zu Ihrer Cloud SQL-Instanz herstellt.

Beispiel-App bereitstellen

Die Schritte zum Bereitstellen des Beispiels in Cloud Run hängen vom Typ der IP-Adresse ab, die Sie der Cloud SQL-Instanz zugewiesen haben.

Die Methode zum Herstellen einer Verbindung mit dem Bild variiert je nach den festgelegten Umgebungsvariablen.

  • Wenn Sie eine Verbindung über TCP herstellen möchten, legen Sie den Wert für die Umgebungsvariable INSTANCE_HOST fest. Bei dieser Verbindungsmethode werden die als Umgebungsvariablen konfigurierten Zertifikate und Ports berücksichtigt.
  • Wenn Sie eine Verbindung über UNIX-Sockets herstellen möchten, legen Sie den Wert für die Umgebungsvariable INSTANCE_UNIX_SOCKET fest.

    Legen Sie keinen Wert für die Umgebungsvariable INSTANCE_HOST fest.

    Unix-Sockets werden in Java nicht nativ unterstützt. Wenn Ihre Anwendung in Java geschrieben ist, müssen Sie den Cloud SQL-Java-Connector verwenden.

  • Wenn Sie eine Verbindung über einen der Cloud SQL Language Connectors herstellen möchten, legen Sie den Wert für die Umgebungsvariable INSTANCE_CONNECTION_NAME fest.

    Legen Sie die Werte für die folgenden Umgebungsvariablen nicht fest:

    • INSTANCE_HOST
    • INSTANCE_UNIX_SOCKET
    • DB_PORT
    • DB_ROOT_CERT
    • DB_CERT
    • DB_KEY
    Diese Werte werden nicht verwendet, da der Cloud SQL-Sprachconnector bereits eine sichere Verbindung über den Cloud SQL Auth-Proxyserver bereitstellt, der Verbindungen zu Cloud SQL über Port 3307 herstellt.

Bereinigen

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

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Wählen Sie die Instanz quickstart-instance aus, um die Seite Instanzendetails zu öffnen.
  3. Klicken Sie oben auf der Seite in der Symbolleiste auf Löschen.
  4. Geben Sie im Dialogfeld Instanz löschen quickstart-instance ein und klicken Sie dann auf Löschen, um die Instanz zu löschen.

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

    Zu Cloud Run

  6. Klicken Sie auf das Kästchen neben dem Dienstnamen quickstart-service.
  7. Klicken Sie oben auf der Cloud Run-Seite auf Löschen.

Optionale Bereinigungsschritte

Wenn Sie nicht die Rolle Cloud SQL-Client verwenden, die Sie dem Compute Engine-Dienstkonto zugewiesen haben, können Sie sie entfernen.

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

    IAM aufrufen

  2. Klicken Sie auf das Stiftsymbol für das IAM-Konto Compute Engine-Standarddienstkonto.
  3. Löschen Sie die Rolle Cloud SQL-Client.
  4. Klicken Sie auf Speichern.

Wenn Sie die APIs, die im Rahmen dieser Kurzanleitung aktiviert wurden, nicht verwenden, können Sie sie deaktivieren.

  • APIs, die in dieser Kurzanleitung aktiviert wurden:
    • Compute Engine API
    • Cloud SQL Admin API
    • Cloud Run API
    • Container Registry API
    • Cloud Build API

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

    Zu „APIs“

  2. Wählen Sie eine API aus, die Sie deaktivieren möchten, und klicken Sie dann auf die Schaltfläche API deaktivieren.

Nächste Schritte

Je nach Bedarf können Sie sich eingehender über das Erstellen von Cloud SQL-Instanzen informieren.

Sie können sich auch über das Erstellen von PostgreSQL-Nutzern und Datenbanken für Ihre Cloud SQL-Instanz informieren.

Weitere Informationen zu Preisen finden Sie unter Cloud SQL for PostgreSQL – Preise.

Mehr zu folgenden Themen:

Außerdem erfahren Sie, wie Sie von anderen Google Cloud-Anwendungen aus eine Verbindung zu einer Cloud SQL-Instanz herstellen können: