Menghubungkan ke instance Cloud SQL untuk PostgreSQL dengan IP pribadi

Menghubungkan ke instance Cloud SQL untuk PostgreSQL dengan IP pribadi

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menunjukkan cara membuat dan terhubung ke instance PostgreSQL menggunakan IP pribadi. Resource yang dibuat dalam panduan memulai ini biasanya berbiaya lebih rendah daripada satu dolar, dengan asumsi bahwa Anda menyelesaikan langkah-langkah, termasuk pembersihan, secara tepat waktu.

---

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di konsol Google Cloud, klik Pandu saya:

Pandu saya

---

Sebelum memulai

Catatan: Nama yang Anda gunakan untuk project harus terdiri dari 4 hingga 30 karakter. Saat Anda mengetik nama tersebut, formulir akan menyarankan ID project yang dapat Anda edit. ID project harus terdiri dari 6 hingga 30 karakter, dengan huruf kecil sebagai karakter pertama. Anda dapat menggunakan tanda pisah, huruf kecil, atau angka untuk karakter yang tersisa, tetapi karakter terakhir tidak boleh berupa tanda pisah.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Mengaktifkan Google Cloud API yang diperlukan.

   Konsol

   Di konsol Google Cloud, buka halaman APIs.

   Buka API

   Mengaktifkan Cloud SQL Admin API. Dengan mengaktifkan API ini, Anda dapat menjalankan Proxy Auth Cloud SQL.

   gcloud

   Klik tombol berikut untuk membuka Cloud Shell, yang menyediakan akses command line ke resource Google Cloud langsung dari browser. Cloud Shell dapat digunakan untuk menjalankan perintah gcloud yang disajikan di seluruh panduan memulai ini.

   Buka Cloud Shell

   Jalankan perintah gcloud services enable sebagai berikut menggunakan Cloud Shell untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.:

   gcloud services enable sqladmin.googleapis.com

   Perintah ini mengaktifkan API berikut:

   • Cloud SQL Admin API Dengan mengaktifkan API ini, Anda dapat menjalankan Proxy Auth Cloud SQL.

Ringkasan

Ada banyak cara untuk terhubung ke instance Cloud SQL dengan alamat IP pribadi, bergantung pada lokasi sumbernya. Faktor kuncinya adalah mesin sumber harus berada dalam jaringan VPC yang sama dengan instance Cloud SQL. Jika sumber tidak ada di Google Cloud atau tidak ada di proyek Google Cloud yang sama ,Anda harus mengonfigurasi konektivitas secara berbeda dari yang kami tampilkan disini.

Dalam Panduan memulai Inini, kami mengonfigurasikan konektivitas melalui jalur yang paling langsung. Sumber dan target berada di project Google Cloud yang sama dan dalam jaringan VPC yang sama. Kami membuat instance Cloud SQL dengan alamat IP pribadi (target) dan VM Compute Engine (sumber). Kami menggunakan VM untuk menginstal dan digunakan alat yang diperlukan untuk menghubungkan dari VM ke instance Cloud SQL.

Melakukan tindakan berikut:

1. Buat instance Cloud SQL dengan alamat IP pribadi.

   Temukan dan simpan instance connection name untuk digunakan nanti.

2. Membuat VM Compute Engine.
3. Buka dua koneksi SSH ke VM Compute Engine.

   Anda akan menggunakan jendela pertama untuk menginstal psql, dan menginstal lalu memulai Proxy Auth Cloud SQL. Kemudian Anda akan menggunakan jendela kedua untuk menghubungkan ke instance Cloud SQL instance dengan menghubungkan ke proxy Auth Cloud SQL.

4. Di jendela SSH #1, laKukan hal berikut:
   1. Instal klien psql.
   2. Instal Proxy Auth Cloud SQL.

      Proxy Auth Cloud SQL berfungsi sebagai konektorantara klien psql dan instance Cloud SQL.

   3. Mulai Proxy Auth Cloud SQL.

      Jika berhasil, Proxy Auth Cloud SQL akan memproses permintaan koneksi.

5. Di jendela SSH #2, menghubungkan ke instance Cloud SQL dengan meminta klien psql terhubung ke Proxy Auth Cloud SQL.

   Jika berhasil, Anda akan melihat perintah psql di jendela ini, dan pesan koneksi yang berhasil di jendela SSH #1, tempat proxy Auth Cloud SQL dijalankan.

6. Pembersihan.

Membuat instance Cloud SQL dengan alamat IP pribadi

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

   Buka Instance Cloud SQL

2. Klik Create Instance.
3. Klik Choose PostgreSQL.
4. Jika Anda diminta untuk mengaktifkan Compute API, klik tombol Enable API.
5. Di bagian Info instance, masukkan nama untuk ID Instance.
6. Masukkan sandi untuk pengguna postgres. Catat sandi yang Anda buat, karena Anda akan memerlukannya nanti.
7. Di bagian Choose region and zonal availability, pilih opsi Single zone.
8. Luaskan Show configuration options.
9. Luaskan Connections.
10. Hapus IP Publik.
11. Pilih Private IP.
12. Dari menu dropdown Network, pilih default.
13. Jika menggunakan project baru, Anda akan diminta oleh pesan: Private service connection required. Lalu, ikuti langkah-langkah berikut:
1. Klik Siapkan koneksi.
2. Klik Enable service networking API.
3. Di bagian Allocate an IP range, pilih Use an automatically allocated IP range.
4. Klik Lanjutkan.
5. Klik Create connection dan tunggu hingga pembuatan koneksi selesai.

14. Klik Create instance.

Anda akan diarahkan ke halaman Ringkasan instance. Klik instance baru untuk melihat detailnya, termasuk alamat IP pribadinya.

Di bagian Connect to this instance, salin dan simpan Connection name instance. connection name menggunakan format projectID:region:instanceID.

Anda akan menggunakan ini connection name nanti saat memulai Proxy Auth Cloud SQL.

Buat database

Kembali ke halaman Overview instance dan pilih item menu Databases.

• Pilih Create database.
• Masukkan DB_NAME di kolom Database name.
• Klik Buat.

Anda akan menggunakan db_name ini nanti saat terhubung menggunakan Proxy Auth Cloud SQL.

Membuat VM Compute Engine

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

   Buka instance VM

2. Klik Create instance.
3. Masukkan Nama untuk instance.
4. Di bagian Access scope, pilih Allow full access to all Cloud APIs.
5. Klik Create dan tunggu hingga VM selesai dibuat.

Membuka dua koneksi SSH ke VM Compute Engine

Kita menggunakan dua jendela di VM. Jendela pertama digunakan untuk menginstal klien psql dan Proxy Auth Cloud SQL, mendapatkan koneksi nama instance, dan gunakan nama ini untuk memulai proxy. Jendela kedua digunakan untuk menghubungkan ke instance Cloud SQL melalui proxy.

1. Luaskan menu SSH dikolom Connect untuk instance VM Compute Engine Anda.
2. Pilih Open in browser window untuk membuka jendela SSH #1.

   Mungkin perlu waktu beberapa detik hingga perintah di jendela menjadi tersedia untuk Anda.

3. Saat perintah muncul, masukkan pwd untuk memverifikasi bahwa Anda berada di direktori /home/$USER.

   Di jendela ini, Anda akan menginstal klien psql dan Proxy Auth Cloud SQL, serta memulai Proxy Auth Cloud SQL.

4. Pilih Open in browser window lagi untuk membuka jendela SSH #2.

   Anda akan menggunakan jendela ini untuk terhubung ke instance Cloud SQL.

Menginstal klien psql

Gunakan jendela SSH #1 untuk langkah ini.

Instal klien psql dari pengelola paket:

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

Menginstal Proxy Auth Cloud SQL

Gunakan jendela SSH #1 untuk langkah ini.

1. Instal wget:

   sudo apt-get install wget
       

2. Download Proxy Auth Cloud SQL:

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Jadikan Proxy Auth Cloud SQL dapat dieksekusi:

   chmod +x cloud-sql-proxy
     

Memulai Proxy Auth Cloud SQL

Gunakan jendela SSH #1 untuk langkah ini.

Mulai Proxy Auth Cloud SQL agar Anda dapat memantau outputnya. Ganti INSTANCE_CONNECTION_NAME dengan connection name salinan Anda saat membuat instance Cloud SQL.

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

Catatan: secara default,Proxy Auth Cloud SQL mencoba untuk terhubung ke instance Cloud SQL Anda menggunakan alamat publik IPv4. Jika instance hanya memiliki IP pribadi atau instance memiliki IP publik dan pribadi yang dikonfigurasi, dan Anda ingin Proxy Auth Cloud SQL menggunakan alamat IP pribadi, Anda harus memberikan --private-ip saat Anda memulai Proxy Auth Cloud SQL.

Jika Anda melihat error bahwa alamat sudah digunakan, berarti instance lokal database sedang berjalan, dan Anda harus menghentikannya. Temukan SERVICE_NAME dengan menjalankan perintah ps -ef | grep psql, lalu jalankan perintah:

sudo service SERVICE_NAME stop
  

Jika Proxy Auth Cloud SQL berhasil memulai,pesan yang serupa dengan berikut ini akan muncul di jendela SSH.

Listening on 127.0.0.1:5432 for myInstance
Ready for new connections

Hubungkan ke instance Cloud SQL Anda.

Gunakan jendela SSH #2 untuk langkah ini.

Jalanakan perintah berikut setelah mengganti DB_NAME dengan nama database Cloud SQL:

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=DB_NAME user=postgres"

Pada bagian Masukkan sandi: prompt, masukkan sandi akun PostgreSQL Anda.

Pastikan perintah PostgreSQL muncul. Anda telah terhubung ke database menggunakan klien psql.

Kembali ke jendela terminal tempat Anda memulai Proxy Auth Cloud SQL. Anda akan melihat pesan yang mirip dengan berikut ini:

New connection for myInstance

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

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

   Buka Instance Cloud SQL

2. Pilih instance myinstance untuk membuka halaman Instance details.
3. Pada panel ikon di bagian atas halaman, klik Hapus.
4. Di jendela Hapus instance, ketik nama instance, lalu klik Hapus.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan API yang diaktifkan sebagai bagian dari panduan memulai ini, Anda dapat menonaktifkannya.

• API yang diaktifkan dalam panduan memulai ini:
  • Cloud SQL Admin API

1. Di konsol Google Cloud, buka halaman APIs.

   Buka API

2. Pilih Cloud SQL Admin API, lalu klik tombol Disable API.

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

   Buka instance VM

4. Pilih nama instance.

5. Pilih Hapus dari menu Tindakan lainnya.

Langkah berikutnya

Berdasarkan kebutuhan, Anda dapat mempelajari lebih lanjut cara membuat instance Cloud SQL.

Anda juga dapat mempelajari cara membuat pengguna PostgreSQL dan database untuk instance Cloud SQL.

Selain itu, Anda dapat mempelajari cara menghubungkan ke instance Cloud SQL dari aplikasi Google Cloud lainnya:

• Dari aplikasi yang berjalan di lingkungan standar App Engine
• Dari aplikasi yang berjalan di GKE
• Dari Cloud Run Functions
• Dari Cloud Run