Über den Laptop verbinden

Wenn Sie AlloyDB for PostgreSQL kennenlernen oder in einer lokalen Entwicklungsumgebung arbeiten möchten, können Sie über den AlloyDB Auth-Proxy und eine öffentliche IP-Adresse eine sichere Verbindung von Ihrem Laptop oder Ihrer lokalen Workstation zu einer AlloyDB-Instanz herstellen.

Hinweis

Bevor Sie eine Verbindung von Ihrem Laptop herstellen, müssen die folgenden Voraussetzungen erfüllt sein:

Erforderliche Rollen

Wenn Sie eine Verbindung von Ihrem Laptop herstellen möchten, weisen Sie Ihrem IAM-Hauptkonto (Identity and Access Management) (Nutzerkonto oder Dienstkonto) die folgenden vordefinierten Rollen zu:

  • AlloyDB-Client (roles/alloydb.client)
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

Öffentliche IP-Adresse für Ihre AlloyDB-Instanz aktivieren

Am einfachsten können Sie eine Verbindung von Ihrem Laptop herstellen, indem Sie die öffentliche IP-Adresse auf Ihrer AlloyDB-Instanz aktivieren. Sie können die öffentliche IP-Adresse aktivieren, wenn Sie eine Instanz erstellen oder eine vorhandene Instanz aktualisieren, um sie zu aktivieren.

Console

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

    Zu den Clustern

  2. Klicken Sie auf einen Cluster in der Spalte Ressourcenname, um die Clusterdetails aufzurufen.

  3. Suchen Sie unter Instanzen in Ihrem Cluster die Instanz, zu der Sie eine Verbindung herstellen möchten.

  4. Klicken Sie auf Instanzaktionen und dann auf Bearbeiten.

  5. Wählen Sie unter Konnektivität die Option Öffentliche IP-Adresse aktivieren aus.

  6. Klicken Sie auf Instanz aktualisieren, um die Änderungen zu speichern.

gcloud

Verwenden Sie den Befehl gcloud alloydb instances update, um die öffentliche IP-Adresse auf Ihrer Instanz zu aktivieren:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID der AlloyDB-Instanz.
  • CLUSTER_ID: die ID des Clusters.
  • REGION_ID: die Region, in der sich der Cluster befindet.

URI der Instanzverbindung abrufen

Wenn Sie den Auth-Proxy-Client starten, müssen Sie Ihre Instanz mit ihrem eindeutigen Verbindungs-URI identifizieren. Rufen Sie den Verbindungs-URI mit dem gcloud CLI-Befehl alloydb instances describe auf Ihrem Laptop-Terminal ab.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

Der Befehl gibt den Verbindungs-URI zurück, der in etwa so formatiert ist:

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

AlloyDB Auth-Proxy mit öffentlicher IP-Adresse starten

Nachdem Sie den Instanzverbindungs-URI haben, starten Sie den Auth-Proxy-Client über das Terminal Ihres Laptops. Verwenden Sie das Flag --public-ip, um den AlloyDB Auth-Proxy anzuweisen, eine Verbindung über den öffentlichen IP-Netzwerkpfad herzustellen.

./alloydb-auth-proxy CONNECTION_URI --public-ip

Ersetzen Sie CONNECTION_URI durch den URI der Instanzverbindung, den Sie unter URI der Instanzverbindung abrufen erhalten haben.

Wenn der AlloyDB Auth-Proxy erfolgreich gestartet wurde, wird im Terminal angezeigt, dass der AlloyDB Auth-Proxy auf Port 5432 auf lokale TCP-Verbindungen wartet:

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

Verbindung zur Datenbank mit psql herstellen

Öffnen Sie während der Ausführung des AlloyDB Auth-Proxys ein separates Terminalfenster auf Ihrem Laptop, um eine Verbindung zur Datenbank herzustellen.

Führen Sie das Clienttool psql aus und geben Sie die lokale Listener-Adresse 127.0.0.1 und den Port 5432 an:

psql -h 127.0.0.1 -U postgres -d postgres

Geben Sie bei Aufforderung das Passwort des Datenbanknutzers postgres ein.

Der Befehl psql stellt eine Verbindung zum Auth-Proxy-Client her, der Ihre Verbindung über einen sicheren Tunnel an Ihre AlloyDB-Instanz weiterleitet. Der Befehl psql zeigt eine Eingabeaufforderung an, die bestätigt, dass Ihr Laptop sicher mit der AlloyDB-Instanz verbunden ist:

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

Nächste Schritte