Über den Laptop verbinden

Auf dieser Seite wird beschrieben, wie Sie über eine öffentliche IP-Adresse eine sichere Verbindung von Ihrem Laptop oder lokalen Computer zu einer AlloyDB for PostgreSQL-Instanz mit dem AlloyDB Auth-Proxy herstellen.

Eine Verbindung von Ihrem Laptop aus ist nützlich, wenn Sie AlloyDB erkunden oder eine Entwicklungsumgebung einrichten möchten.

Hinweis

Bevor Sie eine Verbindung von Ihrem Laptop aus herstellen, müssen Sie Folgendes tun:

Erforderliche Rollen

Wenn Sie eine Verbindung von Ihrem Laptop aus herstellen möchten, muss Ihr IAM-Hauptkonto (Identity and Access Management) (Nutzerkonto oder Dienstkonto) die erforderlichen vordefinierten Rollen haben:

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

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

Die einfachste Möglichkeit, eine Verbindung von Ihrem Laptop aus herzustellen, besteht darin, die öffentliche IP-Adresse für Ihre AlloyDB-Instanz zu aktivieren. Sie können die öffentliche IP-Adresse aktivieren, wenn Sie eine Instanz erstellen oder eine vorhandene Instanz aktualisieren.

Console

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

    Zu den Clustern

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

  3. Suchen Sie unter Instanzen im 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 Verbindung die Option Öffentliche IP-Adresse aktivieren aus.

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

gcloud

Verwenden Sie den gcloud alloydb instances update Befehl, um die öffentliche IP-Adresse für Ihre 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 alloydb instances describe Befehl im Terminal Ihres Laptops 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 URI der Instanzverbindung abgerufen 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 lokale TCP-Verbindungen auf Port 5432 wartet:

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

Mit psql eine Verbindung zur Datenbank herstellen

Während der AlloyDB Auth-Proxy ausgeführt wird, öffnen Sie ein separates Terminalfenster auf Ihrem Laptop, um eine Verbindung zur Datenbank herzustellen.

Führen Sie das psql-Clienttool aus und richten Sie es auf die lokale Listener-Adresse 127.0.0.1 und den Port 5432 aus:

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 zu Ihrer 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