Menghubungkan ke Cloud SQL untuk PostgreSQL menggunakan Cloud SQL Auth Proxy
Halaman ini menunjukkan cara terhubung ke Cloud SQL dari lingkungan pengujian lokal menggunakan Proxy Auth Cloud SQL. Proxy Auth Cloud SQL memberikan akses yang aman ke instance Cloud SQL Anda tanpa memerlukan jaringan yang diizinkan atau konfigurasi SSL. Dengan menggunakan Proxy Auth Cloud SQL, Anda dapat terhubung ke instance Cloud SQL dengan aman.
Petunjuk pada halaman ini hanya untuk lingkungan pengujian dan tidak boleh yang digunakan untuk lingkungan produksi. Untuk informasi selengkapnya tentang konfigurasi yang diperlukan untuk lingkungan produksi, lihat Menggunakan Proxy Auth Cloud SQL di lingkungan produksi dan Terhubung dengan menggunakan Proxy Auth Cloud SQL.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Mengaktifkan Google Cloud API yang diperlukan.
Konsol
Di konsol Google Cloud, buka halaman APIs.
Mengaktifkan Cloud SQL Admin API.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.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
Membuat instance Cloud SQL
Dalam panduan memulai ini, Anda akan menggunakan Konsol Google Cloud. Untuk menggunakan gcloud CLI, cURL, atau PowerShell, lihat Membuat instance.
-
Di konsol Google Cloud, buka halamanInstance Cloud SQL.
- Klik Create Instance.
- Klik Pilih PostgreSQL.
- Masukkan
myinstance
untuk ID Instance. - Masukkan sandi untuk pengguna
postgres
. Klik Buat.
Anda akan kembali ke daftar instance. Anda dapat langsung mengklik instance baru untuk melihat detailnya, tetapi instance tidak akan tersedia untuk operasi lain sampai instance melakukan inisialisasi dan dimulai.
Debian/Ubuntu
Instal klien psql dari pengelola paket:
sudo apt-get update sudo apt-get install postgresql-client
CentOS/RHEL
Instal klien psql dari pengelola paket:
sudo yum install postgresql
openSUSE
Instal klien psql dari pengelola paket:
sudo zypper install postgresql
Platform lainnya
- Download PostgreSQL Core Distribution untuk platform dari
halaman Download PostgreSQL.
Core Distribution sudah termasuk klien psql. - Instal database PostgreSQL, dengan mengikuti petunjuk di halaman download.
Menginstal klien Proxy Auth Cloud SQL
Biner Proxy Auth Cloud SQL yang Anda download tergantung pada sistem operasi Anda, dan apakah
menggunakan kernel 32-bit atau 64-bit.
Sebagian besar perangkat keras yang lebih baru menggunakan kernel 64-bit. Jika tidak yakin apakah mesin Anda
menjalankan kernel 32-bit atau 64-bit, gunakan perintah uname -a
untuk Linux atau macOS. Untuk Windows, lihat
dokumentasi Windows.
Linux 64 bit
- Download Proxy Auth Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.linux.amd64
- Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
chmod +x cloud-sql-proxy
Linux 32 bit
- Download Proxy Auth Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.linux.386
- Jika perintah
curl
tidak ditemukan, jalankansudo apt install curl
dan ulangi perintah download. - Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
chmod +x cloud-sql-proxy
macOS 64-bit
- Download Proxy Auth Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.darwin.amd64
- Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
chmod +x cloud-sql-proxy
Mac M1
- Download Proxy Auth Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.darwin.arm64
- Buat Proxy Auth Cloud SQL agar dapat dieksekusi:
chmod +x cloud-sql-proxy
Windows 64 bit
Klik kanan https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.x64.exe dan pilih Save Link As untuk mendownload Cloud SQL Auth Proxy. Ganti nama file menjadicloud-sql-proxy.exe
.
Windows 32 bit
Klik kanan https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.13.0/cloud-sql-proxy.x86.exe dan pilih Save Link As untuk mendownload Cloud SQL Auth Proxy. Ganti nama file menjadicloud-sql-proxy.exe
.
Image Docker Proxy Auth Cloud SQL
Auth Proxy Cloud SQL memiliki image container yang berbeda, seperti distroless
, alpine
,
dan buster
. Image container Cloud SQL Auth Proxy default digunakan
distroless
, yang
tidak mengandung {i>shell<i}. Jika Anda membutuhkan {i>shell<i} atau alat terkait, maka unduh {i>image<i} berdasarkan
alpine
atau buster
.
Untuk informasi selengkapnya, lihat
Image Container Proxy Auth Cloud SQL.
Anda dapat menarik image terbaru ke mesin lokal Anda menggunakan Docker menggunakan perintah berikut:
docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.13.0
OS Lainnya
Untuk sistem operasi lain yang tidak disertakan di sini, Anda dapat mengompilasi Proxy Auth Cloud SQL dari sumber.Mendapatkan nama koneksi instance
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik nama instance untuk membuka halaman Ringkasan.
- Di bagian Terhubung ke instance ini, salin Nama koneksi. Nama
koneksi dalam format
projectID:region:instanceID
.
Memulai Proxy Auth Cloud SQL
Mulai Proxy Auth Cloud SQL di terminalnya sendiri sehingga Anda dapat memantau outputnya. Ganti
INSTANCE_CONNECTION_NAME
dengan nama koneksi instance yang Anda salin
di langkah sebelumnya.
Untuk lingkungan Linux, gunakan perintah ini untuk meluncurkan Proxy Auth Cloud SQL:
./cloud-sql-proxy INSTANCE_CONNECTION_NAME
Pada PowerShell di Windows, gunakan perintah ini untuk meluncurkan Proxy Auth Cloud SQL:
.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME
Akan muncul pesan yang mirip dengan berikut ini:
Listening on 127.0.0.1:5432 for INSTANCE_CONNECTION_NAME Ready for new connections
Jalankan 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.
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance
myinstance
untuk membuka halaman Instance details. - Pada panel ikon di bagian atas halaman, klik Hapus.
- 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
Di konsol Google Cloud, buka halaman APIs.
Pilih Cloud SQL Admin API, lalu klik tombol Disable API.
Langkah berikutnya
Lihat cara memecahkan masalah informasi untuk Proxy Auth Cloud SQL.
Pelajari Proxy Auth Cloud SQL lebih lanjut.
- Pelajari lebih lanjut tentang opsi koneksi lainnya.