Verbindung zu Cloud SQL for MySQL von Ihrem lokalen Computer herstellen

Hier erfahren Sie, wie Sie eine Beispielanwendung auf Ihrem Linux-, macOS- oder Windows-basierten lokalen Computer bereitstellen, der mit einer MySQL Server-Instanz über die Google Cloud Console und eine Clientanwendung 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 Ihrem lokalen Computer erforderlich sind.

    Console

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

    APIs aktivieren

    Dadurch werden die folgenden APIs aktiviert:

    • Cloud SQL Admin API
    • IAM 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 zur Ausführung in einem Linux/macOS-Terminal oder in Windows Powershell formatiert.

    Öffnen Sie das Terminal und führen Sie den folgenden gcloud-Befehl aus:

    gcloud services enable sqladmin.googleapis.com iam.googleapis.com

    Mit diesem Befehl werden die folgenden APIs aktiviert:

    • Cloud SQL Admin API
    • IAM API

Cloud SQL einrichten

Cloud SQL-Instanz erstellen

Console

Instanz mit öffentlicher IP-Adresse 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 MySQL auswählen.
  4. Geben Sie unter Instanz-ID quickstart-instance ein.
  5. Geben Sie ein Passwort für den Root-Nutzer ein. Speichern Sie dieses Passwort zur späteren Verwendung.
  6. Klicken Sie für Region und zonale Verfügbarkeit auswählen auf Einzelne Zone.
  7. Klicken Sie auf den Bereich Konfigurationsoptionen einblenden und maximieren Sie ihn.
  8. Wählen Sie im Drop-down-Menü Maschinentyp die Option Einfach aus.
  9. Klicken Sie auf Instanz erstellen und warten Sie, bis die Instanz initialisiert und gestartet wurde.

gcloud

Instanz mit öffentlicher IP-Adresse erstellen

Bevor Sie den Befehl gcloud sql instances create 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 Kerne, die in der Maschine festgelegt werden sollen.
  • --memory: Ganzzahliger Wert, der angibt, wie viel Arbeitsspeicher in der Maschine festgelegt werden soll. 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. Wenn nichts anderes angegeben ist, wird standardmäßig us-central 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 zu erstellen.

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

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 Datenbank erstellen quickstart_db als Namen der Datenbank und optional den Zeichensatz und die Sortierung 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.
    • Geben Sie auf der Seite Nutzerkonto zur Instanz instance_name hinzufügen die folgenden Informationen ein:
      • Nutzername: Legen Sie quickstart-user fest.
      • Passwort: Geben Sie ein Passwort für Ihren Datenbanknutzer an. Notieren Sie dies zur Verwendung in einem späteren Schritt dieser Kurzanleitung.
      • Die Standardeinstellung im Abschnitt Hostnamen lautet Beliebigen Host zulassen. Das bedeutet, dass der Nutzer von jeder IP-Adresse aus eine Verbindung herstellen kann.

        Optional können Sie Host anhand von IP-Adresse oder Adressbereich einschränken auswählen und im Abschnitt Host eine IP-Adresse oder einen Adressbereich eingeben. Der Nutzer kann dann nur von den angegebenen IP-Adressen aus eine Verbindung herstellen.

  5. Klicken Sie auf Hinzufügen.

gcloud

Dabei gilt:

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

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

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

Für Cloud SQL gelten dieselben Längenbeschränkungen für Nutzernamen wie für lokales MySQL; 32 Zeichen für MySQL 8.0 und höher, 16 Zeichen für frühere Versionen.

Dienstkonto einrichten

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 Weiter.
  9. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

Dienstkontoschlüsseldatei erstellen und herunterladen

  1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf:
  2. Zur Seite „Dienstkonten“

  3. Wählen Sie ein Projekt aus.
  4. Klicken Sie auf die E-Mail-Adresse des quickstart-service-account-Dienstkontos, für das Sie einen Schlüssel erstellen möchten.
  5. Klicken Sie auf den Tab Schlüssel.
  6. Klicken Sie auf das Drop-down-Menü Schlüssel hinzufügen und wählen Sie Neuen Schlüssel erstellen aus.
  7. Wählen Sie als Schlüsseltyp JSON aus und klicken Sie dann auf Erstellen.

Wenn Sie auf Erstellen klicken, wird eine Dienstkontoschlüsseldatei heruntergeladen. Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht noch einmal herunterladen.

Bewahren Sie die Schlüsseldatei sicher auf, da sie zur Authentifizierung als Ihr Dienstkonto verwendet werden kann. Sie können diese Datei beliebig verschieben und umbenennen.

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. Führen Sie den Befehl gcloud projects add-iam-policy-binding aus, um Ihrem Dienstkonto die Rolle "Cloud SQL-Client" für Ihr Projekt zuzuweisen. 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"

Dienstkontoschlüsseldatei erstellen und herunterladen

Wenn Sie das gerade erstellte Dienstkonto von Ihrem lokalen Computer verwenden möchten, benötigen Sie eine Dienstkontoschlüsseldatei, um die Beispielanwendung als Dienstkonto zu authentifizieren. Führen Sie den Befehl gcloud iam service-accounts keys create aus, um die Dienstkontoschlüsseldatei zu erstellen und herunterzuladen:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Ersetzen Sie die folgenden Werte:

  • KEY_FILE: Der Pfad zu einer neuen Ausgabedatei für den privaten Schlüssel, z. B. ~/sa-private-key.json.
  • PROJECT_ID: Ihre Google Cloud-Projekt-ID.

Die Dienstkontoschlüsseldatei wird jetzt auf Ihren lokalen Computer heruntergeladen. Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht noch einmal herunterladen.

Bewahren Sie die Schlüsseldatei sicher auf, da jeder sie zur Authentifizierung als Ihr Dienstkonto verwenden kann. Sie können diese Datei beliebig verschieben und umbenennen.

Entwicklungsumgebung für die Programmiersprache einrichten

Richten Sie die Entwicklungsumgebung Ihres lokalen Computers für Ihre bevorzugte Programmiersprache ein.

Go

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung für die Ausführung der Go-Beispielanwendung einzurichten.

  1. Rufen Sie den Einrichtungsleitfaden für eine Go-Entwicklungsumgebung auf.
  2. Folgen Sie der Anleitung im Abschnitt Go installieren.

Java

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Java-Beispielanwendung einzurichten.

  1. Rufen Sie den Einrichtungsleitfaden für eine Java-Entwicklungsumgebung auf.
  2. Folgen Sie der Anleitung im Abschnitt JDK (Java Development Kit) installieren.
  3. Folgen Sie der Anleitung im Abschnitt Build-Automatisierungstool installieren, um Apache Maven einzurichten.

Node.js

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Node.js-Beispielanwendung einzurichten.

  1. Rufen Sie den Einrichtungsleitfaden für eine Node.js-Entwicklungsumgebung auf.
  2. Folgen Sie der Anleitung im Abschnitt Node.js und npm installieren.

Python

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Python-Beispielanwendung einzurichten.

  1. Rufen Sie den Einrichtungsleitfaden für eine Python-Entwicklungsumgebung auf.
  2. Folgen Sie der Anleitung im Abschnitt Python installieren.

Git installieren

Installieren Sie Git, ein Open-Source-Versionsverwaltungssystem.

Beispielanwendung klonen

Klonen Sie eine Beispielanwendung mit dem Befehl git clone auf Ihrem lokalen Computer.

Go

Führen Sie die folgenden Befehle aus, um die Go-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie 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/mysql/database-sql

Java

Führen Sie die folgenden Befehle aus, um die Java-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie 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/mysql/servlet

Node.js

Führen Sie die folgenden Befehle aus, um die Node.js-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie 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/mysql/mysql

Python

Führen Sie die folgenden Befehle aus, um die Python-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie 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/mysql/sqlalchemy

Beispielanwendung konfigurieren und ausführen

Konfigurieren Sie die Beispielanwendung und führen Sie sie aus.

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.

Optionale Bereinigungsschritte

Wenn Sie nicht die Rolle Cloud SQL-Client verwenden, die Sie dem quickstart-service-account-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 (Bearbeiten) für das IAM-Konto mit dem Namen quickstart-service-account.
  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:
    • Cloud SQL Admin API
    • Identity and Access Management 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.

Informationen zum Anlegen von MySQL-Nutzern und -Datenbanken für Ihre Cloud SQL-Instanz erhalten Sie unter MySQL-Nutzer erstellen und verwalten und MySQL-Datenbanken erstellen und verwalten.

Weitere Informationen zu Preisen finden Sie unter Preise für Cloud SQL for MySQL.

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: