Hubungkan dari Compute Engine

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

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

1. Membuat VM Compute Engine yang dapat terhubung ke instance AlloyDB menggunakan akses layanan pribadi.
2. Menginstal klien psql di VM Compute Engine.
3. Mendapatkan alamat IP instance AlloyDB yang ingin Anda hubungkan.
4. Menjalankan 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 yang Anda gunakan harus diaktifkan untuk mengakses AlloyDB. Google Cloud
• Jaringan VPC di Google Cloud project yang Anda gunakan harus sudah dikonfigurasi untuk layanan pribadi akses ke AlloyDB.
• Anda harus memiliki salah satu peran IAM berikut 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 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 Google Cloud konsol, buka halaman VM instances.

   Buka instance VM

2. Pilih project yang berisi instance AlloyDB yang Anda ingin Anda hubungkan.
3. Klik Create instance.
4. Klik bagian Machine configuration.
5. Masukkan Name 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 ditetapkan ke jaringan VPC yang dikonfigurasi untuk akses layanan pribadi, luaskan, lalu tetapkan Network ke jaringan VPC.
10. Pertahankan nilai default di bagian Observability.
11. Klik bagian Security.
12. Di bagian Identity and API access, tetapkan Access scopes ke Allow full access to all Cloud APIs.
13. Pertahankan nilai default di bagian Advanced.
14. Klik Create.

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

Menginstal alat klien psql

Untuk menginstal alat klien psql di host klien, lihat Menginstal alat klien psql.

Jika Anda menggunakan VM Compute Engine sebagai host klien, ikuti langkah-langkah berikut untuk terhubung ke VM dan menginstal 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.

   Konsol

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

      Buka instance VM

   2. Dalam 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 ke, lihat setelan instance tersebut.

Menjalankan klien psql

1. Hubungkan ke VM yang Anda buat menggunakan SSH.

   Konsol

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

      Buka instance VM

   2. Dalam 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.

Langkah berikutnya

• Pelajari cara lain untuk terhubung ke AlloyDB.