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 VM tersebut, 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 sudah diaktifkan untuk mengakses AlloyDB.
• Jaringan VPC di Google Cloud project yang Anda gunakan harus sudah dikonfigurasi untuk akses layanan pribadi ke AlloyDB.
• Anda harus memiliki salah satu peran IAM ini di Google Cloud project yang Anda gunakan:
  • roles/alloydb.admin (peran IAM bawaan Admin AlloyDB)
  • roles/owner (peran IAM dasar Pemilik)
  • roles/editor (peran IAM dasar Editor)

  Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi Anda 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 VM instances.

   Buka instance VM

2. Pilih project yang berisi instance AlloyDB yang ingin Anda hubungkan.
3. Klik Create instance.
4. Klik bagian Konfigurasi mesin.
5. Masukkan Nama untuk instance.
6. Konfigurasi 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 disetel ke jaringan VPC yang dikonfigurasi untuk akses layanan pribadi, luaskan dan tetapkan Network ke jaringan VPC.
10. Pertahankan nilai default di bagian Observability.
11. Klik bagian Keamanan.
12. Di bagian Identitas dan akses API, tetapkan Cakupan akses ke Izinkan akses penuh ke semua Cloud API.
13. Pertahankan nilai default di bagian Lanjutan.
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, Anda mungkin perlu membuat aturan firewall masuk untuk mengizinkan traffic ke VM Anda.

   Konsol

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

      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

Dapatkan alamat IP instance AlloyDB

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

Jalankan klien psql

1. Hubungkan ke VM yang Anda buat menggunakan SSH.

   Konsol

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

      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 -d postgres

   Anda akan diminta untuk memasukkan sandi pengguna USERNAME.

   Jika Anda terhubung untuk pertama kalinya, tentukan postgres untuk USERNAME dan database. Perintah Anda akan terlihat seperti berikut:

   psql -h IP_ADDRESS -U postgres -d postgres

   Gunakan sandi yang Anda tetapkan saat membuat cluster.