Öffentliche IP-Adresse konfigurieren

Auf dieser Seite wird gezeigt, wie Sie eine öffentliche IP-Verbindung für eine Cloud SQL-Instanz konfigurieren.

Einleitung

Sie können Ihre Cloud SQL-Instanz für eine öffentliche IPv4-Adresse konfigurieren und autorisierte Adressen für Verbindungen von bestimmten IP-Adressen oder von einem Adressbereich hinzufügen.

Sie können kein privates Netzwerk (beispielsweise 10.x.x.x) als autorisiertes Netzwerk angeben.

Öffentliche IP-Adressen für PostgreSQL-Instanzen:

  • IPv6: Instanzen unterstützen IPv6 nicht.
  • IPv4: Instanzen wird automatisch eine statische IPv4-Adresse zugewiesen. Wenn die Instanz deaktiviert ist, fällt jeweils eine geringe Gebühr für die IP-Adresse an.

Hilfe bei der Verbindung eines Verwaltungsclients mit der Instanz über eine IP-Verbindung finden Sie in psql-Client über IP-Adressen verbinden.

Wenn Sie die Instanz so konfigurieren, dass Verbindungen über eine öffentliche IP-Adresse angenommen werden, sollten Sie auch die Verwendung von SSL festlegen, um Ihre Daten zu schützen. Weitere Informationen finden Sie unter SSL für Instanzen konfigurieren.

Informationen zur Konfiguration der Instanz mit einer IP-Adresse, die nicht über das öffentliche Internet zugänglich ist, finden Sie unter Private IP-Adresse konfigurieren.

Öffentliche IP-Adresse aktivieren und autorisierte Adressen oder einen autorisierten Adressbereich hinzufügen

Wenn Sie die öffentliche IP-Adresse für Ihre Instanz aktivieren, konfiguriert Cloud SQL die Instanz mit einer öffentlichen statischen IPv4-Adresse. Nachdem Sie öffentliche IP-Adressen aktiviert haben, müssen Sie eine Autorisierung für Datenbankverbindungen einrichten. Weitere Informationen finden Sie unter Autorisierungsoptionen.

So aktivieren Sie eine öffentliche IP-Adresse und fügen eine autorisierte Adresse hinzu:

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 Verbindungen aus.
  4. Klicken Sie auf den Tab Netzwerk.
  5. Wählen Sie das Kästchen Öffentliche IP-Adressen aus.
  6. Klicken Sie auf Netzwerk hinzufügen.
  7. Geben Sie optional einen Namen für dieses Netzwerk in das Feld Name ein.
  8. Geben Sie im Feld Netzwerk die IP-Adresse oder den Adressbereich ein, von dem aus Sie Verbindungen zulassen möchten.

    Verwenden Sie die CIDR-Notation.

  9. Klicken Sie auf Fertig.
  10. Klicken Sie auf Speichern.

gcloud

  1. Falls noch nicht geschehen, weisen Sie der Instanz eine IPv4-Adresse zu:
    gcloud sql instances patch INSTANCE_NAME\
    --assign-ip
  2. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:
    gcloud sql instances describe INSTANCE_NAME

    Suchen Sie unter ipConfiguration nach authorizedNetwork-Einträgen und notieren Sie alle autorisierten Adressen, die Sie behalten möchten.

  3. Aktualisieren Sie die Liste der autorisierten Netzwerke einschließlich aller Adressen, die darin enthalten sein sollen.
    gcloud sql instances patch INSTANCE_NAME \
    --authorized-networks=IP_ADDR1,IP_ADDR2...

    Verwenden Sie die CIDR-Notation.

  4. Bestätigen Sie Ihre Änderungen:
    gcloud sql instances describe INSTANCE_NAME

REST Version 1

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz einschließlich aller Adressen, die Sie für die Instanz festlegen möchten:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • network_range_1: eine autorisierte IP-Adresse oder ein autorisierter IP-Bereich
    • network_range_2: eine weitere autorisierte IP-Adresse oder ein weiterer autorisierter IP-Bereich

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks":
            [{"value": "network_range_1"}, {"value": "network_range_2"}]
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

    Verwenden Sie die CIDR-Notation.

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Terraform

Verwenden Sie eine Terraform-Ressource, um eine öffentliche IP-Adresse zu aktivieren und eine autorisierte Adresse oder einen autorisierten Adressbereich hinzuzufügen.

resource "google_sql_database_instance" "postgres_public_ip_instance_name" {
  database_version = "POSTGRES_14"
  name             = "postgres-public-ip-instance-name"
  region           = "asia-southeast2"
  settings {
    availability_type = "ZONAL"
    ip_configuration {
      # Add optional authorized networks
      # Update to match the customer's networks
      authorized_networks {
        name  = "test-net-3"
        value = "203.0.113.0/24"
      }
      # Enable public IP
      ipv4_enabled = true
    }
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Änderungen anwenden

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Google Cloud-Projekt anzuwenden.

Cloud Shell vorbereiten

  1. Rufen Sie Cloud Shell auf.
  2. Legen Sie das Google Cloud-Standardprojekt fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

    Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

  1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

    Kopieren Sie den Beispielcode in das neu erstellte main.tf.

    Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

  3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
  4. Speichern Sie die Änderungen.
  5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.
    terraform init

    Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

    terraform init -upgrade

Änderungen anwenden

  1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:
    terraform plan

    Korrigieren Sie die Konfiguration nach Bedarf.

  2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
    terraform apply

    Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

  3. Öffnen Sie Ihr Google Cloud-Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Änderungen löschen

So löschen Sie das Projekt:

  1. Um den Löschschutz zu deaktivieren, setzen Sie in der Terraform-Konfigurationsdatei das Argument deletion_protection auf false.
    deletion_protection =  "false"
  2. Wenden Sie die aktualisierte Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
    terraform apply
  1. Entfernen Sie Ressourcen, die zuvor mit Ihrer Terraform-Konfiguration angewendet wurden, indem Sie den folgenden Befehl ausführen und yes an der Eingabeaufforderung eingeben:

    terraform destroy

REST v1beta4

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz einschließlich aller Adressen, die Sie für die Instanz festlegen möchten:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • network_range_1: eine autorisierte IP-Adresse oder ein autorisierter IP-Bereich
    • network_range_2: eine weitere autorisierte IP-Adresse oder ein weiterer autorisierter IP-Bereich

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks":
            [{"value": "network_range_1"}, {"value": "network_range_2"}]
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

    Verwenden Sie die CIDR-Notation.

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Autorisierte Adresse oder autorisierten Adressbereich entfernen

So entfernen Sie eine autorisierte Adresse:

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 Verbindung aus.
  4. Klicken Sie für die Adresse, die Sie löschen möchten, auf das Papierkorbsymbol Löschen.
  5. Klicken Sie auf Speichern, um die Instanz zu aktualisieren.

gcloud

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:
    gcloud sql instances describe INSTANCE_NAME

    Suchen Sie unter ipConfiguration nach authorizedNetwork-Einträgen und notieren Sie alle autorisierten Adressen, die Sie behalten möchten.

  2. Aktualisieren Sie die Liste der autorisierten Netzwerke, indem Sie alle Adressen trennen, die Sie entfernen möchten.
    gcloud sql instances patch INSTANCE_NAME \
    --authorized-networks=IP_ADDR1,IP_ADDR2...
  3. Bestätigen Sie Ihre Änderungen:
    gcloud sql instances describe INSTANCE_NAME

REST Version 1

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz und geben Sie dabei alle Adressen an, die Sie behalten möchten, bzw. löschen Sie alle Adressen, die Sie entfernen möchten:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • network_range_1: die zu entfernende autorisierte IP-Adresse oder der zu entfernende autorisierte Netzwerkbereich

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks":
            [{"value": "network_range_1"}]
        }
      }
    }
    
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address: die IP-Adresse in CIDR-Notation
    • ip-address-name: der Name der IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

REST v1beta4

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz und geben Sie dabei alle Adressen an, die Sie behalten möchten, bzw. löschen Sie alle Adressen, die Sie entfernen möchten:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • network_range_1: die zu entfernende autorisierte IP-Adresse oder der zu entfernende autorisierte Netzwerkbereich

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks":
            [{"value": "network_range_1"}]
        }
      }
    }
    
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address: die IP-Adresse in CIDR-Notation
    • ip-address-name: der Name der IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Instanz so konfigurieren, dass alle öffentlichen IP-Verbindungen abgelehnt werden

Sie können Instanzen so konfigurieren, dass alle öffentlichen IP-Verbindungen abgelehnt werden:

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 Verbindung aus.
  4. Klicken Sie für alle autorisierten Adressen auf den Papierkorb Löschen.
  5. Klicken Sie auf Speichern, um die Instanz zu aktualisieren.

gcloud

  1. Löschen Sie die Liste autorisierter Adressen:
    gcloud sql instances patch INSTANCE_NAME \
    --clear-authorized-networks
  2. Bestätigen Sie Ihre Änderungen:
    gcloud sql instances describe INSTANCE_NAME

REST Version 1

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz mit einer leeren Adressliste:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks": []
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

REST v1beta4

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz mit einer leeren Adressliste:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID

    HTTP-Methode und URL:

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

    JSON-Text anfordern:

    {
      "settings":
      {
        "ipConfiguration":
        {
          "authorizedNetworks": []
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Öffentliche IP-Adressen deaktivieren

Sie können öffentliche IP-Adressen deaktivieren, aber nur, wenn Ihre Instanz auch für die Verwendung privater IP-Adressen konfiguriert ist. Informationen zum Aktivieren einer privaten IP finden Sie unter Bestehende Instanz für die Verwendung einer privaten IP-Adresse konfigurieren.

So deaktivieren Sie öffentliche IP-Adressen:

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 Verbindung aus.
  4. Entfernen Sie das Häkchen bei Öffentliche IP-Adresse.
  5. Klicken Sie auf Speichern, um die Instanz zu aktualisieren.

gcloud

  1. Aktualisieren Sie die Instanz:
    gcloud sql instances patch INSTANCE_NAME \
    --no-assign-ip
  2. Bestätigen Sie Ihre Änderungen:
    gcloud sql instances describe INSTANCE_NAME

REST Version 1

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • PROJECT_ID:: die Projekt-ID
    • INSTANCE_ID:: die Instanz-ID
    • VPC_NETWORK_NAME:: Geben Sie den Namen des VPC-Netzwerks (Virtual Private Cloud) an, das Sie für diese Instanz verwenden möchten. Der Zugriff auf private Dienste muss bereits für das Netzwerk konfiguriert sein.
    • RANGE_NAME: Optional. Legt, wenn angegeben, den Namen eines Bereichs fest, dem ein IP-Bereich zugewiesen wird. Der Bereichsname muss RFC-1035 entsprechen und 1 bis 63 Zeichen enthalten.
    • AUTHORIZED_NETWORKS:: Geben Sie für öffentliche IP-Verbindungen die Verbindungen aus autorisierten Netzwerken an, die eine Verbindung zu Ihrer Instanz herstellen können.

    Legen Sie für den Parameter ipv4Enabled den Wert true fest, wenn Sie eine öffentliche IP-Adresse für die Instanz verwenden, oder den Wert false, wenn die Instanz eine private IP-Adresse hat.

    Wenn Sie für den Parameter enablePrivatePathForGoogleCloudServices den Wert true festlegen, erlauben Sie anderen Google Cloud-Diensten wie BigQuery den Zugriff auf Daten in Cloud SQL und das Abfragen dieser Daten über eine private IP-Verbindung. Wenn Sie für diesen Parameter den Wert false angeben, können andere Google Cloud-Dienste nicht über eine private IP-Verbindung auf Daten in Cloud SQL zugreifen.

    HTTP-Methode und URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

    JSON-Text anfordern:

    {
      "name": "INSTANCE_ID",
      "region": "region",
      "databaseVersion": "database-version",
      "settings": {
        "tier": "machine-type",
        "ipConfiguration": {
          "ipv4Enabled": false,
          "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
          "allocatedIpRange": "RANGE_NAME"
          "authorizedNetworks": [AUTHORIZED_NETWORKS],
    
          "enablePrivatePathForGoogleCloudServices": true
    
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

REST v1beta4

  1. Indem Sie die Instanz beschreiben, zeigen Sie alle vorhandenen autorisierten Adressen an:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • ip-address1: die erste IP-Adresse in CIDR-Notation
    • ip-address-name1: der Name der ersten IP-Adresse
    • ip-address2: die zweite IP-Adresse in CIDR-Notation
    • ip-address-name2: der Name der zweiten IP-Adresse
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

  2. Aktualisieren Sie die Instanz:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • PROJECT_ID:: die Projekt-ID
    • INSTANCE_ID:: die Instanz-ID
    • VPC_NETWORK_NAME:: Geben Sie den Namen des VPC-Netzwerks (Virtual Private Cloud) an, das Sie für diese Instanz verwenden möchten. Der Zugriff auf private Dienste muss bereits für das Netzwerk konfiguriert sein.
    • RANGE_NAME: Optional. Legt, wenn angegeben, den Namen eines Bereichs fest, dem ein IP-Bereich zugewiesen wird. Der Bereichsname muss RFC-1035 entsprechen und 1 bis 63 Zeichen enthalten.
    • AUTHORIZED_NETWORKS:: Geben Sie für öffentliche IP-Verbindungen die Verbindungen aus autorisierten Netzwerken an, die eine Verbindung zu Ihrer Instanz herstellen können.

    Legen Sie für den Parameter ipv4Enabled den Wert true fest, wenn Sie eine öffentliche IP-Adresse für die Instanz verwenden, oder den Wert false, wenn die Instanz eine private IP-Adresse hat.

    Wenn Sie für den Parameter enablePrivatePathForGoogleCloudServices den Wert true festlegen, erlauben Sie anderen Google Cloud-Diensten wie BigQuery den Zugriff auf Daten in Cloud SQL und das Abfragen dieser Daten über eine private IP-Verbindung. Wenn Sie für diesen Parameter den Wert false angeben, können andere Google Cloud-Dienste nicht über eine private IP-Verbindung auf Daten in Cloud SQL zugreifen.

    HTTP-Methode und URL:

    POST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

    JSON-Text anfordern:

    {
      "name": "INSTANCE_ID",
      "region": "region",
      "databaseVersion": "database-version",
      "settings": {
        "tier": "machine-type",
        "ipConfiguration": {
          "ipv4Enabled": false,
          "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
          "allocatedIpRange": "RANGE_NAME"
          "authorizedNetworks": [AUTHORIZED_NETWORKS],
    
          "enablePrivatePathForGoogleCloudServices": true
    
        }
      }
    }
    

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten in etwa folgende JSON-Antwort erhalten:

  3. Bestätigen Sie Ihre Änderungen:

    Ersetzen Sie dabei folgende Werte für die Anfragedaten:

    • project-id: die Projekt-ID
    • instance-id: die Instanz-ID
    • machine-type: der Instanzmaschinentyp
    • zone: die Instanzzone

    HTTP-Methode und URL:

    GET  https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=settings

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Fehlerbehebung

Problem Fehlerbehebung
Aborted connection. Mögliche Ursache:
  • Netzwerk instabil.
  • Keine Antwort auf TCP-Keep-Alive-Befehle (entweder der Client oder der Server reagiert nicht, möglicherweise überlastet).
  • Die Verbindungsdauer des Datenbankmoduls wurde überschritten und der Server hat die Verbindung beendet.

Anwendungen sollten Netzwerkfehler tolerieren und gemäß den Best Practices mit Verbindungs-Pooling und Wiederholungsversuchen arbeiten. Die meisten Verbindungs-Pooler erfassen diese Fehler nach Möglichkeit. Andernfalls muss die Anwendung einen Wiederholungsversuch ausführen oder ordnungsgemäß fehlschlagen.

Für einen erneuten Verbindungsversuch empfehlen wir die folgenden Methoden:

  1. Exponentielle Backoffs. Erhöhen Sie das Zeitintervall zwischen den einzelnen Wiederholungen exponentiell.
  2. Fügen Sie auch einen zufälligen Backoff hinzu.

Durch die Kombination dieser Methoden wird die Drosselung reduziert.

Certificate verify failed

Die Clientzertifikate sind abgelaufen oder der Pfad zu den Zertifikaten ist nicht korrekt.

Generieren Sie die Zertifikate neu, indem Sie sie neu erstellen.

FATAL: database 'user' does not exist gcloud sql connect --user funktioniert nur mit dem standardmäßigen postgres-Nutzer.

Stellen Sie eine Verbindung mit dem Standardnutzer her und wechseln Sie die Nutzer.

Sie möchten wissen, wer verbunden ist. Melden Sie sich in der Datenbank an und führen Sie den folgenden Befehl aus:

SELECT datname,
usename,
application_name as appname,
client_addr,
state,
now() - backend_start as conn_age,
now() - state_change as last_activity_age
FROM pg_stat_activity
WHERE backend_type = 'client backend'
ORDER BY 6 DESC
LIMIT 20
   

Hostname/IP does not match certificate's altnames: Host: localhost. is not in the cert's altnames.

Die Hostadresse stimmt nicht mit der Adresse in den alternativen Namen des Serverzertifikats überein.

Wenn Sie Node.js mit verify-full oder einem Äquivalent nutzen, verwenden Sie bitte den DNS-Namen für den Parameter servername. Den DNS-Namen finden Sie im Serverzertifikat mit openssl. Beispiel: openssl x509 -in server-cert.pem -noout -text |grep 'DNS:'.

 ssl: {
  rejectUnauthorized: true,
  ca: fs.readFileSync("/path/to/server/CA"),
  servername: 'N-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx.us-central1.sql.goog'
}

Nächste Schritte