Hubungkan ke Cloud SQL untuk PostgreSQL dari lingkungan standar App Engine

Hubungkan ke Cloud SQL untuk PostgreSQL dari lingkungan standar App Engine

MySQL   |  PostgreSQL   |  Server SQL

Pelajari cara men-deploy contoh aplikasi di lingkungan standar App Engine yang terhubung ke instance PostgreSQL menggunakan konsol Google Cloud dan aplikasi klien.

Dengan asumsi bahwa Anda menyelesaikan semua langkah 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. 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 Cloud API yang diperlukan untuk menjalankan aplikasi contoh Cloud SQL di lingkungan standar App Engine.

   Konsol

   Klik tombol di bawah untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.

   Aktifkan API

   Tindakan ini memungkinkan API berikut:

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging 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 berikut menggunakan Cloud Shell:

   gcloud services enable sqladmin.googleapis.com compute.googleapis.com \
   cloudbuild.googleapis.com logging.googleapis.com

   Perintah ini mengaktifkan API berikut:

   • Cloud SQL Admin API
   • Compute Engine API
   • Cloud Build API
   • Cloud Logging API

Menyiapkan Cloud SQL

Membuat instance Cloud SQL

IP Publik

Konsol

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

   Buka Instance Cloud SQL

2. Klik Buat instance.
3. Klik Pilih PostgreSQL.
4. Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
5. Di kolom Instance ID masukkan quickstart-instance.
6. Pada kolom Password, masukkan sandi untuk pengguna postgres. Simpan sandi ini untuk penggunaan berikutnya.
7. Di bagian Pilih region dan ketersediaan zonal, pilih Zona tunggal.
8. Klik menu Tampilkan opsi konfigurasi.
9. Luaskan node Machine configuration.
10. Dari region Machine shapes, pilih bentuk 4 vCPU, 32 GB.
11. Klik Buat instance lalu tunggu hingga instance melakukan inisialisasi dan dimulai.

gcloud

Sebelum menjalankan perintah 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, default API akan digunakan. Lihat dokumentasi versi database gcloud untuk melihat versi yang tersedia saat ini.
• --cpu: Jumlah inti yang diinginkan dalam mesin.
• --memori: Nilai bilangan bulat yang menunjukkan jumlah memori yang diinginkan dalam mesin. Unit ukuran harus ditentukan (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.

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

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

IP Pribadi

Konsol

Mengalokasikan rentang alamat IP dan membuat koneksi pribadi guna mengonfigurasi akses layanan pribadi untuk Cloud SQL

1. Di konsol Google Cloud, buka halaman jaringan VPC.

   Buka jaringan VPC

2. Pilih jaringan VPC default
3. Pilih tab Private service connection.
4. Pilih tab Rentang IP yang dialokasikan untuk layanan.
5. Klik Alokasikan rentang IP.
6. Untuk Nama rentang yang dialokasikan, tentukan google-managed-services-default.
7. Pilih opsi Otomatis untuk rentang IP dan tentukan panjang awalan sebagai 16.
8. Klik Alokasikan untuk membuat rentang yang dialokasikan.
9. Pilih tab Koneksi pribadi pada layanan untuk jaringan VPC default.
10. Klik Buat koneksi untuk membuat koneksi pribadi antara jaringan Anda dan produsen layanan.
11. Untuk Alokasi yang ditetapkan, pilih google-managed-services-default.
12. Klik Hubungkan untuk membuat koneksi.

Membuat instance dengan alamat IP pribadi dan SSL diaktifkan

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

   Buka Instance Cloud SQL

2. Klik Buat instance.
3. Klik Pilih PostgreSQL.
4. Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
5. Di kolom Instance ID masukkan quickstart-instance.
6. Pada kolom Password, masukkan sandi untuk pengguna postgres. Simpan sandi ini untuk penggunaan berikutnya.
7. Di bagian Pilih region dan ketersediaan zonal, pilih Zona tunggal.
8. Klik menu Tampilkan opsi konfigurasi.
9. Luaskan node Machine configuration.
10. Dari region Machine shapes, pilih bentuk 4 vCPU, 32 GB.
11. Luaskan node Connections.
12. Hapus centang pada kotak IP Publik untuk membuat instance hanya dengan alamat IP pribadi.
13. Centang kotak IP Pribadi.
14. Dari menu Network, pilih default.
15. Klik Buat instance, lalu tunggu hingga instance diinisialisasi dan dimulai.
16. Klik Koneksi.
17. Di bagian Keamanan, pilih Hanya izinkan koneksi SSL untuk mengaktifkan koneksi SSL.
18. Pada dialog Hanya izinkan koneksi SSL, klik Simpan, lalu tunggu hingga instance dimulai ulang.

gcloud

Mengalokasikan rentang alamat IP dan membuat koneksi pribadi guna mengonfigurasi akses layanan pribadi untuk Cloud SQL

1. Jalankan perintah gcloud compute addresses create untuk mengalokasikan rentang alamat IP.

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. Jalankan perintah gcloud services vpc-peerings connect untuk membuat koneksi pribadi ke rentang alamat IP yang dialokasikan. Ganti YOUR_PROJECT_ID dengan ID project milik Anda.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

Membuat instance dengan alamat IP pribadi dan SSL diaktifkan

1. Sebelum menjalankan perintah berikut ini, 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, default API akan digunakan. Lihat dokumentasi versi database gcloud untuk melihat versi yang tersedia saat ini.
• --cpu: Jumlah inti dalam mesin.
• --memori: Nilai keseluruhan menunjukkan jumlah memori yang disertakan dalam mesin. Unit ukuran mungkin sudah ditentukan (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-central1 default akan digunakan. Lihat daftar lengkap region.

Jalankan perintah gcloud sql instances create untuk membuat instance Cloud SQL dengan alamat IP Pribadi.

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. Jalankan perintah gcloud sql instances patch untuk mengaktifkan hanya izinkan koneksi SSL untuk instance.

gcloud sql instances patch quickstart-instance --require-ssl

Buat database

Konsol

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

   Buka Instance Cloud SQL

2. Pilih quickstart-instance.
3. Dari menu navigasi SQL, pilih Databases.
4. Klik Buat Instance.
1. Di kolom Nama Database di kotak dialog Database baru , masukkan quickstart-db.
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. Dari menu navigasi SQL, pilih Pengguna.
4. Klik Tambahkan akun pengguna.
5. Di halaman Tambahkan akun pengguna ke instance instance_name, tambahkan informasi berikut:
   1. Di kolom Nama pengguna, masukkan quickstart-user.
   2. Pada kolom Sandi, tetapkan sandi untuk pengguna database Anda. Catat sandi ini untuk digunakan pada 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.

Deploy aplikasi contoh ke lingkungan standar App Engine

Membuat aplikasi App Engine

Buat aplikasi App Engine di project Google Cloud Anda. Tindakan ini akan mengaktifkan layanan App Engine, membuat aplikasi App Engine default dan membuat akun layanan App Engine yang akan digunakan untuk terhubung ke Cloud SQL.

Catatan: Langkah ini hanya perlu dilakukan sekali per Google Cloud project.

Konsol

1. Pada konsol Google Cloud, buka halaman App Engine.

   Buka App Engine

2. Klik tombol Create application.
3. Pilih us-central dari menu drop-down pilih region.
4. Klik Next.
5. Klik link Saya akan melakukannya nanti setelah muncul di halaman Mulai.

gcloud

1. Jalankan perintah berikut gcloud app create untuk membuat aplikasi App Engine:

gcloud app create

2. Saat diminta untuk memilih region tempat aplikasi App Engine Anda berada, masukkan pilihan numerik untuk us-central.

Mengonfigurasi akun layanan App Engine

Konfigurasikan akun layanan yang digunakan oleh App Engine agar memiliki peran Klien Cloud SQL dengan izin untuk terhubung ke Cloud SQL.

Konsol

1. Di konsol Google Cloud, buka halaman IAM.

   Buka IAM

2. Untuk akun layanan yang bernama akun layanan default App Engine, klik ikon pensil.
   Catatan: Nama akun layanan akan muncul di samping akun utama. Nama akun utama adalah [e-mail].
3. Klik Add another role.
4. Tambahkan Peran bernama Klien Cloud SQL.
5. Klik Simpan.

gcloud

1. Jalankan perintah gcloud berikut untuk mendapatkan daftar akun layanan project Anda:

   gcloud iam service-accounts list

2. Salin EMAIL akun layanan App Engine.
3. Jalankan perintah berikut untuk menambahkan peran Klien Cloud SQL ke akun layanan App Engine:

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

Mengonfigurasi dan men-deploy aplikasi contoh Cloud SQL

Dengan instance, database, dan akun layanan Cloud SQL atas izin klien, Anda kini dapat mengonfigurasi dan men-deploy aplikasi sampel untuk terhubung ke instance Cloud SQL Anda.

IP Publik

Untuk jalur IP publik, lingkungan standar App Engine menyediakan enkripsi dan terhubung menggunakan Proxy Auth Cloud SQL melalui soket Unix.

Go

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.

   Buka Editor Cloud Shell

2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml.
6. Ganti placeholder untuk variabel lingkungan dalam file app.standard.yaml dengan nilai berikut:
• <PROJECT-ID> dengan ID project Anda.
• <INSTANCE-REGION> dengan us-central1.
• <INSTANCE-NAME> dengan ID instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• <YOUR_DB_USER_NAME> dengan quickstart-user.
• <YOUR_DB_PASSWORD> dengan sandi quickstart-user yang Anda buat di membuat pengguna.
• <YOUR_DB_NAME> dengan quickstart-db.
7. Pada command prompt Cloud Shell, di direktori golang-samples/cloudsql/postgres/database-sql, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy cmd/app/app.standard.yaml

8. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
9. Jika diminta dengan Do you want to continue?, masukkan Y.
10. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

11. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Java

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.

   Buka Editor Cloud Shell

2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml.
6. Ganti placeholder untuk variabel lingkungan dalam file appengine-web.xml dengan nilai berikut:
• my-project:region:instance dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• my-db-user dengan quickstart-user.
• my-db-password dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• my_db dengan quickstart-db.
7. Pada command prompt Cloud Shell, di direktori java-docs-samples/cloud-sql/postgres/servlet, jalankan perintah Apache Maven mvn clean package berikut untuk men-deploy aplikasi contoh ke Lingkungan standar App Engine.

mvn clean package appengine:deploy -DskipTests

8. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
9. Jika diminta dengan Do you want to continue?, masukkan Y.
10. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

11. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Node.js

1. Di Cloud Shell Editor, buka kode source aplikasi contoh.

   Buka Editor Cloud Shell

2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml.
6. Ganti placeholder untuk variabel lingkungan dalam app.standard.yaml file dengan nilai berikut:
• <MY-PROJECT> dengan ID project Anda.
• <INSTANCE-REGION> dengan us-central1.
• <INSTANCE-NAME> dengan ID instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• MY_DB_USER dengan quickstart-user.
• MY_DB_PASSWORD dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• MY_DATABASE dengan quickstart-db.
7. Pada command prompt Cloud Shell, di direktori nodejs-docs-samples/cloud-sql/postgres/knex, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy app.standard.yaml

8. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
9. Jika diminta dengan Do you want to continue?, masukkan Y.
10. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

11. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Python

1. Di Cloud Shell Editor, buka kode source aplikasi contoh.

   Buka Editor Cloud Shell

2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml.
6. Ganti placeholder untuk variabel lingkungan dalam file app.standard.yaml dengan nilai berikut:
• <PROJECT-ID> dengan ID project Anda.
• <INSTANCE-REGION> dengan us-central1.
• <INSTANCE-NAME> dengan ID instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• <YOUR_DB_USER_NAME> dengan quickstart-user.
• <YOUR_DB_PASSWORD> dengan sandi quickstart-user yang Anda buat di membuat pengguna.
• <YOUR_DB_NAME> dengan quickstart-db.
7. Pada command prompt Cloud Shell, di direktori python-docs-samples/cloud-sql/postgres/sqlalchemy, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy app.standard.yaml

8. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
9. Jika diminta dengan Do you want to continue?, masukkan Y.
10. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

11. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

IP Pribadi

Untuk jalur IP pribadi, aplikasi Anda terhubung langsung ke instance Anda melalui Akses VPC Serverless Metode ini menggunakan soket TCP untuk terhubung langsung ke instance Cloud SQL tanpa menggunakan Proxy Auth Cloud SQL.

Go

Membuat dan mendownload sertifikat klien dan server SSL

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

   Buka Instance Cloud SQL

2. Klik quickstart-instance untuk melihat halaman Ringkasan
3. Klik tab Koneksi.
4. Di bawah bagian Keamanan, klik Buat sertifikat klien.
5. Pada dialog Buat sertifikat klien, masukkan quickstart-key sebagai nama, lalu klik Buat.

6. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.

   Penting: Simpan kunci pribadi ini dengan aman. Jika kehilangan kunci ini, Anda harus membuat sertifikat klien baru.

Membuat Koneksi VPC Tanpa Server untuk koneksi ke instance melalui IP Pribadi

1. Di konsol Google Cloud, buka halaman Akses VPC tanpa server - Buat Konektor.

   Membuat konektor VPC Serverless

2. Masukkan quickstart-connector untuk Nama.
3. Pilih default dari menu drop-down Jaringan
4. Pilih Rentang IP custom dari menu drop-down Subnet
5. Masukkan 10.8.0.0 di kotak input rentang IP
6. Klik Buat untuk membuat konektor.

Mem-build aplikasi contoh dengan sertifikat SSL

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
   Buka Editor Cloud Shell
2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Upload file sertifikat SSL ke folder sertifikat.
   1. Dari menu navigasi Penjelajah di Editor Cloud Shell, buka folder golang-samples/cloudsql/postgres/database-sql/certs.
   2. Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
   3. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Setelah memilih tiga file sertifikat SSL, klik Open untuk menyelesaikan proses upload file ke Cloud Shell Editor.
6. Dari menu navigasi Explorer di Cloud Shell Editor, pahami dan buka file golang-samples/cloudsql/postgres/database-sql/cmd/app/app.standard.yaml.
7. Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:

runtime: go116

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 3306
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Lakukan penggantian variabel berikut:
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• INSTANCE_HOST dengan alamat IP Pribadi instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• PROJECT_ID dengan ID project Anda.
9. Pada command prompt Cloud Shell, di direktori golang-samples/cloudsql/postgres/database-sql, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy cmd/app/app.standard.yaml

10. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
11. Jika diminta dengan Do you want to continue?, masukkan Y.
12. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

13. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Java

Membuat serta mendownload sertifikat klien dan server SSL

Untuk pengguna Java, konektor sudah menyediakan koneksi yang aman sehingga proses pembuatan dan download server SSL dan sertifikat klien tidak diperlukan.

Membuat Koneksi VPC Tanpa Server untuk koneksi ke instance melalui IP Pribadi

1. Di konsol Google Cloud, buka halaman Akses VPC tanpa server - Buat Konektor.

   Membuat konektor VPC Serverless

2. Masukkan quickstart-connector untuk Nama.
3. Pilih default dari menu drop-down Jaringan
4. Pilih Rentang IP custom dari menu drop-down Subnet
5. Masukkan 10.8.0.0 di kotak input rentang IP
6. Klik Buat untuk membuat konektor.

Membangun Aplikasi Contoh

1. Di Cloud Shell Editor, buka kode source aplikasi contoh.
   Buka Editor Cloud Shell
2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Dari menu navigasi Explorer di Cloud Shell Editor, pahami dan buka file java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml.
6. Salin dan tempel kode berikut ke dalam file appengine-web.xml yang akan menggantikan konten file yang ada:

<runtime>java17</runtime>
  <env-variables>
    <env-var name="INSTANCE_CONNECTION_NAME" value="project-name:region-name:instance-name" />
    <env-var name="DB_PORT" value="5432" />
    <env-var name="DB_USER" value="quickstart-user" />
    <env-var name="DB_PASS" value="my-db-password" />
    <env-var name="DB_NAME" value="quickstart-db" />
  </env-variables>
<vpc-access-connector>
  <name>projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector</name>
  <egress-setting>all-traffic</egress-setting>
</vpc-access-connector>

7. Lakukan penggantian variabel berikut:
• project-name:region-name:instance-name dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• my-db-password dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• PROJECT_ID dengan project ID Anda.
8. Pada command prompt Cloud Shell, di direktori java-docs-samples/cloud-sql/postgres/servlet, jalankan perintah Apache Maven mvn clean package berikut untuk men-deploy aplikasi contoh ke Lingkungan standar App Engine.

mvn clean package appengine:deploy -DskipTests

9. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
10. Jika diminta dengan Do you want to continue?, masukkan Y.
11. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

12. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Node.js

Membuat serta mendownload sertifikat klien dan server SSL

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

   Buka Instance Cloud SQL

2. Klik quickstart-instance untuk melihat halaman Ringkasan
3. Klik tab Koneksi.
4. Di bawah bagian Keamanan, klik Buat sertifikat klien.
5. Pada dialog Buat sertifikat klien, masukkan quickstart-key sebagai nama, lalu klik Buat.

6. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.

   Penting: Simpan kunci pribadi ini dengan aman. Jika kehilangan kunci ini, Anda harus membuat sertifikat klien baru.

Membuat Koneksi VPC Tanpa Server untuk koneksi ke instance melalui IP Pribadi

1. Di konsol Google Cloud, buka halaman Akses VPC tanpa server - Buat Konektor.

   Membuat konektor VPC Serverless

2. Masukkan quickstart-connector untuk Nama.
3. Pilih default dari menu drop-down Jaringan
4. Pilih Rentang IP custom dari menu drop-down Subnet
5. Masukkan 10.8.0.0 di kotak input rentang IP
6. Klik Buat untuk membuat konektor.

Mem-build aplikasi contoh dengan sertifikat SSL

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
   Buka Editor Cloud Shell
2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Upload file sertifikat SSL ke folder sertifikat.
   1. Dari menu navigasi Penjelajah di Editor Cloud Shell, buka folder nodejs-docs-samples/cloud-sql/postgres/knex/certs.
   2. Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
   3. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Setelah memilih tiga file sertifikat SSL, klik Open untuk menyelesaikan proses upload file ke Cloud Shell Editor.
6. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file nodejs-docs-samples/cloud-sql/postgres/knex/app.standard.yaml.
7. Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:

runtime: nodejs16

env_variables:
  DB_USER: quickstart-user
  DB_PASS: MY_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Lakukan penggantian variabel berikut:
• MY_DB_PASSWORD dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• INSTANCE_HOST dengan alamat IP Pribadi instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• PROJECT_ID dengan ID project Anda.
9. Pada command prompt Cloud Shell, di direktori nodejs-docs-samples/cloud-sql/postgres/knex, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy app.standard.yaml

10. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
11. Jika diminta dengan Do you want to continue?, masukkan Y.
12. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

13. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Python

Membuat serta mendownload sertifikat klien dan server SSL

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

   Buka Instance Cloud SQL

2. Klik quickstart-instance untuk melihat halaman Ringkasan
3. Klik tab Koneksi.
4. Di bawah bagian Keamanan, klik Buat sertifikat klien.
5. Pada dialog Buat sertifikat klien, masukkan quickstart-key sebagai nama, lalu klik Buat.

6. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.

   Penting: Simpan kunci pribadi ini dengan aman. Jika kehilangan kunci ini, Anda harus membuat sertifikat klien baru.

Membuat Koneksi VPC Tanpa Server untuk koneksi ke instance melalui IP Pribadi

1. Di konsol Google Cloud, buka halaman Akses VPC tanpa server - Buat Konektor.

   Membuat konektor VPC Serverless

2. Masukkan quickstart-connector untuk Nama.
3. Pilih default dari menu drop-down Jaringan
4. Pilih Rentang IP custom dari menu drop-down Subnet
5. Masukkan 10.8.0.0 di kotak input rentang IP
6. Klik Buat untuk membuat konektor.

Mem-build aplikasi contoh dengan sertifikat SSL

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
   Buka Editor Cloud Shell
2. Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
3. Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:

   gcloud config set project YOUR-PROJECT-ID

   Catatan: Ganti YOUR-PROJECT-ID dengan project ID Anda.
4. Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
5. Upload file sertifikat SSL ke folder sertifikat.
   1. Dari menu navigasi Penjelajah di Editor Cloud Shell, buka folder python-docs-samples/cloud-sql/postgres/sqlalchemy/certs.
   2. Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
   3. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   4. Setelah memilih tiga file sertifikat SSL, klik Open untuk menyelesaikan proses upload file ke Cloud Shell Editor.
6. Dari menu navigasi Explorer di Cloud Shell Editor, arahkan ke dan buka file python-docs-samples/cloud-sql/postgres/sqlalchemy/app.standard.yaml.
7. Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:

runtime: python37
entrypoint: gunicorn -b :$PORT app:app

env_variables:
  DB_USER: quickstart-user
  DB_PASS: YOUR_DB_PASSWORD
  DB_NAME: quickstart-db
  DB_PORT: 5432
  INSTANCE_HOST: INSTANCE_HOST
  DB_ROOT_CERT: certs/server-ca.pem
  DB_CERT: certs/client-cert.pem
  DB_KEY: certs/client-key.pem
  PRIVATE_IP: TRUE

vpc_access_connector:
  name: projects/PROJECT_ID/locations/us-central1/connectors/quickstart-connector

8. Lakukan penggantian variabel berikut:
• YOUR_DB_PASSWORD dengan sandi quickstart-user yang Anda buat di Membuat pengguna.
• INSTANCE_HOST dengan alamat IP Pribadi instance Anda yang muncul di halaman instance Cloud SQL di konsol Google Cloud .
• PROJECT_ID dengan ID project Anda.
9. Pada command prompt Cloud Shell, di direktori python-docs-samples/cloud-sql/postgres/sqlalchemy, jalankan perintah gcloud app deploy berikut untuk men-deploy aplikasi contoh ke lingkungan standar App Engine.

gcloud app deploy app.standard.yaml

10. Jika diminta memilih region untuk membuat aplikasi, masukkan pilihan numerik untuk us-central.
11. Jika diminta dengan Do you want to continue?, masukkan Y.
12. Setelah perintah deploy selesai, jalankan perintah gcloud app browse:

gcloud app browse

13. Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan standar App Engine. Lingkungan ini terhubung ke Cloud SQL.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan di 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. Dengan menonaktifkan aplikasi, Anda akan menghentikannya menjalankan instance dan melayani permintaan. Jika aplikasi Anda memproses permintaan, aplikasi akan menyelesaikan permintaan tersebut sebelum dinonaktifkan.

Untuk menonaktifkan aplikasi App Engine dan mempertahankan datanya, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Setelan:

   Buka Setelan

2. Pada tab Setelan aplikasi, klik Nonaktifkan aplikasi.

3. Pada kolom ID aplikasi, masukkan ID aplikasi yang ingin dinonaktifkan, lalu klik Nonaktifkan.

Langkah-langkah pembersihan opsional

Jika tidak menggunakan peran klien Cloud SQL yang ditetapkan ke akun layanan Compute Engine, 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 tidak menggunakan API yang diaktifkan sebagai bagian dari panduan memulai ini, Anda dapat menonaktifkannya.

• API yang diaktifkan dalam panduan memulai ini:
  • Compute Engine API
  • Cloud SQL Admin API
  • Cloud Run API
  • Container Registry API
  • Cloud Build 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:

• Dari aplikasi yang berjalan di lingkungan standar App Engine
• Dari aplikasi yang berjalan di Compute Engine
• Dari aplikasi yang berjalan di GKE
• Dari Cloud Run Functions
• Dari Cloud Run