Menghubungkan ke Cloud SQL untuk PostgreSQL menggunakan Cloud SQL Auth Proxy

Menghubungkan ke Cloud SQL untuk PostgreSQL menggunakan Cloud SQL Auth Proxy

MySQL   |  PostgreSQL   |  SQL Server

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 di halaman ini hanya untuk lingkungan pengujian dan tidak boleh digunakan untuk lingkungan produksi. Untuk informasi selengkapnya tentang konfigurasi yang diperlukan untuk lingkungan produksi, lihat Menggunakan Proxy Auth Cloud SQL di lingkungan produksi dan Menghubungkan menggunakan Proxy Auth Cloud SQL.

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.

   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

Membuat instance Cloud SQL

Dalam panduan memulai ini, Anda akan menggunakan Konsol Google Cloud. Untuk menggunakan gcloud CLI, cURL, atau PowerShell, lihat Membuat instance.

1. Di konsol Google Cloud, buka halamanInstance Cloud SQL.

   Buka Instance Cloud SQL

2. Klik Buat instance.
3. Klik Pilih PostgreSQL.
4. Di kolom Instance ID, masukkan myinstance.
5. Di kolom Sandi, masukkan sandi untuk pengguna postgres.

6. Klik Create instance.

   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.

   Catatan: Dalam contoh ini, instance dibuat menggunakan setelan default, termasuk alamat IP publik.

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

1. Download PostgreSQL Core Distribution untuk platform dari halaman Download PostgreSQL.
   Core Distribution sudah termasuk klien psql.
2. 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

1. Download Proxy Auth Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.linux.amd64

2. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:

   chmod +x cloud-sql-proxy

Linux 32 bit

1. Download Proxy Auth Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.linux.386

2. Jika perintah curl tidak ditemukan, jalankan sudo apt install curl dan ulangi perintah download.
3. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:

   chmod +x cloud-sql-proxy

macOS 64-bit

1. Download Proxy Auth Cloud SQL:

   curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.darwin.amd64

2. Buat Proxy Auth Cloud SQL agar dapat dieksekusi:

   chmod +x cloud-sql-proxy

Mac M1

1. Download Proxy Auth Cloud SQL:

     curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.darwin.arm64
     

2. 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.14.1/cloud-sql-proxy.x64.exe dan pilih Simpan Link Sebagai untuk mendownload Proxy Auth Cloud SQL. Ganti nama file menjadi cloud-sql-proxy.exe.

Windows 32 bit

Klik kanan https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.x86.exe dan pilih Simpan Link Sebagai untuk mendownload Proxy Auth Cloud SQL. Ganti nama file menjadi cloud-sql-proxy.exe.

Image Docker Proxy Auth Cloud SQL

Proxy Auth Cloud SQL memiliki image penampung yang berbeda, seperti distroless, alpine, dan buster. Image penampung Proxy Auth Cloud SQL default menggunakan distroless, yang tidak berisi shell. Jika Anda memerlukan shell atau alat terkait, download image berdasarkan alpine atau buster. Untuk mengetahui informasi selengkapnya, lihat Image Penampung Proxy Auth Cloud SQL.

Anda dapat menarik image terbaru ke mesin lokal menggunakan Docker dengan menggunakan perintah berikut:

docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.14.1

Catatan: Proxy Auth Cloud SQL menggunakan repositori yang mendukung domain gcr.io, tetapi menayangkan image dari Artifact Registry. Untuk informasi selengkapnya, lihat Transisi dari Container Registry.

OS Lainnya

Untuk sistem operasi lain yang tidak disertakan di sini, Anda dapat mengompilasi Proxy Auth Cloud SQL dari sumber.

Mendapatkan nama koneksi instance

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

   Buka Instance Cloud SQL

2. Klik nama instance untuk membuka halaman Ringkasan.
3. 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.

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.

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.