Von Compute Engine aus verbinden

Auf dieser Seite wird beschrieben, wie Sie das psql-Clienttool von Compute Engine aus mit einer AlloyDB-Instanz verbinden.

Die Verbindung von psql mit einer AlloyDB-Instanz umfasst die folgenden Aufgaben:

  1. Erstellen Sie eine Compute Engine-VM, die über den privaten Dienstzugriff eine Verbindung zu AlloyDB-Instanzen herstellen kann.
  2. Installieren Sie den psql-Client auf der Compute Engine-VM.
  3. Rufen Sie die IP-Adresse der AlloyDB-Instanz ab, mit der Sie eine Verbindung herstellen möchten.
  4. Führen Sie den psql-Client aus.

Die ersten beiden Aufgaben sind einmalige Vorgänge. Nachdem Sie eine Compute Engine-VM erstellt und den psql-Client darauf installiert haben, können Sie die VM weiterhin verwenden, um psql mit AlloyDB-Instanzen zu verbinden. Führen Sie dazu die verbleibenden Aufgaben aus.

Hinweis

  • Das Google Cloud Projekt von, das Sie verwenden, muss für den Zugriff auf AlloyDB aktiviert sein.
  • Ein VPC-Netzwerk im Google Cloud Projekt von, das Sie verwenden, muss bereits für den privaten Dienstzugriff auf AlloyDB konfiguriert sein.
  • Sie benötigen eine der folgenden IAM-Rollen im Google Cloud Projekt von, das Sie verwenden:
    • roles/alloydb.admin (die vordefinierte IAM-Rolle „AlloyDB Admin“)
    • roles/owner (einfache IAM-Rolle „Inhaber“)
    • roles/editor (einfache IAM-Rolle „Bearbeiter“)

    Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Organisationsadministrator, um Zugriff anzufordern.

  • Wenn der Clienthost eine Firewall hat, muss er ausgehende Verbindungen zu Port 5432 für die IP-Adressen Ihrer AlloyDB-Instanzen zulassen.

Compute Engine-VM erstellen

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zu „VM-Instanzen“

  2. Wählen Sie das Projekt aus, das die AlloyDB-Instanz enthält, mit der Sie eine Verbindung herstellen möchten.
  3. Klicken Sie auf Instanz erstellen.
  4. Klicken Sie auf den Abschnitt Maschinenkonfiguration.
  5. Geben Sie einen Namen für die Instanz ein.
  6. Konfigurieren Sie die Region und Zone, in der Sie die Instanz erstellen möchten.
  7. Wählen Sie eine Maschinenreihe und den entsprechenden Maschinentyp aus.
  8. Behalten Sie die Standardwerte im Abschnitt Betriebssystem und Speicher bei.
  9. Klicken Sie auf den Abschnitt Netzwerk und legen Sie für Netzwerkschnittstellen das VPC-Netzwerk fest, das für den privaten Dienstzugriff auf AlloyDB konfiguriert ist.
    Wenn Netzwerkschnittstellen nicht auf das VPC-Netzwerk festgelegt ist, das für den privaten Dienstzugriff konfiguriert ist, maximieren Sie es und legen Sie dann Netzwerk auf das VPC-Netzwerk fest.
  10. Behalten Sie die Standardwerte im Abschnitt Beobachtbarkeit bei.
  11. Klicken Sie auf den Abschnitt Sicherheit.
  12. Legen Sie unter Identität und API-Zugriff die Option Zugriffsbereiche auf Uneingeschränkten Zugriff auf alle Cloud APIs zulassen fest.
  13. Behalten Sie die Standardwerte im Abschnitt Erweitert bei.
  14. Klicken Sie auf Erstellen.

Nachdem die VM erstellt wurde, stellen Sie über SSH eine Verbindung zur erstellten Compute Engine-VM her.

psql-Clienttool installieren

Informationen zum Installieren des psql-Clienttools auf Ihrem Clienthost finden Sie unter psql-Clienttool installieren.

Wenn Sie eine Compute Engine-VM als Clienthost verwenden, führen Sie die folgenden Schritte aus, um eine Verbindung zu Ihrer VM herzustellen und psql zu installieren:

  1. Stellen Sie über SSH eine Verbindung zur erstellten Compute Engine-VM her.

    Console

    1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

      Zur Seite „VM-Instanzen“

    2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der gerade erstellten Instanz auf SSH.

    gcloud

    Verwenden Sie den Befehl gcloud compute ssh, um eine Verbindung zur erstellten Instanz herzustellen.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, das die Instanz enthält
    • ZONE: der Name der Zone, in der sich die Instanz befindet
    • VM_NAME: der Name der Instanz

  2. Installieren Sie den psql-Client aus dem Paketmanager: 

    sudo apt-get update
sudo apt-get install postgresql-client

IP-Adresse der AlloyDB-Instanz abrufen

Die IP-Adresse der AlloyDB-Instanz, mit der Sie eine Verbindung herstellen möchten , finden Sie in den Einstellungen der Instanz.

psql-Client ausführen

  1. Stellen Sie über SSH eine Verbindung zur erstellten VM her.

    Console

    1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

      Zur Seite „VM-Instanzen“

    2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der gerade erstellten Instanz auf SSH.

    gcloud

    Verwenden Sie den Befehl gcloud compute ssh, um eine Verbindung zur erstellten Instanz herzustellen.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, das die Instanz enthält.
    • ZONE: der Name der Zone, in der sich die Instanz befindet.
    • VM_NAME: der Name der Instanz.
  2. Führen Sie das psql-Clienttool aus: 
    psql -h IP_ADDRESS -U USERNAME -d postgres

    Sie werden aufgefordert, das Passwort des USERNAME Nutzers einzugeben.

    Wenn Sie zum ersten Mal eine Verbindung herstellen, geben Sie postgres für USERNAME und die Datenbank an. Ihr Befehl sieht so aus:

    psql -h IP_ADDRESS -U postgres -d postgres

    Verwenden Sie das Passwort, das Sie beim Erstellen des Clusters festgelegt haben.

Nächste Schritte