Menghubungkan ke Cloud SQL untuk PostgreSQL dari Compute Engine
Pelajari cara men-deploy aplikasi contoh di instance VM Compute Engine berbasis Linux atau Windows yang terhubung ke instance PostgreSQL menggunakan konsol Google Cloud dan aplikasi klien.
Dengan asumsi bahwa Anda menyelesaikan semua langkah secara tepat waktu, referensi yang dibuat dalam panduan memulai ini biasanya berharga kurang dari satu dolar (USD).
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.
-
Aktifkan Cloud API yang diperlukan untuk menjalankan aplikasi contoh Cloud SQL pada instance VM Compute Engine.
Konsol
Klik tombol Aktifkan API guna mengaktifkan API yang diperlukan untuk panduan memulai ini.
Tindakan ini mengaktifkan API berikut:
- Cloud SQL Admin API
gcloud
Instal gcloud CLI yang menyediakan akses command line ke resource Google Cloud Anda. gcloud CLI digunakan untuk menjalankan perintah
gcloud CLI
yang ditunjukkan di seluruh panduan memulai ini. Semua perintah diformat untuk dijalankan di jendela terminal atau Powershell.Jalankan perintah
gcloud
berikut:gcloud services enable sqladmin.googleapis.com
Perintah ini mengaktifkan API berikut:
- Cloud SQL Admin API
Menyiapkan Cloud SQL
Membuat instance Cloud SQL
Buat database
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih
quickstart-instance
. - Buka tab Databases.
- Klik Buat database.
- Di kotak dialog Database baru, masukkan
quickstart_db
sebagai nama database.
- Klik Create.
gcloud
Jalankan perintah gcloud
sql databases create
untuk membuat database.
gcloud sql databases create quickstart_db --instance=quickstart-instance
Membuat pengguna
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan instance, klik nama instance.
- Pilih Pengguna dari menu navigasi SQL.
- Klik Tambahkan akun pengguna.
- 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.
- Di kolom Nama pengguna, masukkan
- Klik Tambahkan.
gcloud
Sebelum menjalankan perintah berikut, buat pengganti berikut:
- 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
Batas panjang nama pengguna untuk Cloud SQL sama seperti PostgreSQL lokal.
Mengonfigurasi akun layanan Compute Engine
Konsol
Membuat akun layanan
- Di konsol Google Cloud, buka halaman Create service account.
- Pilih project Google Cloud.
- Masukkan
quickstart-service-account
sebagai nama akun layanan. - Opsional: Masukkan deskripsi akun layanan.
- Klik Buat dan lanjutkan serta lanjutkan ke langkah berikutnya.
- Pilih peran Klien Cloud SQL yang akan diberikan ke akun layanan pada project.
- Klik Tambahkan peran lainnya dan pilih peran Storage Object Viewer yang akan diberikan ke akun layanan pada project.
- Klik Lanjutkan.
- Klik Selesai untuk menyelesaikan pembuatan akun layanan.
gcloud
Membuat akun layanan
- Untuk membuat akun layanan, jalankan
gcloud iam service-accounts create
perintah: DESCRIPTION
: deskripsi opsional akun layanan- Untuk memberikan akun layanan peran Klien Cloud SQL
dan peran Storage Object Viewer pada project Anda, jalankan
perintah
gcloud projects add-iam-policy-binding
. Ganti PROJECT_ID dengan project ID 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" --role="roles/storage.objectViewer"
gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"
Ganti nilai berikut:
Membuat instance VM Compute Engine
Buat Instance VM Compute Engine untuk menghosting aplikasi web contoh yang terhubung ke Cloud SQL.
Mengakses instance VM Compute Engine
Menyiapkan lingkungan pengembangan untuk bahasa pemrograman
Siapkan lingkungan pengembangan instance VM Compute Engine untuk bahasa pemrograman pilihan Anda.
Menginstal Git
Instal Git, sistem kontrol versi open source, pada instance VM Compute Engine.
Meng-clone aplikasi contoh
Clone aplikasi contoh ke instance VM Compute Engine menggunakan perintah git clone
.
Go
Pada instance VM Compute Engine, buka jendela terminal atau Powershell baru. Jalankan perintah berikut untuk meng-clone aplikasi contoh Go dan mengubah direktori ke direktori yang berisi aplikasi contoh.
-
Buat clone aplikasi contoh
git clone https://github.com/GoogleCloudPlatform/golang-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd golang-samples/cloudsql/postgres/database-sql
Java
Pada instance VM Compute Engine, buka jendela terminal atau Powershell baru. Jalankan perintah berikut untuk meng-clone aplikasi contoh Java dan mengubah direktori ke direktori yang berisi aplikasi contoh.
-
Buat clone aplikasi contoh
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd java-docs-samples/cloud-sql/postgres/servlet
Node.js
Pada instance VM Compute Engine, buka jendela terminal atau Powershell baru. Jalankan perintah berikut untuk meng-clone aplikasi contoh Node.js dan mengubah direktori ke direktori yang berisi aplikasi contoh.
-
Buat clone aplikasi contoh
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi sampel.
cd nodejs-docs-samples/cloud-sql/postgres/knex
Python
Pada instance VM Compute Engine, buka jendela terminal atau Powershell baru. Jalankan perintah berikut untuk meng-clone aplikasi contoh Python dan mengubah direktori ke direktori yang berisi aplikasi contoh.
-
Buat clone aplikasi contoh
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
-
Ubah direktori ke direktori yang berisi aplikasi contoh.
cd python-docs-samples/cloud-sql/postgres/sqlalchemy
Mengonfigurasi dan menjalankan aplikasi contoh Cloud SQL
Dengan instance, database, dan akun layanan Cloud SQL dengan izin klien, Anda kini dapat mengonfigurasi aplikasi contoh yang berjalan pada instance VM Compute Engine untuk terhubung ke instance Cloud SQL.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
Menghapus instance Cloud SQL
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance
quickstart-instance
untuk membuka halaman Detail instance. - Pada panel ikon di bagian atas halaman, klik Hapus.
- Di kotak dialog Hapus instance, masukkan
quickstart-instance
, lalu klik Hapus untuk menghapus instance.
Menghapus instance VM Compute Engine
-
Di Konsol Google Cloud, buka halaman Instance VM.
- Pilih instance
quickstart-vm-instance
untuk membuka halaman Detail instance. - Pada panel ikon di bagian atas halaman, klik Hapus.
- Klik Hapus untuk menghapus instance.
Langkah-langkah pembersihan opsional
Jika tidak menggunakan peran klien Cloud SQL yang ditetapkan ke akun layanan
Compute Engine default
, Anda dapat menghapusnya.
-
Di Konsol Google Cloud, buka halaman IAM.
- Klik ikon edit (yang terlihat seperti pensil) untuk akun IAM yang bernama akun layanan default Compute Engine default.
- Hapus peran Klien Cloud SQL client.
- Klik Simpan.
Jika API yang diaktifkan sebagai bagian dari panduan memulai ini tidak digunakan, Anda dapat menonaktifkannya.
- API yang diaktifkan dalam panduan memulai ini:
- Cloud SQL Admin API
Di konsol Google Cloud, buka halaman APIs.
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: