Menghubungkan menggunakan gcloud CLI

Perintah gcloud beta alloydb connect memungkinkan Anda membuat koneksi terenkripsi dan diizinkan ke instance AlloyDB untuk PostgreSQL. Alat ini mengotomatiskan memulai Proxy Auth AlloyDB dan menjalankan alat klien psql.

Gunakan perintah ini untuk administrasi dan pengembangan database manual dari lingkungan seperti mesin lokal atau Cloud Shell.

Untuk mempelajari lebih lanjut, lihat Ringkasan koneksi.

Sebelum memulai

  1. Menginstal Google Cloud CLI.
  2. Instal alat klien psql.
  3. Pastikan akun utama Identity and Access Management (IAM) Anda memiliki peran Klien AlloyDB (roles/alloydb.client). Untuk mengetahui informasi selengkapnya, lihat Mengelola autentikasi IAM.

Menghubungkan ke instance

Untuk terhubung ke instance menggunakan pengguna dan database postgres default melalui IP pribadi, jalankan:

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

Menghubungkan melalui IP publik

Jika instance Anda mengaktifkan alamat IP publik, Anda dapat terhubung ke instance tersebut dengan menambahkan flag --public-ip:

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

Melakukan autentikasi menggunakan IAM

Perintah gcloud beta alloydb connect mendukung autentikasi IAM otomatis. Gunakan flag --auto-iam-authn untuk melakukan autentikasi sebagai pengguna gcloud CLI yang login atau akun layanan.

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

Untuk mengetahui informasi selengkapnya tentang autentikasi IAM, lihat Autentikasi database IAM.

Terhubung melalui Private Service Connect

Jika Anda menggunakan Private Service Connect, tambahkan flag --psc:

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

Menghubungkan dengan pengguna dan database tertentu

Untuk terhubung sebagai pengguna database tertentu ke database tertentu, gunakan flag --user dan --database:

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

Peniruan akun layanan

Anda dapat menggunakan akun layanan yang ditiru untuk mengizinkan koneksi. Saat Anda menggunakan peniruan identitas, Proxy Auth menggunakan kredensial akun layanan yang ditentukan untuk mengambil informasi koneksi.

Untuk terhubung menggunakan akun layanan yang ditiru, tambahkan flag --impersonate-service-account:

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

Proxy Auth menggunakan akun layanan yang ditiru untuk mengambil informasi koneksi. Namun, proxy ini tidak melakukan autentikasi otomatis ke database. Untuk juga melakukan autentikasi ke database sebagai akun layanan yang ditiru identitasnya, tambahkan flag --auto-iam-authn. Akun layanan yang ditiru identitasnya harus merupakan pengguna di database Anda.

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

Langkah berikutnya