Mit der gcloud CLI verbinden

Mit dem Befehl gcloud beta alloydb connect können Sie eine autorisierte, verschlüsselte Verbindung zu einer AlloyDB for PostgreSQL-Instanz herstellen. Damit wird das Starten des AlloyDB Auth-Proxys und das Ausführen des Clienttools psql automatisiert.

Verwenden Sie diesen Befehl für die manuelle Datenbankverwaltung und -entwicklung in Umgebungen wie Ihrem lokalen Computer oder Cloud Shell.

Weitere Informationen finden Sie unter Verbindungsübersicht.

Hinweis

  1. Installieren Sie die Google Cloud CLI.
  2. Installieren Sie das psql-Clienttool.
  3. Ihr IAM-Hauptkonto (Identity and Access Management) muss die Rolle „AlloyDB-Client“ (roles/alloydb.client) haben. Weitere Informationen finden Sie unter IAM-Authentifizierung verwalten.

Verbindung zu einer Instanz herstellen

Führen Sie folgenden Befehl aus, um über eine private IP-Adresse eine Verbindung zu einer Instanz mit dem Standardnutzer und der Standarddatenbank postgres herzustellen:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID

Verbindung über öffentliche IP-Adresse herstellen

Wenn für Ihre Instanz eine öffentliche IP-Adresse aktiviert ist, können Sie eine Verbindung zu ihr herstellen, indem Sie das Flag --public-ip hinzufügen:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip

Mit IAM authentifizieren

Der Befehl gcloud beta alloydb connect unterstützt die automatische IAM-Authentifizierung. Verwenden Sie das Flag --auto-iam-authn, um sich als angemeldeter gcloud CLI-Nutzer oder als Dienstkonto zu authentifizieren.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --auto-iam-authn

Weitere Informationen zur IAM-Authentifizierung finden Sie unter IAM-Datenbankauthentifizierung.

Verbindung über Private Service Connect herstellen

Wenn Sie Private Service Connect verwenden, fügen Sie das Flag --psc hinzu:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --psc

Verbindung zu einem bestimmten Nutzer und einer bestimmten Datenbank herstellen

Wenn Sie sich als bestimmter Datenbanknutzer mit einer bestimmten Datenbank verbinden möchten, verwenden Sie die Flags --user und --database:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --user=USER_NAME \
    --database=DATABASE_NAME

Identitätsübernahme des Dienstkontos

Sie können ein Dienstkonto mit Identitätsübernahme verwenden, um die Verbindung zu autorisieren. Wenn Sie die Identität eines Dienstkontos verwenden, verwendet der Auth-Proxy die Anmeldedaten des angegebenen Dienstkontos, um Verbindungsinformationen abzurufen.

Wenn Sie eine Verbindung über ein Dienstkonto mit Identitätsübernahme herstellen möchten, fügen Sie das Flag --impersonate-service-account hinzu:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL

Der Auth-Proxy verwendet das imitierte Dienstkonto, um Verbindungsinformationen abzurufen. Die Authentifizierung bei der Datenbank erfolgt jedoch nicht automatisch. Wenn Sie sich auch als das Dienstkonto mit Identitätsübernahme bei der Datenbank authentifizieren möchten, fügen Sie das Flag --auto-iam-authn hinzu. Das übernommene Dienstkonto muss ein Nutzer in Ihrer Datenbank sein.

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
    --auto-iam-authn

Nächste Schritte