Verbindung zu einer Cloud SQL for PostgreSQL-Instanz mit privater IP-Adresse herstellen

Verbindung zu einer Cloud SQL for PostgreSQL-Instanz mit privater IP-Adresse herstellen

MySQL   |  PostgreSQL   |  SQL Server

Auf dieser Seite erfahren Sie, wie Sie eine PostgreSQL-Instanz über eine private IP-Adresse erstellen und eine Verbindung zu ihr herstellen. Die in dieser Kurzanleitung erstellten Ressourcen kosten in der Regel weniger als einen Dollar, vorausgesetzt, Sie führen die Schritte, einschließlich der Bereinigung, zeitnah durch.

---

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

Anleitung

---

Hinweis

Hinweis: Der Name, den Sie für Ihr Projekt verwenden, muss zwischen 4 und 30 Zeichen lang sein. Bei der Eingabe des Namens schlägt das Formular eine Projekt-ID vor, die Sie ändern können. Die Projekt-ID muss zwischen 6 und 30 Zeichen lang sein und mit einem Kleinbuchstaben beginnen. Für die restlichen Zeichen können Sie Bindestriche, Kleinbuchstaben und Ziffern verwenden. Das letzte Zeichen darf jedoch kein Bindestrich sein.

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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Kurzanleitung erforderlich sind.
2. Aktivieren Sie die erforderlichen Google Cloud APIs.

   Console

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

   Zu „APIs“

   Cloud SQL Admin API aktivieren. Durch Aktivieren dieser API können Sie den Cloud SQL Auth-Proxy ausführen.

   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 services enable-Befehl mit Cloud Shell aus, um die für diese Kurzanleitung erforderlichen APIs zu aktivieren:

   gcloud services enable sqladmin.googleapis.com

   Mit diesem Befehl werden die folgenden APIs aktiviert:

   • Cloud SQL Admin API. Durch Aktivieren dieser API können Sie den Cloud SQL Auth-Proxy ausführen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, das Sie einrichten und mit dem Sie eine Verbindung herstellen möchten, um die Berechtigungen zu erhalten, die Sie zum Einrichten von Cloud SQL mit einer privaten IP-Adresse benötigen:

• Instanz, Datenbank und Nutzer erstellen oder löschen: Cloud SQL-Administratorrolle (roles/cloudsql.admin).
• IAM-Dienstkonto erstellen oder löschen: Rolle „IAM Service Account Administrator“ (roles/iam.serviceAccountAdmin).
• Compute-Instanz erstellen oder löschen:
  • Rolle „Compute-Administrator“ (roles/compute.admin)
  • Rolle „Compute-Instanzadministrator“ (roles/compute.instanceAdmin.v1).
• Verbindung herstellen:
  • Service Networking-Administrator (roles/servicenetworking.networksAdmin))
  • Service Usage-Administrator (roles/serviceusage.serviceUsageAdmin).

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.

Übersicht

Es gibt viele Möglichkeiten, eine Verbindung zu einer Cloud SQL-Instanz über eine private IP-Adresse herzustellen, je nachdem, wo sich die Quelle befindet. Entscheidend ist, dass sich die Quellmaschine im selben VPC-Netzwerk wie die Cloud SQL-Instanz befinden muss. Wenn sich die Quelle nicht in Google Cloud oder im selben Google Cloud Projekt befindet, müssen Sie die Verbindungen anders konfigurieren als hier gezeigt.

In dieser Kurzanleitung wird die Konnektivität über den direktesten Pfad konfiguriert. Die Quelle und das Ziel befinden sich im selben Google Cloud -Projekt und im selben VPC-Netzwerk. Wir erstellen eine Cloud SQL-Instanz mit einer privaten IP-Adresse (dem Ziel) und einer Compute Engine-VM (der Quelle). Mithilfe der VM installieren und verwenden wir die Tools, die für die Verbindung von der VM zur Cloud SQL-Instanz erforderlich sind.

Führen Sie folgende Aktionen durch:

1. Erstellen Sie eine Cloud SQL-Instanz mit einer privaten IP-Adresse.

   Suchen und speichern Sie den connection name der Instanz für später.

2. Erstellen Sie eine Compute Engine-VM.
3. Öffnen Sie zwei SSH-Verbindungen zur Compute Engine-VM.

   Im ersten Fenster installieren Sie psql und den Cloud SQL Auth-Proxy und starten den Cloud SQL Auth-Proxy. Dann stellen Sie im zweiten Fenster eine Verbindung zur Cloud SQL-Instanz her. Stellen Sie dazu eine Verbindung zum Cloud SQL Auth-Proxy her.

4. Gehen Sie im SSH-Fenster Nr. 1 so vor:
   1. Installieren Sie den psql-Client.
   2. Installieren Sie den Cloud SQL Auth-Proxy.

      Der Cloud SQL Auth-Proxy fungiert als Verbindung zwischen dem psql-Client und der Cloud SQL-Instanz.

   3. Starten Sie den Cloud SQL Auth-Proxy.

      Bei Erfolg überwacht der Cloud SQL-Auth-Proxy die Verbindungsanfragen.

5. Stellen Sie im SSH-Fenster Nr. 2 eine Verbindung zur Cloud SQL-Instanz her. Der psql-Client muss dafür eine Verbindung zum Cloud SQL Auth-Proxy herstellen.

   Bei Erfolg wird in diesem Fenster die Eingabeaufforderung von psql angezeigt und im SSH-Fenster Nr. 1, in dem der Cloud SQL Auth-Proxy ausgeführt wird, wird eine Nachricht über die erfolgreiche Verbindung angezeigt.

6. Führen Sie eine Bereinigung durch.

Cloud SQL-Instanz mit einer privaten IP-Adresse erstellen

So erstellen Sie eine Instanz, die private IP-Verbindungen verwendet:

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

   Cloud SQL-Instanzen aufrufen

2. Wählen Sie den Tab „PostgreSQL“ aus und klicken Sie im Feld Sandbox auf Sandbox-Instanz erstellen. Alternativ können Sie auf Instanz erstellen klicken und so vorgehen:
1. Klicken Sie auf PostgreSQL auswählen.
2. Wählen Sie die Enterprise-Version aus.
3. Wählen Sie die Voreinstellung Sandbox aus.
3. Wenn Sie aufgefordert werden, die Compute API zu aktivieren, klicken Sie auf die Schaltfläche API aktivieren.
4. Geben Sie im Abschnitt Instanzinformationen einen Namen für die Instanz-ID ein.
5. Geben Sie das Passwort für den Postgres-Nutzer ein. Notieren Sie sich das erstellte Passwort, da Sie es später benötigen.
6. Wählen Sie im Abschnitt Region und zonale Verfügbarkeit auswählen die Option Einzelne Zone aus.
7. Maximieren Sie Konfigurationsoptionen einblenden.
8. Maximieren Sie Verbindungen.
9. Löschen Sie Öffentliche IP-Adresse.
10. Wählen Sie Private IP-Adresse aus.
11. Wählen Sie Zugriff auf private Dienste aus.
12. Wählen Sie im Drop-down-Menü VPC-Netzwerk die Option Standard aus.
13. Wenn Sie ein neues Projekt verwenden, wird Ihnen die Meldung Netzwerkverbindung ist nicht eingerichtet angezeigt. Ein Feld mit dem Titel Bestätigung der Netzwerkeinrichtung erforderlich verweist Sie auf die VPC-Dokumentation zum Einrichten von PSA.
1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf:

   Zur Seite VPC-Netzwerke

2. Wählen Sie das Standard-VPC-Netzwerk default aus.
3. Legen Sie eine Firewallregel fest, die den Zugriff auf TCP-Port 22 zulässt:
1. Wählen Sie den Tab Firewall aus.
2. Wählen Sie unter VPC-Firewallregeln die Option VPC-Firewallregel erstellen aus.
3. Geben Sie der Firewallregel einen Namen.
4. Wählen Sie unter Ziele die Option Alle Instanzen im Netzwerk aus.
5. Geben Sie unter Quell-IPv4-Bereiche 0.0.0.0/0 ein.
6. Klicken Sie unter Protokolle und Ports das Kästchen neben TCP an und geben Sie im Feld Ports direkt darunter 22 ein.
7. Wählen Sie Erstellen aus.
4. IP-Adressbereich zuweisen:
1. Wählen Sie den Tab Zugriff auf private Dienste aus.
2. Wählen Sie auf dem Tab Zugriff auf private Dienste den Tab Diensten zugewiesene IP-Bereiche aus.
3. Klicken Sie auf IP-Bereich zuweisen.
4. Geben Sie einen Namen und optional eine Beschreibung für den zugewiesenen Bereich ein.
5. Wenn Google einen verfügbaren Bereich auswählen soll, wählen Sie Automatisch aus.
6. Geben Sie eine Präfixlänge zwischen 16 und 124 ein. Die Anzahl der zugewiesenen Adressen entspricht 2 ^ (32 – Präfixlänge).
7. Klicken Sie auf Zuweisen, um den zugewiesenen Bereich zu erstellen.
5. Private Verbindung erstellen:
1. Wechseln Sie auf dem Tab Zugriff auf private Dienste zum Tab Private Verbindungen zu Diensten.
2. Klicken Sie auf die Schaltfläche Verbindung erstellen.
3. Wählen Sie im Drop-down-Menü Zugewiesene Zuweisung im Feld Private Verbindung erstellen den Namen des IP-Adressbereichs aus, den Sie gerade erstellt haben.
4. Klicken Sie auf Verbinden.
6. Wenn die Verbindung hergestellt wurde, kehren Sie zu der Stelle zurück, an der Sie die Cloud SQL-Instanz erstellt haben, und klicken Sie auf Verbindung bestätigen.
14. Wenn die PSA-Verbindung erfolgreich erstellt wurde, klicken Sie auf Instanz erstellen.

Sie werden zur Seite „Instanzübersicht“ weitergeleitet, während die neue Instanz erstellt wird.

Scrollen Sie nach Abschluss der Instanzerstellung zum Abschnitt Mit dieser Instanz verbinden und speichern Sie den Verbindungsnamen der Instanz. Der connection name hat das Format projectID:region:instanceID. Sie benötigen diesen connection name später beim Starten des Cloud SQL Auth-Proxys.

Datenbank erstellen

Wenn Sie eine Datenbank erstellen möchten, wählen Sie im Navigationsbereich auf der linken Seite Datenbanken aus und gehen Sie dann so vor:

1. Wählen Sie Datenbank erstellen aus.
2. Geben Sie in das Feld Datenbankname einen DB_NAME ein.
3. Klicken Sie auf Erstellen.

Sie benötigen diesen db_name später, wenn Sie eine Verbindung über den Cloud SQL Auth-Proxy herstellen.

Compute Engine-VM erstellen

So erstellen Sie eine VM:

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

   Zur Seite „VM-Instanzen“

2. Klicken Sie auf Instanz erstellen.
3. Geben Sie einen Namen für die Instanz ein.
4. Wählen Sie im Navigationsbereich Datenschutz und dann Keine Sicherungen aus.
5. Wählen Sie im Navigationsbereich Sicherheit aus und wählen Sie unter Zugriffsbereiche die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus.
6. Klicken Sie auf Erstellen und warten Sie, bis die VM erstellt wurde.

Zwei SSH-Verbindungen zur Compute Engine-VM öffnen

Wir verwenden zwei Fenster in der VM. Das erste Fenster wird verwendet, um den psql-Client und den Cloud SQL Auth-Proxy zu installieren, den Namen der Instanzverbindung abzurufen und ihn zum Starten des Proxys zu verwenden. Das zweite Fenster wird verwendet, um über den Proxy eine Verbindung zur Cloud SQL-Instanz herzustellen.

1. Maximieren Sie für die Compute Engine-VM-Instanz in der Spalte Verbinden das Menü SSH.
2. Wählen Sie Im Browserfenster öffnen aus, um das SSH-Fenster 1 zu öffnen.

   Es kann einige Sekunden dauern, bis Ihnen die Eingabeaufforderung im Fenster angezeigt wird.

3. Wenn die Eingabeaufforderung angezeigt wird, geben Sie pwd ein, um zu prüfen, ob Sie sich im Verzeichnis /home/$USER befinden.

   In diesem Fenster installieren Sie den psql-Client und den Cloud SQL Auth-Proxy und starten den Cloud SQL Auth-Proxy auch.

4. Wählen Sie noch einmal Im Browserfenster öffnen aus, um das SSH-Fenster 2 zu öffnen.

   In diesem Fenster stellen Sie eine Verbindung zu Ihrer Cloud SQL-Instanz her.

psql-Client installieren

Verwenden Sie für diesen Schritt das SSH-Fenster 1.

Installieren Sie den psql-Client aus dem Paketmanager:

sudo apt-get update
sudo apt-get install postgresql-client
  

Cloud SQL Auth-Proxy installieren

Verwenden Sie für diesen Schritt das SSH-Fenster 1.

1. Installieren Sie wget:

   sudo apt-get install wget
       

2. Laden Sie den Cloud SQL Auth-Proxy herunter:

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Machen Sie den Cloud SQL Auth-Proxy ausführbar:

   chmod +x cloud-sql-proxy
     

Cloud SQL Auth-Proxy starten

Verwenden Sie für diesen Schritt das SSH-Fenster 1.

Starten Sie den Cloud SQL Auth-Proxy, damit Sie seine Ausgabe überwachen können. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den connection name, den Sie beim Erstellen der Cloud SQL-Instanz kopiert haben.

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

Hinweis:Standardmäßig versucht der Cloud SQL Auth-Proxy, eine Verbindung zu Ihrer Cloud SQL-Instanz über eine öffentliche IPv4-Adresse herzustellen. Wenn für die Instanz nur eine private IP-Adresse oder sowohl eine öffentliche als auch eine private IP konfiguriert ist und der Cloud SQL Auth-Proxy die private IP-Adresse verwenden soll, müssen Sie die --private-ip-Option angeben, wenn Sie den Cloud SQL Auth-Proxy starten.

Wenn Sie eine Fehlermeldung erhalten, dass die Adresse bereits verwendet wird, bedeutet dies, dass eine lokale Instanz der Datenbank ausgeführt wird und Sie diese beenden müssen. Ermitteln Sie den SERVICE_NAME, indem Sie erst den Befehl ps -ef | grep psql und anschließend den folgenden Befehl ausführen:

sudo service SERVICE_NAME stop
   

Wenn der Cloud SQL Auth-Proxy erfolgreich gestartet wurde, wird im SSH-Fenster eine Meldung wie die diese angezeigt:

Listening on 127.0.0.1:5432 for myInstance
Ready for new connections

Verbindung zur Cloud SQL-Instanz herstellen

Verwenden Sie für diesen Schritt das SSH-Fenster 2.

Führen Sie den folgenden Befehl aus, nachdem Sie DB_NAME durch den Namen der Cloud SQL-Datenbank ersetzt haben:

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=DB_NAME user=postgres"

Geben Sie bei der Eingabeaufforderung "Passwort eingeben" das Passwort Ihres PostgreSQL-Kontos ein.

Prüfen Sie, ob die PostgreSQL-Eingabeaufforderung angezeigt wird. Sie haben über den psql-Client eine Verbindung zu Ihrer Datenbank hergestellt.

Kehren Sie zum Terminalfenster zurück, in dem Sie den Cloud SQL Auth-Proxy gestartet haben. Es wird eine Meldung ähnlich der folgenden angezeigt:

New connection for myInstance

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 myinstance aus, um die Seite Instanzendetails zu öffnen.
3. Klicken Sie oben auf der Seite in der Symbolleiste auf Löschen.
4. Geben Sie im Fenster Instanz löschen den Namen der Instanz ein und klicken Sie dann auf Löschen.

Optionale Bereinigungsschritte

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:
  • Cloud SQL Admin API

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

   Zu „APIs“

2. Wählen Sie die Cloud SQL Admin API aus und klicken Sie dann auf den Button API deaktivieren.

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

   Zur Seite „VM-Instanzen“

4. Wählen Sie den Namen Ihrer Instanz aus.

5. Wählen Sie im Menü Weitere Aktionen die Option Löschen aus.

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.

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

• Aus einer Anwendung, die in der App Engine-Standardumgebung ausgeführt wird
• Aus einer Anwendung, die in GKE ausgeführt wird
• Aus Cloud Run