Menghubungkan klien psql ke instance

Halaman ini menjelaskan cara menghubungkan alat klien psql ke instance AlloyDB.

Prosedur untuk menghubungkan psql ke instance AlloyDB melibatkan tugas-tugas berikut:

1. Buat VM Compute Engine yang dapat terhubung ke instance AlloyDB menggunakan akses layanan pribadi.
2. Instal klien psql di VM Compute Engine.
3. Dapatkan alamat IP instance AlloyDB yang ingin Anda hubungkan.
4. Jalankan klien psql.

Dua tugas pertama ini adalah operasi satu kali. Setelah membuat VM Compute Engine dan menginstal klien psql di dalamnya, Anda dapat terus menggunakan VM untuk menghubungkan psql ke instance AlloyDB dengan melakukan tugas yang tersisa.

Sebelum memulai

• Project Google Cloud yang Anda gunakan harus telah diaktifkan untuk mengakses AlloyDB.
• Jaringan VPC di project Google Cloud yang Anda gunakan harus sudah dikonfigurasi untuk akses layanan pribadi ke AlloyDB.
• Anda harus memiliki salah satu peran IAM berikut di project Google Cloud yang Anda gunakan:
  • roles/alloydb.admin (peran IAM bawaan AlloyDB Admin)
  • roles/owner (peran IAM dasar Pemilik)
  • roles/editor (peran IAM dasar Editor)

  Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi untuk meminta akses.

• Jika host klien memiliki firewall, firewall tersebut harus mengizinkan koneksi keluar ke port 5432 pada alamat IP instance AlloyDB Anda.

Membuat VM Compute Engine

1. Di Konsol Google Cloud, buka halaman Instance VM.

   Buka instance VM

2. Pilih project yang berisi instance AlloyDB yang ingin Anda hubungkan.
3. Klik Create instance.
4. Klik bagian Machine configuration.
5. Masukkan Nama untuk instance.
6. Konfigurasikan region dan zona tempat Anda ingin membuat instance.
7. Pilih seri mesin dan jenis mesin yang sesuai.
8. Pertahankan nilai default di bagian OS and Storage.
9. Klik bagian Networking, lalu tetapkan Network interfaces ke jaringan VPC yang dikonfigurasi untuk akses layanan pribadi ke AlloyDB.
   Jika Network interfaces tidak ditetapkan ke jaringan VPC yang dikonfigurasi untuk akses layanan pribadi, luaskan, lalu tetapkan Network ke jaringan VPC.
10. Pertahankan nilai default di bagian Observabilitas.
11. Klik bagian Keamanan.
12. Di bagian Identity and API access, tetapkan Access scopes ke Allow full access to all Cloud APIs.
13. Mempertahankan nilai default di bagian Advanced.
14. Klik Buat.

Setelah VM dibuat, hubungkan ke VM Compute Engine yang Anda buat menggunakan SSH.

Menginstal alat klien psql

1. Hubungkan ke VM Compute Engine yang Anda buat menggunakan SSH.
   Secara default, koneksi SSH ke VM Compute Engine menggunakan Identity-Aware Proxy. Bergantung pada kebijakan jaringan organisasi, Anda mungkin perlu membuat aturan firewall masuk untuk mengizinkan traffic ke VM.

   Konsol

   1. Di konsol Google Cloud, buka halaman Instance VM.

      Buka instance VM

   2. Di daftar instance virtual machine, klik SSH di baris instance yang Anda buat.

   gcloud

   Gunakan perintah gcloud compute ssh untuk terhubung ke instance yang Anda buat.

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

   Ganti kode berikut:

   • PROJECT_ID: ID project yang berisi instance
   • ZONE: nama zona tempat instance berada
   • VM_NAME: nama instance
2. Instal klien psql dari pengelola paket:

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

Mendapatkan alamat IP instance AlloyDB

Untuk mendapatkan alamat IP instance AlloyDB yang ingin Anda hubungkan, lihat setelan instance tersebut.

Menjalankan klien psql

1. Hubungkan ke VM yang Anda buat menggunakan SSH.

   Konsol

   1. Di konsol Google Cloud, buka halaman instance VM.

      Buka instance VM

   2. Di daftar instance virtual machine, klik SSH di baris instance yang Anda buat.

   gcloud

   Gunakan perintah gcloud compute ssh untuk terhubung ke instance yang Anda buat.

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

   Ganti kode berikut:

   • PROJECT_ID: ID project yang berisi instance
   • ZONE: nama zona tempat instance berada
   • VM_NAME: nama instance
2. Jalankan alat klien psql:

   psql -h IP_ADDRESS -U USERNAME

   Anda akan diminta untuk memasukkan sandi pengguna USERNAME.

   Jika Anda terhubung untuk pertama kalinya, gunakan nilai default postgres untuk USERNAME dan sandi yang Anda gunakan saat membuat cluster untuk PASSWORD.