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

  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.

    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.

    Go to project selector

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

  6. 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.

    Aktifkan API

    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

  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 Buat.

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 Pengguna 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

Sebelum menjalankan perintah berikut, buat pengganti 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

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

Mengonfigurasi akun layanan Compute Engine

Buat dan konfigurasi akun layanan Google Cloud yang memiliki peran Klien Cloud SQL 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.
  2. Buka Create service account

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

gcloud

Membuat akun layanan

  1. Untuk membuat akun layanan, jalankan gcloud iam service-accounts create perintah:
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    Ganti nilai berikut:

    • DESCRIPTION: deskripsi opsional akun layanan
  3. 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"

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.

  1. Buat clone aplikasi contoh
    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

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.

  1. Buat clone aplikasi contoh
    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

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.

  1. Buat clone aplikasi contoh
    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

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.

  1. Buat clone aplikasi contoh
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. 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

  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, masukkan quickstart-instance, lalu klik Hapus untuk menghapus instance.

Menghapus instance VM Compute Engine

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

    Buka instance VM

  2. Pilih instance quickstart-vm-instance untuk membuka halaman Detail instance.
  3. Pada panel ikon di bagian atas halaman, klik Hapus.
  4. 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.

  1. Di Konsol Google Cloud, buka halaman IAM.

    Buka IAM

  2. Klik ikon edit (yang terlihat seperti pensil) untuk akun IAM yang bernama akun layanan default Compute Engine default.
  3. Hapus peran Klien Cloud SQL client.
  4. 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
  1. Di konsol Google Cloud, buka halaman APIs.

    Buka API

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

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.

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: