Kurzanleitung für die Verwendung des Cloud SQL Auth-Proxys

Auf dieser Seite erfahren Sie, wie Sie mithilfe des Cloud SQL Auth-Proxys von einer lokalen Testumgebung eine Verbindung zu Cloud SQL herstellen. Die Verbindung über den Cloud SQL Auth-Proxy ermöglicht Ihnen das Testen einer App Engine-Anwendung in Ihrer lokalen Umgebung oder das Herstellen einer sicheren Verbindung zum Verwalten von Datenbanken.

Verwenden Sie diese Anleitung nicht, um den Cloud SQL Auth-Proxy für eine Produktionsumgebung einzurichten. Weitere Verbindungsoptionen finden Sie unter Über den Cloud SQL Auth-Proxy verbinden.

Hinweis

Bevor Sie die Schritte in dieser Kurzanleitung ausführen, sollten Sie die folgenden Aufgaben ausführen:

  • Erstellen Sie ein Google Cloud-Projekt und eine Cloud SQL-Instanz.
  • Wenn Sie ein bereits vorhandenes Projekt verwenden, prüfen Sie, ob Ihr Google Cloud-Nutzer Inhaber Ihres Projekts ist oder die IAM-Rolle Cloud SQL Client hat.
  • Installieren Sie einen mysql-Client.

    Mit dem Client können Sie die Verbindung zu Ihrer Instanz testen. Der mysql-Client kann zusammen mit dem Serverpaket installiert werden. Einige Betriebssysteme unterstützen auch das Paket, in dem nur der Client enthalten ist. MySQL-Installationsanleitung

  • Aktivieren Sie die Admin API.

  • Installieren Sie das gcloud-Befehlszeilentool und authentifizieren Sie es.

    1. Installieren Sie das gcloud-Befehlszeilentool, falls noch nicht geschehen. Weitere Informationen finden Sie in der Anleitung zur gcloud-Installation.
    2. Initialisieren Sie das gcloud-Tool:
      gcloud init
    3. Authentifizieren Sie das gcloud-Tool:
      gcloud auth login

Cloud SQL Auth-Proxy-Client auf dem lokalen Computer installieren

Welches Cloud SQL Auth-Proxy-Binärprogramm Sie herunterladen müssen, hängt davon ab, welches Betriebssystem Sie nutzen und ob darin ein 32-Bit- oder ein 64-Bit-Kernel verwendet wird. Auf neuerer Hardware wird meistens ein 64-Bit-Kernel verwendet. Wenn Sie sich nicht sicher sind, ob auf Ihrem Computer ein 64-Bit-Kernel ausgeführt wird, verwenden Sie unter Linux oder macOS den Befehl uname -a oder klicken Sie im Startmenü von Windows auf Computer > Eigenschaften.

Linux 64-Bit

  1. Laden Sie den Cloud SQL Auth-Proxy herunter:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Machen Sie den Cloud SQL Auth-Proxy ausführbar:
    chmod +x cloud_sql_proxy
    

Linux 32-Bit

  1. Laden Sie den Cloud SQL Auth-Proxy herunter:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Machen Sie den Cloud SQL Auth-Proxy ausführbar:
    chmod +x cloud_sql_proxy
    

macOS 64-Bit

  1. Laden Sie den Cloud SQL Auth-Proxy herunter:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. Machen Sie den Cloud SQL Auth-Proxy ausführbar:
    chmod +x cloud_sql_proxy
    

macOS 32-Bit

  1. Laden Sie den Cloud SQL Auth-Proxy herunter:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Machen Sie den Cloud SQL Auth-Proxy ausführbar:
    chmod +x cloud_sql_proxy
    

Windows 64-Bit

Klicken Sie mit der rechten Maustaste auf https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe, wählen Sie Link speichern unter aus und laden Sie den Cloud SQL Auth-Proxy herunter. Benennen Sie die Datei in cloud_sql_proxy.exe um.

Windows 32-Bit

Klicken Sie mit der rechten Maustaste auf https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe, wählen Sie Link speichern unter aus und laden Sie den Cloud SQL Auth-Proxy herunter. Benennen Sie die Datei in cloud_sql_proxy.exe um.

Docker-Image des Cloud SQL Auth-Proxys

Das Cloud SQL-Team verwaltet zur Vereinfachung mehrere Container-Images, die den Cloud SQL Auth-Proxy zur Verwendung durch unsere Kunden enthalten. Weitere Informationen zu diesen Images finden Sie im Cloud SQL Auth-Proxy-Repository auf GitHub. Mit folgendem Befehl können Sie das neueste Image mithilfe von Docker auf Ihren lokalen Computer übertragen:
docker pull gcr.io/cloudsql-docker/gce-proxy:1.19.1

Andere Betriebssysteme

Für andere Betriebssysteme, die hier nicht aufgeführt sind, können Sie den Cloud SQL Auth-Proxy aus der Quelle kompilieren.

Name der Instanzverbindung abrufen

  1. Zur Seite "Cloud SQL-Instanzen"
  2. Klicken Sie auf den Instanznamen, um die zugehörige Seite Instanzdetails zu öffnen.
  3. Unter Mit dieser Instanz verbinden finden Sie den Namen der Instanzverbindung.

Cloud SQL Auth-Proxy starten

Starten Sie den Cloud SQL Auth-Proxy in einem eigenen Terminal, damit Sie die Ausgabe überwachen können. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Namen der Instanzverbindung, den Sie im vorherigen Schritt kopiert haben.

Verwenden Sie in Linux-Umgebungen den folgenden Befehl, um den Cloud SQL Auth-Proxy zu starten:

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306

Verwenden Sie in PowerShell unter Windows den folgenden Befehl, um den Cloud SQL Auth-Proxy zu starten:

.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:3306

Es wird dann eine Meldung wie die folgende angezeigt:

Listening on 127.0.0.1:3306 for myproject:myregion:myinstance.
Ready for new connections

Verbindung zur Datenbank über den MySQL-Client herstellen

Dieser Abschnitt ist optional, wird aber zum Testen der Verbindung empfohlen. MySQL-Installationsanleitung

Führen Sie in einem anderen Terminalfenster als dem, in dem Sie den Cloud SQL Auth-Proxy gestartet haben, den folgenden Befehl aus. Ersetzen Sie dabei <USERNAME> durch Ihren MySQL-Nutzernamen.

mysql -u <USERNAME> -p --host 127.0.0.1 --port 3306

Die mysql-Eingabeaufforderung wird geöffnet und im Cloud SQL Auth-Proxy-Terminal wird eine Meldung wie diese angezeigt:

New connection for "myproject:us-central1:myinstance"

Bereinigen

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

  1. Öffnen Sie in der Google Cloud Console die Seite "Cloud SQL-Instanzen".
    Zur Seite "Cloud SQL-Instanzen"
  2. Wählen Sie die Instanz myinstance aus, um die Seite Instanzdetails zu öffnen.
  3. Klicken Sie oben auf der Seite in der Symbolleiste auf Löschen.
  4. Geben Sie im Fenster Instanz löschen den Wert myinstance ein und klicken Sie dann auf Löschen, um die Instanz zu löschen.

    Nach dem Löschen einer Instanz kann der Instanzname etwa 7 Tage lang nicht wiederverwendet werden.

Nächste Schritte