Verbindung zu Cloud SQL for PostgreSQL mit Cloud Run-Funktionen herstellen

Erfahren Sie, wie Sie eine Beispielanwendung in Cloud Run-Funktionen 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).

Vorbereitung

  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. Aktivieren Sie die Cloud APIs, die zum Ausführen einer Cloud SQL-Beispielanwendung in Cloud Run-Funktionen erforderlich sind.

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

    APIs aktivieren

    Dadurch werden die folgenden APIs aktiviert:

    • Cloud Run Functions API
    • Cloud SQL Admin API
    • Cloud Run Admin API
    • Cloud Build API
    • Artifact Registry API
    • Eventarc API
    • Compute Engine API
    • Service Networking API
    • Cloud Logging API

    Klicken Sie auf die folgende Schaltfläche, um Cloud Shell zu öffnen, die Befehlszeilenzugriff auf Ihre Google Cloud Ressourcen direkt über den Browser bietet. 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 cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com

    Mit diesem Befehl werden die folgenden APIs aktiviert:

    • Cloud Run Functions API
    • Cloud SQL Admin API
    • Cloud Run API
    • Cloud Build API
    • Artifact Registry API
    • Eventarc API
    • Compute Engine API
    • Service Networking API
    • Cloud Logging API
  5. Fügen Sie Ihrem Nutzer die IAM-Rolle Cloud Run-Funktionen-Aufrufer hinzu.

    Rolle hinzufügen

Cloud SQL einrichten

Cloud SQL-Instanz erstellen

Öffentliche IP-Adresse

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf Instanz erstellen.
  3. Klicken Sie auf PostgreSQL auswählen.
  4. Achten Sie darauf, dass Enterprise Plus als Cloud SQL-Version für Ihre Instanz ausgewählt ist.
  5. Geben Sie im Feld Instanz-ID den Wert quickstart-instance ein.
  6. Geben Sie im Feld Passwort ein Passwort für den Postgres-Nutzer ein. Speichern Sie dieses Passwort zur späteren Verwendung.
  7. Wählen Sie im Abschnitt Region und zonale Verfügbarkeit auswählen die Option Einzelne Zone aus.
  8. Klicken Sie auf das Menü Konfigurationsoptionen einblenden.
  9. Maximieren Sie den Knoten Maschinenkonfiguration.
  10. Wählen Sie im Bereich Maschinenformen die Form 4 vCPUs, 32 GB aus.
  11. Klicken Sie auf Instanz erstellen und warten Sie, bis die Instanz initialisiert und gestartet wurde.

Bevor Sie den Befehl ausführen, ersetzen Sie DB_ROOT_PASSWORD durch das Passwort Ihres Datenbanknutzers.

Ändern Sie optional die Werte für die folgenden Parameter:

  • --database_version: der Typ und die Version des Datenbankmoduls. Falls nicht angegeben, wird der API-Standard verwendet. Die derzeit verfügbaren Versionen finden Sie in der Dokumentation zu gcloud-Datenbankversionen.
  • --cpu: die Anzahl der in der Maschine gewünschten Kerne.
  • --memory: ganzzahliger Wert, der angibt, wie viel Arbeitsspeicher in der Maschine gewünscht ist. Es sollte eine Größeneinheit angegeben werden (z. B. 3.072 MB oder 9 GB). Wenn keine Einheiten angegeben sind, wird von GB ausgegangen.
  • --region: regionaler Standort der Instanz, z. B. asia-east1, us-east1. Falls nicht angegeben, wird standardmäßig us-central verwendet.

Führen Sie den Befehl gcloud sql instances create aus, um eine Cloud SQL-Instanz zu erstellen.

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD

IP-Adressbereich zuweisen und eine private Verbindung erstellen, um den Zugriff auf private Dienste für Cloud SQL zu konfigurieren

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

    Zur Seite VPC-Netzwerke

  2. Wählen Sie das VPC-Netzwerk default aus.
  3. Wählen Sie den Tab Private Dienstverbindung aus.
  4. Wählen Sie den Tab Diensten zugewiesene IP-Bereiche aus.
  5. Klicken Sie auf IP-Bereich zuweisen.
  6. Geben Sie als Name für den zugewiesenen Bereich google-managed-services-default an.
  7. Wählen Sie die Option Automatisch für den IP-Bereich aus und geben Sie die Präfixlänge als 16 an.
  8. Klicken Sie auf Zuweisen, um den zugewiesenen Bereich zu erstellen.
  9. Wählen Sie den Tab Private Verbindungen zu Diensten für das VPC-Netzwerk default aus.
  10. Klicken Sie auf Verbindung erstellen, um eine private Verbindung zwischen Ihrem Netzwerk und einem Dienstersteller herzustellen.
  11. Wählen Sie für Zugewiesene Zuordnung die Option google-managed-services-default aus.
  12. Klicken Sie auf Verbinden, um die Verbindung zu erstellen.

Instanz mit aktivierter privater IP-Adresse und SSL erstellen

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf Instanz erstellen.
  3. Klicken Sie auf PostgreSQL auswählen.
  4. Achten Sie darauf, dass Enterprise Plus als Cloud SQL-Version für Ihre Instanz ausgewählt ist.
  5. Geben Sie im Feld Instanz-ID den Wert quickstart-instance ein.
  6. Geben Sie im Feld Passwort ein Passwort für den Postgres-Nutzer ein. Speichern Sie dieses Passwort zur späteren Verwendung.
  7. Wählen Sie im Abschnitt Region und zonale Verfügbarkeit auswählen die Option Einzelne Zone aus.
  8. Klicken Sie auf das Menü Konfigurationsoptionen einblenden.
  9. Maximieren Sie den Knoten Maschinenkonfiguration.
  10. Wählen Sie im Bereich Maschinenformen die Form 4 vCPUs, 32 GB aus.
  11. Maximieren Sie den Knoten Verbindungen.
  12. Entfernen Sie das Häkchen aus dem Kästchen Öffentliche IP-Adressen, um nur eine Instanz mit einer privaten IP-Adresse zu erstellen.
  13. Klicken Sie auf das Kästchen Private IP-Adresse.
  14. Wählen Sie im Menü Netzwerk die Option Standard aus.
  15. Klicken Sie auf Instanz erstellen und warten Sie, bis die Instanz initialisiert und gestartet wurde.
  16. Klicken Sie auf Verbindungen.
  17. Wählen Sie im Abschnitt Sicherheit die Option Nur SSL-Verbindungen zulassen aus, um SSL-Verbindungen zu aktivieren.
  18. Klicken Sie im Dialogfeld Nur SSL-Verbindungen zulassen auf Speichern und warten Sie, bis die Instanz neu gestartet wurde.

IP-Adressbereich zuweisen und eine private Verbindung erstellen, um den Zugriff auf private Dienste für Cloud SQL zu konfigurieren

  1. Führen Sie den Befehl gcloud compute addresses create aus, um einen IP-Adressbereich zuzuweisen.

    gcloud compute addresses create google-managed-services-default \
    --global --purpose=VPC_PEERING --prefix-length=16 \
    --description="peering range for Google" --network=default
  2. Führen Sie den Befehl gcloud services vpc-peerings connect aus, um eine private Verbindung zum zugewiesenen IP-Adressbereich zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID Ihres Projekts.

    gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
    --ranges=google-managed-services-default --network=default \
    --project=YOUR_PROJECT_ID

Instanz mit aktivierter privater IP-Adresse und SSL erstellen

  1. Bevor Sie den folgenden Befehl ausführen, ersetzen Sie DB_ROOT_PASSWORD durch das Passwort Ihres Datenbanknutzers.

  2. Ändern Sie optional die Werte für die folgenden Parameter:

    • --database_version: der Typ und die Version des Datenbankmoduls. Falls nicht angegeben, wird der API-Standard verwendet. Die derzeit verfügbaren Versionen finden Sie in der Dokumentation zu gcloud-Datenbankversionen.
    • --cpu: Die Anzahl der Kerne in der Maschine.
    • --memory: Ein ganzzahliger Wert, der angibt, wie viel Arbeitsspeicher in die Maschine eingebaut werden soll. Es kann eine Größeneinheit angegeben werden (z. B. 3072 MB oder 9 GB). Wenn keine Einheiten angegeben sind, wird von GB ausgegangen.
    • --region: Der regionale Standort der Instanz, z. B. asia-east1, us-east1. Falls nicht angegeben, wird standardmäßig us-central1 verwendet. Eine vollständige Liste der Regionen finden Sie in diesem Artikel.

    Führen Sie den Befehl gcloud sql instances create aus, um eine Cloud SQL-Instanz mit einer privaten IP-Adresse zu erstellen.

    gcloud sql instances create quickstart-instance \
    --database-version=POSTGRES_14 \
     --cpu=1 \
     --memory=4GB \
     --region=us-central \
     --root-password=DB_ROOT_PASSWORD \
     --no-assign-ip \
    --network=default
  3. Führen Sie den Befehl gcloud sql instances patch aus, um nur SSL-Verbindungen für die Instanz zuzulassen.

  4. gcloud sql instances patch quickstart-instance --require-ssl

Datenbank erstellen

  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.

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

  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 Übersichtsseite 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 hinzufügen für die quickstart-instance 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.

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

  1. DB_PASS 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=DB_PASS

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

Cloud Run-Funktionen-Dienstkonto konfigurieren

Konfigurieren Sie das von Cloud Run-Funktionen verwendete Dienstkonto so, dass es die Rolle Cloud SQL-Client mit Berechtigungen zum Herstellen einer Verbindung zu Cloud SQL hat.
  1. Öffnen Sie in der Google Cloud Console die Seite IAM.

    IAM aufrufen

  2. Klicken Sie für das Dienstkonto Compute Engine-Standarddienstkonto auf das Stiftsymbol.
  3. Klicken Sie auf WEITERE ROLLE HINZUFÜGEN.
  4. Fügen Sie die Rolle namens Cloud SQL-Client hinzu.
  5. Klicken Sie auf Speichern.
  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-Dienstkontos.
  3. Führen Sie den folgenden Befehl aus, um Compute Engine-Dienstkonto 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"

Funktion erstellen

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

    Zu den Cloud Run-Funktionen

  2. Klicken Sie auf Funktion erstellen.
  3. Wählen Sie für die Umgebung den Punkt 2nd gen aus.
  4. Geben Sie im Feld Funktionsname den Wert quickstart-function ein.
  5. Wählen Sie im Bereich Authentifizierung die Option Nicht authentifizierte Aufrufe zulassen aus.
  6. Klicken Sie auf Weiter.
  7. Wählen Sie im Menü Laufzeit eine der folgenden Sprachen aus:
  8. Sprache Versionsnummer
    Go 1.20
    Java 17
    Node.js 18
    Python 3,10
  9. Prüfen Sie im Menü Quellcode, ob der Inline-Editor ausgewählt ist. In diesem Schritt verwenden Sie die im Editor enthaltene Standardfunktion.

Funktion implementieren

  1. Klicken Sie unten auf der Cloud Run-Funktionen-Seite auf Bereitstellen. Sie werden von der Google Cloud Console zur Detailseite der Funktion weitergeleitet.
  2. Wenn die Funktionsbereitstellung abgeschlossen ist, klicken Sie auf den Link URL, um einen Webbrowser mit der Nachricht Hello, World! aufzurufen.

Cloud SQL-Beispielanwendung als Funktion bereitstellen

Die Cloud SQL-Beispielanwendung wird als Funktion in Cloud Run-Funktionen konfiguriert und bereitgestellt. Zuerst konfigurieren und erstellen Sie die Beispielanwendung mit Cloud Shell. Anschließend stellen Sie die Beispielanwendung mit Cloud Run-Funktionen bereit.

Es gibt zwei Möglichkeiten, die Anwendung zu konfigurieren, zu erstellen und bereitzustellen, je nachdem, ob Sie eine Cloud SQL for PostgresSQL-Instanz mit einer öffentlichen IP-Adresse oder einer privaten IP-Adresse erstellt haben.

Cloud SQL-Beispielanwendung konfigurieren

Öffentliche IP-Adresse

Für öffentliche IP-Pfade bieten Cloud Run-Funktionen Verschlüsselung und Verbindungen über den Cloud SQL-Auth-Proxy mit Unix-Sockets.
  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.

    Cloud Shell-Editor öffnen

  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME
  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.

    Cloud Shell-Editor öffnen

  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl mvn in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
      -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
      -DskipTests -Djib.to.credHelper=gcloud
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME
  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.

    Cloud Shell-Editor öffnen

  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME
  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.

    Cloud Shell-Editor öffnen

  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME
Bei privaten IP-Pfaden stellt die Anwendung eine direkte Verbindung zu Ihrer Instanz über serverlosen VPC-Zugriff her. Bei dieser Methode wird ein TCP-Socket verwendet, um eine direkte Verbindung zur Cloud SQL-Instanz herzustellen, ohne den Cloud SQL Auth-Proxy zu verwenden.

SSL-Server- und Clientzertifikate erstellen und herunterladen

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf quickstart-instance, um die Übersichtsseite aufzurufen.
  3. Klicken Sie auf den Tab Verbindungen.
  4. Klicken Sie im Abschnitt Sicherheit auf Clientzertifikat erstellen.
  5. Geben Sie im Dialogfeld Clientzertifikat erstellen als Namen quickstart-key ein und klicken Sie auf Erstellen.
  6. Klicken Sie im Dialogfeld Neues SSL-Zertifikat erstellt auf den jeweiligen Link zum Herunterladen, um die Zertifikate herunterzuladen. Klicken Sie dann auf Schließen.

Serverlose VPC-Verbindung für Verbindungen zur Instanz über eine private IP-Adresse erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Serverloser VPC-Zugriff - Connector erstellen auf.

    Serverlosen VPC-Connector erstellen

  2. Geben Sie für den Namen quickstart-connector ein.
  3. Wählen Sie im Drop-down-Menü Netzwerk die Option Standard aus
  4. Wählen Sie im Drop-down-Menü Subnetz die Option Benutzerdefinierter IP-Bereich aus
  5. Geben Sie in das Eingabefeld IP-Bereich 10.8.0.0 ein.
  6. Klicken Sie auf Erstellen, um den Connector zu erstellen.

Beispielanwendung mit SSL-Zertifikaten erstellen

  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.
    Cloud Shell-Editor öffnen
  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Laden Sie SSL-Zertifikatsdateien in den Ordner Zertifikate hoch.
    1. Klicken Sie im Cloud Shell-Editor mit der rechten Maustaste auf den Ordner Zertifikate und wählen Sie Dateien hochladen aus.
    2. Wählen Sie auf Ihrem lokalen Computer folgende Dateien aus:
      • client-key.pem
      • client-cert.pem
      • server-ca.pem
    3. Klicken Sie bei drei ausgewählten SSL-Zertifikatsdateien auf Öffnen, um das Hochladen der Dateien in den Cloud Shell-Editor abzuschließen.
  6. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  7. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  8. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME

SSL-Server- und Clientzertifikate erstellen und herunterladen

Für Java-Nutzer stellt der Connector bereits eine sichere Verbindung bereit, sodass das Erstellen und Herunterladen von SSL-Server- und Clientzertifikaten nicht erforderlich ist.

Serverlose VPC-Verbindung für Verbindungen zur Instanz über eine private IP-Adresse erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Serverloser VPC-Zugriff - Connector erstellen auf.

    Serverlosen VPC-Connector erstellen

  2. Geben Sie für den Namen quickstart-connector ein.
  3. Wählen Sie im Drop-down-Menü Netzwerk die Option Standard aus
  4. Wählen Sie im Drop-down-Menü Subnetz die Option Benutzerdefinierter IP-Bereich aus
  5. Geben Sie in das Eingabefeld IP-Bereich 10.8.0.0 ein.
  6. Klicken Sie auf Erstellen, um den Connector zu erstellen.

Beispielanwendung erstellen

  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.
    Cloud Shell-Editor öffnen
  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Wenn das Dialogfeld Cloud Shell autorisieren angezeigt wird, klicken Sie auf Autorisieren.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl mvn in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
      -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
      -DskipTests -Djib.to.credHelper=gcloud
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME

SSL-Server- und Clientzertifikate erstellen und herunterladen

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf quickstart-instance, um die Übersichtsseite aufzurufen.
  3. Klicken Sie auf den Tab Verbindungen.
  4. Klicken Sie im Abschnitt Sicherheit auf Clientzertifikat erstellen.
  5. Geben Sie im Dialogfeld Clientzertifikat erstellen als Namen quickstart-key ein und klicken Sie auf Erstellen.
  6. Klicken Sie im Dialogfeld Neues SSL-Zertifikat erstellt auf den jeweiligen Link zum Herunterladen, um die Zertifikate herunterzuladen. Klicken Sie dann auf Schließen.

Serverlose VPC-Verbindung für Verbindungen zur Instanz über eine private IP-Adresse erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Serverloser VPC-Zugriff - Connector erstellen auf.

    Serverlosen VPC-Connector erstellen

  2. Geben Sie für den Namen quickstart-connector ein.
  3. Wählen Sie im Drop-down-Menü Netzwerk die Option Standard aus
  4. Wählen Sie im Drop-down-Menü Subnetz die Option Benutzerdefinierter IP-Bereich aus
  5. Geben Sie in das Eingabefeld IP-Bereich 10.8.0.0 ein.
  6. Klicken Sie auf Erstellen, um den Connector zu erstellen.

Beispielanwendung mit SSL-Zertifikaten erstellen

  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.
    Cloud Shell-Editor öffnen
  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Laden Sie SSL-Zertifikatsdateien in den Ordner Zertifikate hoch.
    1. Klicken Sie im Cloud Shell-Editor mit der rechten Maustaste auf den Ordner Zertifikate und wählen Sie Dateien hochladen aus.
    2. Wählen Sie auf Ihrem lokalen Computer folgende Dateien aus:
      • client-key.pem
      • client-cert.pem
      • server-ca.pem
    3. Klicken Sie bei drei ausgewählten SSL-Zertifikatsdateien auf Öffnen, um das Hochladen der Dateien in den Cloud Shell-Editor abzuschließen.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME

SSL-Server- und Clientzertifikate erstellen und herunterladen

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

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf quickstart-instance, um die Übersichtsseite aufzurufen.
  3. Klicken Sie auf den Tab Verbindungen.
  4. Klicken Sie im Abschnitt Sicherheit auf Clientzertifikat erstellen.
  5. Geben Sie im Dialogfeld Clientzertifikat erstellen als Namen quickstart-key ein und klicken Sie auf Erstellen.
  6. Klicken Sie im Dialogfeld Neues SSL-Zertifikat erstellt auf den jeweiligen Link zum Herunterladen, um die Zertifikate herunterzuladen. Klicken Sie dann auf Schließen.

Serverlose VPC-Verbindung für Verbindungen zur Instanz über eine private IP-Adresse erstellen

  1. Rufen Sie in der Google Cloud Console die Seite Serverloser VPC-Zugriff - Connector erstellen auf.

    Serverlosen VPC-Connector erstellen

  2. Geben Sie für den Namen quickstart-connector ein.
  3. Wählen Sie im Drop-down-Menü Netzwerk die Option Standard aus
  4. Wählen Sie im Drop-down-Menü Subnetz die Option Benutzerdefinierter IP-Bereich aus
  5. Geben Sie in das Eingabefeld IP-Bereich 10.8.0.0 ein.
  6. Klicken Sie auf Erstellen, um den Connector zu erstellen.

Beispielanwendung mit SSL-Zertifikaten erstellen

  1. Öffnen Sie im Cloud Shell-Editor den Quellcode der Beispielanwendung.
    Cloud Shell-Editor öffnen
  2. Klicken Sie im Dialogfeld In Cloud Shell öffnen auf Bestätigen, um den Beispielanwendungscode herunterzuladen und das Beispielanwendungsverzeichnis im Cloud Shell-Editor zu öffnen.
  3. Führen Sie in der Cloud Shell-Eingabeaufforderung in der unteren Hälfte des Bildschirms unter dem Cloud Shell-Editor den folgenden Befehl aus, um Ihr Projekt zu aktivieren. Ersetzen Sie YOUR_PROJECT_ID durch Ihre Projekt-ID.
    gcloud config set project YOUR_PROJECT_ID
  4. Laden Sie SSL-Zertifikatsdateien in den Ordner Zertifikate hoch.
    1. Klicken Sie im Cloud Shell-Editor mit der rechten Maustaste auf den Ordner Zertifikate und wählen Sie Dateien hochladen aus.
    2. Wählen Sie auf Ihrem lokalen Computer folgende Dateien aus:
      • client-key.pem
      • client-cert.pem
      • server-ca.pem
    3. Klicken Sie bei drei ausgewählten SSL-Zertifikatsdateien auf Öffnen, um das Hochladen der Dateien in den Cloud Shell-Editor abzuschließen.
  5. Führen Sie in Cloud Shell den folgenden gcloud artifacts repositories create-Befehl aus, um in der Artifact Registry mit dem Namen quickstart-repo in derselben Region wie Ihre Cloud SQL-Instanz ein Repository zu erstellen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud artifacts repositories create quickstart-repo \
      --project=YOUR_PROJECT_ID \
      --repository-format=docker \
      --location=YOUR_REGION_NAME \
      --description="Cloud Function Quickstart Cloud SQL sample app"
  6. Führen Sie den Befehl gcloud builds submit in Cloud Shell so aus, um einen Docker-Container zu erstellen und in der Artifact Registry zu veröffentlichen. Ersetzen Sie YOUR_PROJECT_ID durch die Projekt-ID und YOUR_REGION_NAME durch den Namen Ihrer Region.
    gcloud builds submit \
      --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .
  7. In gen2 von Cloud Run-Funktionen wird das automatische Konfigurieren und Ausführen des Cloud SQL Auth-Proxys nicht unterstützt. Diese Funktion wird durch die Verwendung von Cloud Run unterstützt. Sie müssen den zugrunde liegenden Cloud Run-Dienst manuell überarbeiten, um den Cloud SQL Auth-Proxy mit dem Dienst zu konfigurieren und auszuführen. Verwenden Sie dazu das Flag --add-cloudsql-instances. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz.
    gcloud run deploy quickstart-function --source . \
      --region YOUR_REGION_NAME \
      --add-cloudsql-instances INSTANCE_CONNECTION_NAME

Beispiel-App bereitstellen

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

Öffentliche IP-Adresse

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

    Zu den Cloud Run-Funktionen

  2. Wählen Sie die quickstart-function aus, die Sie in einem vorherigen Schritt dieser Kurzanleitung erstellt haben.
  3. Klicken Sie auf der Seite Funktionsdetails auf den Link im Bereich Unterstützt durch Cloud Run, um auf den zugrunde liegenden Cloud Run-Funktionsdienst zuzugreifen.
  4. Klicken Sie auf NEUE ÜBERARBEITUNG BEARBEITEN UND BEREITSTELLEN.
  5. Klicken Sie im Feld Container-Image-URL auf Auswählen.
    1. Wählen Sie den Tab Artifact Registry aus und maximieren Sie dann den Knoten quickstart-repo.
    2. Maximieren Sie den Container function-sql und wählen Sie dann das Container-Image aus, das Sie im vorherigen Schritt erstellt haben.
    3. Klicken Sie auf Auswählen.
  6. Erstellen Sie die folgenden Umgebungsvariablen, indem Sie im Bereich Umgebungsvariablen auf Variable hinzufügen klicken:
    • INSTANCE_UNIX_SOICKT: Auf /cloudsql/YOUR_PROJECT_ID:YOUR_REGION_NAME:quickstart-instance festlegen
    • DB_NAME: Legen Sie quickstart-db fest.
    • DB_USER: Legen Sie quickstart-user fest.
    • DB_PASS: Legen Sie das Passwort des quickstart-user fest, den Sie im vorherigen Schritt Nutzer erstellen angegeben haben.
  7. Herstellen einer Verbindung zu Cloud SQL aktivieren:

    1. Klicken Sie im Abschnitt Cloud SQL-Verbindungen auf Verbindung hinzufügen.
    2. Wählen Sie den Verbindungsnamen Ihrer Instanz aus.
  8. Klicken Sie unten auf der Seite auf Bereitstellen.
  9. Nachdem die quickstart-function bereitgestellt wurde, wird auf der Seite quickstart-function eine URL zum ausgeführten Dienst angezeigt. Klicken Sie auf den Link URL, um die in Cloud Run-Funktionen bereitgestellte Beispielanwendung zu sehen, die mit Cloud SQL verbunden ist. Die Anwendung sollte in etwa so aussehen:

    Screenshot: Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    -
    -gen2 \ --runtime go120 \ --trigger-http \ --allow-unauthenticated \ --entry-point Votes \ --region YOUR_REGION_NAME \ --set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \ --set-env-vars DB_USER=quickstart-user \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass die Cloud Run-Funktionen bereitgestellt wurden, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Screenshot: Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion für Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    -
    -gen2 \ --runtime java11 \ --trigger-http \ --allow-unauthenticated \ --entry-point com.example.cloudsql.functions.Main \ --region YOUR_REGION_NAME \ --set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \ --set-env-vars DB_USER=quickstart-user \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass die Cloud Run-Funktionen bereitgestellt wurden, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Screenshot: Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    -
    -gen2 \ --runtime nodejs18 \ --trigger-http \ --allow-unauthenticated \ --entry-point votes \ --region YOUR_REGION_NAME \ --set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \ --set-env-vars DB_USER=quickstart-user \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass die Cloud Run-Funktionen bereitgestellt wurden, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Screenshot: Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    -
    -gen2 \ --runtime python310 \ --trigger-http \ --allow-unauthenticated \ --entry-point votes \ --region YOUR_REGION_NAME \ --set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \ --set-env-vars DB_USER=quickstart-user \ --set-env-vars DB_PASS=DB_PASS \ --set-env-vars DB_NAME=quickstart-db
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass die Cloud Run-Funktionen bereitgestellt wurden, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Screenshot: Bereitgestellte Beispielanwendung ansehen

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

    Zu den Cloud Run-Funktionen

  2. Wählen Sie die quickstart-function aus, die Sie in einem vorherigen Schritt dieser Kurzanleitung erstellt haben.
  3. Klicken Sie auf der Seite Funktionsdetails auf den Link im Bereich Unterstützt durch Cloud Run, um auf den zugrunde liegenden Cloud Run-Funktionsdienst zuzugreifen.
  4. Klicken Sie auf NEUE ÜBERARBEITUNG BEARBEITEN UND BEREITSTELLEN.
  5. Klicken Sie im Feld Container-Image-URL auf Auswählen.
    1. Wählen Sie den Tab Artifact Registry aus und maximieren Sie dann den Knoten quickstart-repo.
    2. Maximieren Sie den Container function-sql und wählen Sie dann das Container-Image aus, das Sie im vorherigen Schritt erstellt haben.
    3. Klicken Sie auf Auswählen.
  6. Erstellen Sie die folgenden Umgebungsvariablen, indem Sie im Bereich Umgebungsvariablen auf Variable hinzufügen klicken:
    • DB_NAME: Legen Sie quickstart-db fest.
    • DB_USER: Legen Sie quickstart-user fest.
    • DB_PASS: Legen Sie das Passwort für den quickstart-user fest, den Sie in der vorherigen Kurzanleitung Nutzer erstellen angegeben haben.
    • INSTANCE_CONNECTION_NAME: Auf den Verbindungsnamen Ihrer Instanz eingestellt, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.
    • DB_PORT: Legen Sie 5432 fest.
    • INSTANCE_HOST: Legen Sie die private IP-Adresse Ihrer Instanz auf der Seite Cloud SQL-Instanzen in der Google Cloud Console fest.
    • DB_ROOT_CERT: Legen Sie certs/server-ca.pem fest.
    • DB_CERT: Legen Sie certs/client-cert.pem fest.
    • DB_KEY: Legen Sie certs/client-key.pem fest.
    • PRIVATE_IP: Legen Sie TRUE fest.
  7. Herstellen einer Verbindung zu Cloud SQL aktivieren:

    1. Klicken Sie im Abschnitt Cloud SQL-Verbindungen auf Verbindung hinzufügen.
    2. Wählen Sie den Verbindungsnamen Ihrer Instanz aus.
    3. Wählen Sie im Drop-down-Menü VPC-Netzwerk die Option default: Serverless VPC Access Connector "quickstart-connector" aus.
    4. Wählen Sie die Option Gesamten Traffic über den VPC-Connector weiterleiten aus.
  8. Klicken Sie unten auf der Seite auf Bereitstellen.
  9. Nachdem die quickstart-function bereitgestellt wurde, wird auf der Seite quickstart-function eine URL zum ausgeführten Dienst angezeigt. Klicken Sie auf den Link URL, um die in Cloud Run-Funktionen bereitgestellte Beispielanwendung zu sehen, die mit Cloud SQL verbunden ist. Die Anwendung sollte in etwa so aussehen:

    Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • PRIVATE_IP_ADDRESS ist die private IP-Adresse Ihrer Cloud SQL-Instanz, die in der Google Cloud Console auf der Seite Cloud SQL-Instanzen angezeigt wird.
    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime go120 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point Votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_PORT=5432 \
    --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
    --set-env-vars DB_CERT=certs/client-cert.pem \
    --set-env-vars DB_KEY=certs/client-key.pem \
    --set-env-vars PRIVATE_IP=TRUE

    Java-Nutzer sollten den Befehl gcloud functions deploy ohne die Flags INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY und PRIVATE_IP ausführen, um Cloud Run-Funktionen zu erstellen, da der Java-Connector bereits eine sichere Verbindung bietet:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime go120 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point Votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
    --set-env-vars PRIVATE_IP=TRUE
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass Cloud Run-Funktionen bereitgestellt wurde, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion für Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • PRIVATE_IP_ADDRESS ist die private IP-Adresse Ihrer Cloud SQL-Instanz, die in der Google Cloud Console auf der Seite Cloud SQL-Instanzen angezeigt wird.
    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime java11 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point com.example.cloudsql.functions.Main \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_PORT=5432 \
    --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
    --set-env-vars DB_CERT=certs/client-cert.pem \
    --set-env-vars DB_KEY=certs/client-key.pem \
    --set-env-vars PRIVATE_IP=TRUE

    Java-Nutzer sollten den Befehl gcloud functions deploy ohne die Flags INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY und PRIVATE_IP ausführen, um Cloud Run-Funktionen zu erstellen, da der Java-Connector bereits eine sichere Verbindung bietet:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime java11 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point com.example.cloudsql.functions.Main \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
    --set-env-vars PRIVATE_IP=TRUE
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass Cloud Run-Funktionen bereitgestellt wurde, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • PRIVATE_IP_ADDRESS ist die private IP-Adresse Ihrer Cloud SQL-Instanz, die in der Google Cloud Console auf der Seite Cloud SQL-Instanzen angezeigt wird.
    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime nodejs18 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_PORT=5432 \
    --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
    --set-env-vars DB_CERT=certs/client-cert.pem \
    --set-env-vars DB_KEY=certs/client-key.pem \
    --set-env-vars PRIVATE_IP=TRUE

    Java-Nutzer sollten den Befehl gcloud functions deploy ohne die Flags INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY und PRIVATE_IP ausführen, um Cloud Run-Funktionen zu erstellen, da der Java-Connector bereits eine sichere Verbindung bietet:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime nodejs18 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
    --set-env-vars PRIVATE_IP=TRUE
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass Cloud Run-Funktionen bereitgestellt wurde, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Bereitgestellte Beispielanwendung ansehen

  1. Führen Sie den folgenden gcloud functions deploy-Befehl aus, um eine gen2-Funktion in Cloud Run-Funktionen bereitzustellen. Aktualisieren Sie vor dem Ausführen des Befehls die folgenden Variablen:
    • YOUR_REGION_NAME ist der Name Ihrer Region
    • PRIVATE_IP_ADDRESS ist die private IP-Adresse Ihrer Cloud SQL-Instanz, die in der Google Cloud Console auf der Seite Cloud SQL-Instanzen angezeigt wird.
    • DB_PASS ist das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.
    • INSTANCE_CONNECTION_NAME ist der Verbindungsname der Instanz, der auf der Seite Cloud SQL-Instanzen in der Google Cloud Console angezeigt wird.

    Führen Sie den gcloud functions deploy-Befehl aus, um Cloud Run-Funktionen zu erstellen:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime python310 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_PORT=5432 \
    --set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
    --set-env-vars DB_CERT=certs/client-cert.pem \
    --set-env-vars DB_KEY=certs/client-key.pem \
    --set-env-vars PRIVATE_IP=TRUE

    Java-Nutzer sollten den Befehl gcloud functions deploy ohne die Flags INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY und PRIVATE_IP ausführen, um Cloud Run-Funktionen zu erstellen, da der Java-Connector bereits eine sichere Verbindung bietet:

    gcloud functions deploy quickstart-function \
    --gen2 \
    --runtime python310 \
    --trigger-http \
    --allow-unauthenticated \
    --entry-point votes \
    --region YOUR_REGION_NAME \
    --vpc-connector=quickstart-connector \
    --vpc-egress=all-traffic \
    --set-env-vars DB_NAME=quickstart-db \
    --set-env-vars DB_USER=quickstart-user \
    --set-env-vars DB_PASS=DB_PASS \
    --set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
    --set-env-vars PRIVATE_IP=TRUE
  2. Nachdem Sie eine Bestätigungsnachricht erhalten haben, dass Cloud Run-Funktionen bereitgestellt wurde, klicken Sie in der Nachricht auf den Link Dienst-URL, um die bereitgestellte Beispielanwendung für Cloud Run-Funktionen aufzurufen, die mit Cloud SQL verbunden ist.

    Bereitgestellte Beispielanwendung ansehen

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die in dieser Anleitung 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. Wechseln Sie in der Google Cloud Console zur Seite Cloud Run-Funktionen.

    Zu den Cloud Run-Funktionen

  6. Klicken Sie auf das Kästchen neben dem Dienstnamen quickstart-function.
  7. Klicken Sie oben auf der Seite Cloud Run-Funktionen 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. Öffnen Sie in der Google Cloud Console die Seite IAM.

    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. Öffnen Sie in der Google Cloud Console die Seite APIs.

    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: