Menghubungkan dari laptop

Untuk mempelajari AlloyDB untuk PostgreSQL atau bekerja di lingkungan pengembangan lokal, Anda dapat membuat koneksi yang aman dari laptop atau workstation lokal ke instance AlloyDB menggunakan Proxy Auth AlloyDB melalui alamat IP publik.

Sebelum memulai

Sebelum terhubung dari laptop, selesaikan prasyarat berikut:

Peran yang diperlukan

Untuk terhubung dari laptop, berikan peran yang telah ditetapkan berikut kepada akun utama Identity and Access Management (IAM) Anda (akun pengguna atau akun layanan):

  • AlloyDB Client (roles/alloydb.client)
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

Mengaktifkan IP publik di instance AlloyDB Anda

Cara paling mudah untuk terhubung dari laptop Anda adalah dengan mengaktifkan IP publik di instance AlloyDB Anda. Anda dapat mengaktifkan IP publik saat membuat instance atau mengupdate instance yang ada untuk mengaktifkannya.

Konsol

  1. Buka halaman Clusters di konsol Google Cloud .

    Buka Cluster

  2. Untuk melihat detail cluster, klik cluster di Resource Name.

  3. Di Instances in your cluster, temukan instance yang ingin Anda hubungkan.

  4. Klik Instance actions, lalu klik Edit.

  5. Di Connectivity, pilih Enable Public IP.

  6. Untuk menyimpan perubahan, klik Update instance.

gcloud

Gunakan perintah gcloud alloydb instances update untuk mengaktifkan IP publik di instance Anda:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Ganti kode berikut:

  • INSTANCE_ID: ID instance AlloyDB.
  • CLUSTER_ID: ID cluster.
  • REGION_ID: region tempat cluster berada.

Mengambil URI koneksi instance

Saat memulai klien Proxy Auth, Anda harus mengidentifikasi instance menggunakan URI koneksi uniknya. Ambil URI koneksi menggunakan perintah gcloud CLI alloydb instances describe di terminal laptop Anda.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

Perintah ini menampilkan URI koneksi, yang diformat mirip dengan berikut:

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

Memulai Proxy Auth AlloyDB dengan IP publik

Setelah Anda memiliki URI koneksi instance, mulai klien Proxy Auth menggunakan terminal laptop Anda. Gunakan flag --public-ip untuk memerintahkan Proxy Auth AlloyDB agar terhubung melalui jalur jaringan IP publik.

./alloydb-auth-proxy CONNECTION_URI --public-ip

Ganti CONNECTION_URI dengan URI koneksi instance yang Anda peroleh di Mengambil URI koneksi instance.

Jika Proxy Auth AlloyDB berhasil dimulai, terminal akan menunjukkan bahwa Proxy Auth AlloyDB memproses koneksi TCP lokal di port 5432:

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

Menghubungkan ke database menggunakan psql

Saat Proxy Auth AlloyDB berjalan, buka jendela terminal terpisah di laptop Anda untuk terhubung ke database.

Jalankan alat klien psql, yang menargetkan alamat pemroses lokal 127.0.0.1 dan port 5432:

psql -h 127.0.0.1 -U postgres -d postgres

Jika diminta, masukkan sandi pengguna database postgres.

Perintah psql terhubung ke klien Proxy Auth, yang meneruskan koneksi Anda melalui tunnel yang aman ke instance AlloyDB Anda. Perintah psql menampilkan prompt, yang mengonfirmasi bahwa laptop Anda terhubung dengan aman ke instance AlloyDB:

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

Langkah berikutnya