Mit Compute Engine eine Verbindung zu Cloud SQL for PostgreSQL herstellen

Erfahren Sie, wie Sie eine Beispielanwendung auf Ihrer Compute Engine-VM-Instanz unter Linux oder Windows bereitstellen, die über die Google Cloud Console und eine Clientanwendung mit einer PostgreSQL-Instanz verbunden ist.

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. 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 Cloud SQL-Beispielanwendung auf einer Compute Engine-VM-Instanz erforderlich sind.

    Console

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

    APIs aktivieren

    Dadurch wird die folgende API aktiviert:

    • Cloud SQL Admin API

    gcloud

    Installieren Sie die gcloud CLI, die Befehlszeilenzugriff auf Ihre Google Cloud-Ressourcen bietet. Die gcloud CLI dient hier zur Ausführung der in dieser Kurzanleitung vorgestellten gcloud CLI-Befehle. Alle Befehle sind so formatiert, dass sie in einem Terminal oder in einem PowerShell-Fenster ausgeführt werden.

    Führen Sie folgenden Befehl gcloud aus:

    gcloud services enable sqladmin.googleapis.com

    Mit diesem Befehl wird die folgende API aktiviert:

    • Cloud SQL Admin API

Cloud SQL einrichten

Cloud SQL-Instanz erstellen

Datenbank erstellen

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. Öffnen Sie den Tab Datenbanken.
  4. Klicken Sie auf Datenbank erstellen.
    1. Geben Sie im Dialogfeld Neue Datenbank quickstart_db als Namen für die Datenbank 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

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 instance_name 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 die gleichen Längenbeschränkungen für Nutzernamen wie für lokales PostgreSQL.

Compute Engine-Dienstkonto konfigurieren

Erstellen und konfigurieren Sie ein Google Cloud-Dienstkonto mit der Rolle Cloud SQL-Client mit Berechtigungen zum Herstellen einer Verbindung zu Cloud SQL. Nachdem Sie ein Dienstkonto erstellt haben, müssen Sie möglicherweise 60 Sekunden oder länger warten, bis Sie das Dienstkonto verwenden können.

Console

Dienstkonto erstellen

  1. Wechseln Sie in der Google Cloud Console zur Seite Dienstkonto erstellen.
  2. Zur Seite „Dienstkonto erstellen“

  3. Wählen Sie ein Google Cloud-Projekt aus.
  4. Geben Sie ein quickstart-service-account als Namen des Dienstkontos ein.
  5. Optional: Geben Sie eine Beschreibung für das Dienstkonto ein.
  6. Klicken Sie auf Erstellen und fortfahren und fahren Sie mit dem nächsten Schritt fort.
  7. Wählen Sie die Rolle Cloud SQL-Client aus, die dem Dienstkonto für das Projekt zugewiesen werden soll.
  8. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie die Rolle Storage-Objekt-Betrachter aus, die dem Dienstkonto für das Projekt zugewiesen werden soll.
  9. Klicken Sie auf Weiter.
  10. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

gcloud

Dienstkonto erstellen

  1. Führen Sie den Befehl gcloud iam service-accounts create aus, um das Dienstkonto zu erstellen.
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    Ersetzen Sie den folgenden Wert:

    • DESCRIPTION: Eine optionale Beschreibung des Dienstkontos.
  3. So weisen Sie Ihrem Dienstkonto die folgende Rolle zu:Cloud SQL-Client die Rolle und dieStorage-Objekt-Betrachter führen Sie den folgenden Befehl aus: gcloud projects add-iam-policy-binding. Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client" --role="roles/storage.objectViewer"

Compute Engine-VM-Instanz erstellen

Erstellen Sie eine Compute Engine-VM-Instanz, um eine Beispielwebanwendung zu hosten, die eine Verbindung zu Cloud SQL herstellt.

Auf Compute Engine-VM-Instanz zugreifen

Entwicklungsumgebung für die Programmiersprache einrichten

Richten Sie die Entwicklungsumgebung der Compute Engine-VM-Instanz für Ihre bevorzugte Programmiersprache ein.

Git installieren

Installieren Sie Git, ein Open-Source-Versionsverwaltungssystem, auf Ihrer Compute Engine-VM-Instanz.

Beispielanwendung klonen

Klonen Sie eine Beispielanwendung mit dem Befehl git clone auf Ihre Compute Engine-VM-Instanz.

Go

Öffnen Sie auf der Compute Engine-VM-Instanz ein neues Terminal oder PowerShell-Fenster. Führen Sie die folgenden Befehle aus, um die Go-Beispielanwendung zu klonen, und ändern Sie das Verzeichnis in das Verzeichnis, das die Beispielanwendung enthält.

  1. Klonen Sie die Beispielanwendung.
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.
    cd golang-samples/cloudsql/postgres/database-sql

Java

Öffnen Sie auf der Compute Engine-VM-Instanz ein neues Terminal oder PowerShell-Fenster. Führen Sie die folgenden Befehle aus, um die Java-Beispielanwendung zu klonen, und ändern Sie das Verzeichnis in das Verzeichnis, das die Beispielanwendung enthält.

  1. Klonen Sie die Beispielanwendung.
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.
    cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Öffnen Sie auf der Compute Engine-VM-Instanz ein neues Terminal oder PowerShell-Fenster. Führen Sie die folgenden Befehle aus, um die Node.js-Beispielanwendung zu klonen, und ändern Sie das Verzeichnis in das Verzeichnis, das die Beispielanwendung enthält.

  1. Klonen Sie die Beispielanwendung.
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.
    cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Öffnen Sie auf der Compute Engine-VM-Instanz ein neues Terminal oder PowerShell-Fenster. Führen Sie die folgenden Befehle aus, um die Python-Beispielanwendung zu klonen, und ändern Sie das Verzeichnis in das Verzeichnis, das die Beispielanwendung enthält.

  1. Klonen Sie die Beispielanwendung.
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.
    cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Cloud SQL-Beispielanwendung konfigurieren und ausführen

Mit einer Cloud SQL-Instanz, -Datenbank und -Dienstkonto mit Clientberechtigungen können Sie jetzt eine Beispielanwendung konfigurieren, die auf Ihrer Compute Engine-VM-Instanz ausgeführt wird, um eine Verbindung zu Ihrer Cloud SQL-Instanz herzustellen.

Bereinigen

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

Cloud SQL-Instanz löschen

  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.

Compute Engine-VM-Instanz löschen

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

    Zu Seite „VM-Instanzen“

  2. Wählen Sie die Instanz quickstart-vm-instance aus, um die Seite Instanzendetails zu öffnen.
  3. Klicken Sie oben auf der Seite in der Symbolleiste auf Löschen.
  4. Klicken Sie auf Löschen , um die Instanz zu löschen.

Optionale Bereinigungsschritte

Wenn Sie nicht die Rolle Cloud SQL-Client verwenden, die Sie dem Compute Engine default-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 nicht die API verwenden, die im Rahmen dieser Kurzanleitung aktiviert wurde, können Sie sie deaktivieren.

  • In dieser Kurzanleitung aktivierte APIs:
    • Cloud SQL Admin 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: