Hubungkan dari Compute Engine

Untuk menjalankan kueri SQL dan mengelola database dari virtual machine (VM) di jaringan Virtual Private Cloud (VPC), Anda dapat menghubungkan alat klien psql di VM Compute Engine ke instance AlloyDB melalui akses layanan pribadi:

  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 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 menyelesaikan tugas yang tersisa.

Sebelum memulai

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

    Jika Anda tidak memiliki peran ini, hubungi Organization Administrator untuk meminta akses.

  • Jika host klien memiliki firewall, host tersebut harus mengizinkan koneksi egress ke port 5432 di 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 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, dan 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 Keamanan.
  12. Di bagian Identity and API access, tetapkan Cakupan akses 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 Anda, 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.

    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

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 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 -p 5432 -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 -p 5432 -U postgres -d postgres

    Gunakan sandi yang Anda tetapkan saat membuat cluster.

Langkah berikutnya