Terhubung ke Cloud SQL untuk PostgreSQL dari komputer lokal Anda

Terhubung ke Cloud SQL untuk PostgreSQL dari komputer lokal Anda

MySQL   |  PostgreSQL   |  SQL Server

Pelajari cara men-deploy aplikasi contoh di komputer lokal berbasis Linux, macOS, atau Windows yang terhubung ke instance PostgreSQL menggunakan konsol Google Cloud dan aplikasi klien.

Dengan asumsi bahwa Anda menyelesaikan semua langkah-langkah secara tepat waktu, resource yang dibuat dalam panduan memulai ini biasanya berharga kurang dari satu dolar (USD).

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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

6. Aktifkan Cloud API yang diperlukan untuk menjalankan aplikasi sampel Cloud SQL di komputer lokal Anda.

   Konsol

   Klik tombol Enable APIs untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.

   Aktifkan API

   Tindakan ini memungkinkan API berikut:

   • Cloud SQL Admin API
   • IAM API

   gcloud

   Instal gcloud CLI yang menyediakan akses command line ke resource Google Cloud Anda. Gcloud CLI digunakan untuk menjalankan perintah gcloud CLI yang ditampilkan di seluruh panduan memulai ini. Semua perintah diformat untuk dijalankan di terminal Linux/macOS atau di Windows Powershell.

   Buka terminal dan jalankan perintah gcloud berikut:

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Perintah ini mengaktifkan API berikut:

   • Cloud SQL Admin API
   • IAM API

Menyiapkan Cloud SQL

Membuat instance Cloud SQL

Konsol

Membuat instance dengan alamat IP publik

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

   Buka Instance Cloud SQL

2. Klik Create Instance.
3. Klik Choose PostgreSQL.
4. Masukkan quickstart-instance untuk ID Instance.
5. Masukkan sandi untuk pengguna postgres. Simpan sandi ini untuk penggunaan berikutnya.
6. Klik opsi Single zone untuk Choose region and zonal availability.
7. Klik dan luaskan bagian Show Configuration Options.
8. Pada menu drop-down Machine Type, pilih Lightweight.

9. Klik Buat Instance dan tunggu hingga instance melakukan inisialisasi dan mulai.

gcloud

Membuat instance dengan alamat IP publik

Sebelum menjalankan perintah gcloud sql instances create sebagai berikut, ganti DB_ROOT_PASSWORD dengan sandi pengguna database Anda.

Atau, ubah nilai untuk parameter berikut:

• --database_version: Jenis dan versi mesin database. Jika tidak ditentukan, API default akan digunakan. Lihat dokumentasi versi database gcloud untuk melihat versi yang tersedia saat ini.
• --cpu: Jumlah core yang akan ditetapkan dalam mesin.
• --memory: Nilai bilangan bulat yang menunjukkan jumlah memori yang harus ditetapkan di mesin. Unit ukuran harus disediakan (misalnya, 3072 MB atau 9 GB). Jika tidak ada unit yang ditentukan, GB akan digunakan.
• --region: Lokasi regional instance (misalnya asia-east1, us-east1). Jika tidak ditentukan, us-central default akan digunakan. Lihat daftar lengkap region.

Jalankan perintah gcloud sql instances create untuk membuat instance Cloud SQL.

gcloud sql instances create quickstart-instance --database-version=POSTGRES_13 --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

Buat database

Konsol

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

   Buka Instance Cloud SQL

2. Pilih quickstart-instance.
3. Buka tab Databases.
4. Klik Buat database.
1. Di kotak dialog Database baru, masukkan quickstart_db sebagai nama database.
   
2. Klik Create.

gcloud

Jalankan perintah gcloud sql databases create untuk membuat database.

gcloud sql databases create quickstart_db --instance=quickstart-instance

Membuat pengguna

Konsol

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

   Buka Instance Cloud SQL

2. Untuk membuka halaman Ringkasan instance, klik nama instance.
3. Pilih Users dari menu navigasi SQL.
4. Klik Tambahkan akun pengguna.
5. Di halaman Tambahkan akun pengguna ke instance instance_name, tambahkan informasi berikut:
   • Di kolom Nama pengguna, masukkan quickstart-user
   • Di kolom Password, tentukan sandi untuk pengguna database Anda. Catat hal ini untuk digunakan di langkah selanjutnya dalam panduan memulai ini.
6. Klik Tambahkan.

gcloud

Ganti kode berikut:

1. PASSWORD dengan sandi untuk pengguna database Anda. Catat hal ini untuk digunakan di langkah selanjutnya dalam panduan memulai ini.

Jalankan perintah gcloud sql users create untuk membuat pengguna.

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

Batasan panjang nama pengguna untuk Cloud SQL sama seperti PostgreSQL lokal.

Menyiapkan akun layanan

Buat dan konfigurasi akun layanan Google Cloud yang memiliki peran Cloud SQL Client dengan izin untuk terhubung ke Cloud SQL. Setelah membuat akun layanan, Anda mungkin perlu menunggu selama 60 detik atau lebih sebelum menggunakan akun layanan.

Konsol

Membuat akun layanan

1. Di konsol Google Cloud, buka halaman Create service account.

Buka Create service account

2. Pilih project Google Cloud.
3. Masukkan quickstart-service-account sebagai nama akun layanan.
4. Opsional: Masukkan deskripsi akun layanan.
5. Klik Buat dan lanjutkan serta lanjutkan ke langkah berikutnya.
6. Pilih peran Klien Cloud SQL yang akan diberikan ke akun layanan pada project.
7. Klik Lanjutkan.
8. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

Membuat dan mendownload file kunci akun layanan

1. Di Konsol Google Cloud, buka halaman Service accounts.

Buka halaman Service accounts

2. Pilih project.
3. Klik alamat email akun layanan quickstart-service-account yang ingin Anda buatkan kunci.
4. Klik tab Kunci.
5. Klik menu drop-down Kunci, lalu pilih Buat kunci baru.
6. Pilih JSON sebagai jenis kunci dan klik Create.

Mengklik Buat akan mendownload file kunci akun layanan. Setelah mendownload file kunci, Anda tidak dapat mendownloadnya lagi.

Pastikan Anda menyimpan file kunci dengan aman, karena file tersebut dapat digunakan untuk melakukan autentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini sesuai keinginan.

gcloud

Membuat akun layanan

1. Untuk membuat akun layanan, jalankan gcloud iam service-accounts create perintah:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Ganti nilai berikut:

• DESCRIPTION: Deskripsi opsional untuk akun layanan
2. Untuk memberikan peran Klien Cloud SQL pada project Anda pada akun layanan, jalankan gcloud projects add-iam-policy-binding perintah. Ganti PROJECT_ID dengan ID project Google Cloud Anda.

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Membuat dan mendownload file kunci akun layanan

Untuk menggunakan akun layanan yang baru saja dibuat dari komputer lokal, Anda memerlukan file kunci akun layanan untuk mengautentikasi aplikasi sampel sebagai akun layanan. Untuk membuat dan mendownload file kunci akun layanan, jalankan gcloud iam service-accounts keys create perintah:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Ganti nilai berikut:

• KEY_FILE: Jalur ke file output baru untuk kunci pribadi — misalnya, ~/sa-private-key.json.
• PROJECT_ID: ID project Google Cloud Anda.

File kunci akun layanan kini didownload ke komputer lokal Anda. Setelah mendownload file kunci, Anda tidak dapat mendownloadnya lagi.

Pastikan Anda menyimpan file kunci dengan aman karena siapa pun dapat menggunakannya untuk mengautentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini sesuai keinginan.

Menyiapkan lingkungan pengembangan untuk bahasa pemrograman

Siapkan lingkungan pengembangan komputer lokal untuk bahasa pemrograman pilihan Anda.

Go

Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Go.

1. Buka panduan penyiapan untuk lingkungan pengembangan Go.
2. Selesaikan petunjuk di bagian Install Go.

Java

Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Java.

1. Buka panduan penyiapan untuk lingkungan pengembangan Java.
2. Selesaikan petunjuk di bagian Instal JDK (Java Development Kit).
3. Selesaikan petunjuk di instal alat otomatis build untuk menyiapkan Apache Maven.

Node.js

Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda guna menjalankan aplikasi sampel Node.js.

1. Buka panduan penyiapan untuk lingkungan pengembangan Node.js.
2. Selesaikan petunjuk di bagian Instal Node.js and npm.

Python

Selesaikan langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Anda untuk menjalankan aplikasi sampel Python.

1. Buka panduan penyiapan untuk lingkungan pengembangan Python.
2. Selesaikan petunjuk di bagian Instal Python.

Instal Git

Instal Git, sistem kontrol versi open source.

Linux

Ikuti dokumentasi penginstalan Git untuk Linuxyang resmi.

macOS

Ikuti dokumentasi penginstalan Git untuk macOSyang resmi.

Windows

Ikuti dokumentasi penginstalan Git untuk Windowsyang resmi.

Meng-clone aplikasi sampel

Clone aplikasi sampel ke komputer lokal Anda menggunakan git clone perintah.

Go

Jalankan perintah berikut untuk meng-clone aplikasi sampel Go ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.

1. Membuat clone aplikasi sampel.

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Ubah direktori ke direktori yang berisi aplikasi sampel.

   cd golang-samples/cloudsql/postgres/database-sql

Java

Jalankan perintah berikut untuk meng-clone aplikasi sampel Java ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.

1. Membuat clone aplikasi sampel.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Ubah direktori ke direktori yang berisi aplikasi sampel.

   cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Jalankan perintah berikut untuk meng-clone aplikasi sampel Node.js ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.

1. Membuat clone aplikasi sampel.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Ubah direktori ke direktori yang berisi aplikasi sampel.

   cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Jalankan perintah berikut untuk meng-clone aplikasi sampel Python ke komputer lokal Anda dan ubah direktori ke direktori yang berisi aplikasi sampel.

1. Membuat clone aplikasi sampel.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Ubah direktori ke direktori yang berisi aplikasi sampel.

   cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Mengonfigurasi dan menjalankan aplikasi sampel

Mengonfigurasi dan menjalankan aplikasi sampel.

Linux/macOS

Go

Buka terminal dan jalankan perintah berikut untuk menginisialisasi variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file kunci kredensial JSON akun layanan Anda menggunakan format seperti /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Jalankan perintah berikut untuk mendapatkan dependensi aplikasi sampel Go di komputer lokal Anda dan menjalankan aplikasi sampel.

1. Dapatkan dependensi yang diperlukan untuk menjalankan aplikasi sampel.

   go get ./...

2. Menjalankan aplikasi sampel.

   go run cmd/app/main.go

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela terminal tempat Anda memulai aplikasi sampel.

Java

Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file kunci kredensial JSON akun layanan Anda menggunakan format seperti /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Jalankan perintah berikut untuk mendapatkan dependensi aplikasi sampel Java di komputer lokal dan menjalankan aplikasi sampel.

   mvn jetty:run

2. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

3. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela terminal tempat Anda memulai aplikasi sampel.

Node.js

1. Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

   • CREDENTIALS_JSON_FILE dengan jalur file kunci kredensial JSON akun layanan Anda menggunakan format seperti /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'

2. Download Proxy Auth Cloud SQL.

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

3. Menjalankan Proxy Auth Cloud SQL sebagai proses latar belakang. Ganti INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasan instance Cloud SQL.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Catatan: Proses yang menjalankan Proxy Auth Cloud SQL di latar belakang dapat dihentikan menggunakan perintah fg di jendela Terminal tempat Anda memulai aplikasi sampel. Tindakan ini akan membawa tugas Proxy Auth Cloud SQL yang sedang berjalan ke latar depan terminal. Lalu tekan Control+C untuk menghentikan tugas proxy.

Jalankan perintah berikut untuk mendapatkan paket Node.js yang diperlukan ke komputer lokal Anda dan menjalankan aplikasi sampel.

1. Instal paket Node.js yang diperlukan untuk menjalankan aplikasi secara lokal.

   npm install

2. Menjalankan aplikasi sampel.

   npm start

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela terminal tempat Anda memulai aplikasi sampel.

Python

Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file kunci kredensial JSON akun layanan Anda menggunakan format seperti /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Jalankan perintah berikut untuk mendapatkan persyaratan aplikasi sampel Python di komputer lokal Anda dan jalankan aplikasi sampel.

1. Lakukan inisialisasi lingkungan virtual dan instal persyaratan untuk menjalankan aplikasi sampel.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt

2. Menjalankan aplikasi sampel.

   python app.py

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela terminal tempat Anda memulai aplikasi sampel.

Windows

Go

Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file dari file kunci kredensial JSON akun layanan Anda, menggunakan format seperti C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Jalankan perintah berikut untuk mendapatkan dependensi aplikasi sampel Go di komputer lokal Anda dan menjalankan aplikasi sampel.

1. Dapatkan dependensi yang diperlukan untuk menjalankan aplikasi sampel.

   go get ./...

2. Menjalankan aplikasi sampel.

   go run cmd\app\main.go

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela Powershell tempat Anda memulai aplikasi sampel.

Java

Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file dari file kunci kredensial JSON akun layanan Anda, menggunakan format seperti C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Jalankan perintah berikut untuk mendapatkan dependensi aplikasi sampel Java di komputer lokal dan menjalankan aplikasi sampel.

   mvn jetty:run

2. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

3. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela Powershell tempat Anda memulai aplikasi sampel.

Node.js

1. Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

   • CREDENTIALS_JSON_FILE dengan jalur file dari file kunci kredensial JSON akun layanan Anda, menggunakan format seperti C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"

2. Download Proxy Auth Cloud SQL.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe
   -O cloud-sql-proxy.exe

3. Menjalankan Proxy Auth Cloud SQL sebagai proses latar belakang. Ganti INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasan instance Cloud SQL.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Catatan: Proses yang menjalankan Proxy Auth Cloud SQL di latar belakang dapat dihentikan dengan memilih jendela cmd.exe yang dihasilkan oleh perintah Start-Process. Tutup jendela untuk menghentikan tugas proxy.

Jalankan perintah berikut untuk mendapatkan paket Node.js yang diperlukan di komputer lokal Anda dan menjalankan aplikasi sampel.

1. Instal paket Node.js yang diperlukan untuk menjalankan aplikasi secara lokal.

   npm install

2. Menjalankan aplikasi sampel.

   npm start

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela Powershell tempat Anda memulai aplikasi sampel.

Python

Jalankan perintah berikut untuk melakukan inisialisasi pada variabel lingkungan yang diperlukan untuk menjalankan aplikasi sampel. Sebelum menjalankan perintah, buat pengganti berikut:

• CREDENTIALS_JSON_FILE dengan jalur file dari file kunci kredensial JSON akun layanan Anda, menggunakan format seperti C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman Ringkasaninstance cloud SQL.
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat sebelumnya di langkah panduan memulai Membuat pengguna.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Jalankan perintah berikut untuk mendapatkan persyaratan aplikasi sampel Python di komputer lokal Anda dan jalankan aplikasi sampel.

1. Lakukan inisialisasi lingkungan virtual dan instal persyaratan untuk menjalankan aplikasi sampel.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt

2. Menjalankan aplikasi sampel.

   python app.py

3. Lihat aplikasi sampel yang sedang berjalan. Buka jendela browser, lalu buka http://127.0.0.1:8080.

   

4. Untuk menghentikan aplikasi sampel, tekan Control+C di jendela Powershell tempat Anda memulai aplikasi sampel.

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 quickstart-instance untuk membuka halaman Detail instance.
3. Pada panel ikon di bagian atas halaman, klik Hapus.
4. Di kotak dialog Hapus instance, ketik quickstart-instance, lalu klik Hapus untuk menghapus instance.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan peran klien Cloud SQL yang ditetapkan ke akun layanan quickstart-service-account, Anda dapat menghapusnya.

1. Di Konsol Google Cloud, buka halaman IAM.

   Buka IAM

2. Klik ikon edit (yang terlihat seperti pensil) untuk akun IAM bernama akun layanan panduan memulai.
3. Hapus peran klien Cloud SQL.
4. Klik Simpan.

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
  • Identity and Access Management API

1. Di konsol Google Cloud, buka halaman API.

   Buka API

2. Pilih API yang ingin Anda nonaktifkan, lalu klik tombol Nonaktifkan API.

Langkah selanjutnya

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.

Untuk mengetahui informasi selengkapnya tentang harga, lihat harga Cloud SQL untuk PostgreSQL.

Pelajari lebih lanjut:

• Mengonfigurasi instance Cloud SQL Anda dengan alamat IP publik.
• Mengonfigurasi instance Cloud SQL Anda dengan alamat IP pribadi.

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 Compute Engine
• Dari aplikasi yang berjalan di GKE
• Dari Cloud Functions
• Dari Cloud Run