Menghubungkan ke Cloud SQL untuk MySQL dari fungsi Cloud Run

Menghubungkan ke Cloud SQL untuk MySQL dari fungsi Cloud Run

MySQL   |  PostgreSQL   |  SQL Server

Pelajari cara men-deploy aplikasi contoh di fungsi Cloud Run yang terhubung ke instance MySQL menggunakan konsol Google Cloud dan aplikasi klien.

Dengan asumsi bahwa Anda menyelesaikan semua langkah secara tepat waktu, biaya resource yang dibuat dalam panduan memulai ini biasanya 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 contoh Cloud SQL di fungsi Cloud Run.

   Konsol

   Klik Aktifkan API untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.

   Aktifkan API

   Tindakan ini memungkinkan API berikut:

   • Cloud Run Functions API
   • Cloud SQL Admin API
   • Cloud Run Admin API
   • Cloud Build API
   • Artifact Registry API
   • API Eventarc
   • Compute Engine API
   • Service Networking 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 cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com

   Perintah ini mengaktifkan API berikut:

   • Cloud Run Functions API
   • Cloud SQL Admin API
   • Cloud Run API
   • Cloud Build API
   • Artifact Registry API
   • API Eventarc
   • Compute Engine API
   • Service Networking API
   • Cloud Logging API

7. Tambahkan peran IAM Cloud Run functions Invoker ke pengguna Anda.

   Menambahkan peran

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 Choose MySQL.
4. Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
5. Di kolom Instance ID masukkan quickstart-instance.
6. Di kolom Sandi, masukkan sandi untuk pengguna root. 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=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--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 Choose MySQL.
4. Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
5. Di kolom Instance ID masukkan quickstart-instance.
6. Di kolom Sandi, masukkan sandi untuk pengguna root. 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 Aktifkan SSL, klik Aktifkan dan mulai, 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=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--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 database.
1. Di kolom Nama database di kotak dialog Buat database, masukkan quickstart-db. Biarkan nilai untuk himpunan karakter dan kolasi.
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.
• Di halaman Tambahkan akun pengguna untuk quickstart-instance, tambahkan informasi berikut:
  • Di kolom Nama Pengguna, masukkan quickstart-user.
  • Di kolom Sandi, tentukan sandi untuk pengguna database Anda. Catat hal ini untuk digunakan di langkah selanjutnya dalam panduan memulai ini.
5. Klik Tambahkan.

gcloud

Sebelum menjalankan perintah berikut, buat pengganti berikut:

1. DB_PASS 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=DB_PASS

Batas panjang nama pengguna untuk Cloud SQL dan MySQL lokal; 32 karakter untuk MySQL 8.0 dan yang lebih baru, 16 karakter untuk versi sebelumnya.

Mengonfigurasi akun layanan fungsi Cloud Run

Konfigurasikan akun layanan yang digunakan oleh fungsi Cloud Run 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 bernama akun layanan default Compute Engine, klik ikon pensil.
Catatan: Nama akun layanan muncul di kolom Nama. Kolom ini berada di sebelah ID akun layanan (di kolom Utama). ID biasanya berupa alamat email.
3. Klik ADD ANOTHER ROLE.
4. Tambahkan Peran bernama Cloud SQL Client.
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 Compute Engine.
3. Jalankan perintah berikut untuk menambahkan peran Klien Cloud SQL ke akun layanan Compute Engine:

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

Membuat fungsi

1. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

2. Klik Create function.
3. Untuk Lingkungan, pilih generasi ke 2.
4. Di kolom Nama fungsi, masukkan quickstart-function.
5. Di region Autentikasi, pilih Izinkan pemanggilan yang tidak diautentikasi.
6. Klik Next.
7. Dari menu Runtime, pilih salah satu bahasa berikut ini:

Bahasa	Nomor versi
Go	1,20
Java	17
Node.js	18
Python	3,10

8. Pada menu Kode sumber, pastikan Editor inline dipilih. Pada langkah ini, Anda akan menggunakan fungsi default yang telah disediakan di editor.

Men-deploy cloud function

1. Di bagian bawah halaman fungsi Cloud Run, klik Deploy. Konsol Google Cloud akan mengalihkan Anda ke halaman detail fungsi.
2. Setelah deployment fungsi selesai, klik link URL untuk melihat browser web yang menampilkan pesan Hello, World!.

Men-deploy aplikasi contoh Cloud SQL sebagai fungsi

Anda mengonfigurasi dan men-deploy aplikasi contoh Cloud SQL sebagai fungsi di fungsi Cloud Run. Pertama, Anda menggunakan Cloud Shell untuk mengonfigurasi dan mem-build aplikasi contoh. Kemudian, Anda akan menggunakan fungsi Cloud Run untuk men-deploy aplikasi contoh tersebut.

Ada dua cara untuk mengonfigurasi, mem-build, dan men-deploy aplikasi, bergantung pada apakah Anda membuat instance Cloud SQL untuk MySQL dengan IP Publik atau IP Pribadi.

Mengonfigurasi aplikasi contoh Cloud SQL

IP Publik

Untuk jalur IP publik, fungsi Cloud Run 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. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

Java

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

   Buka Editor Cloud Shell
2. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah mvn sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
     -DskipTests -Djib.to.credHelper=gcloud

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

Node.js

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

   Buka Editor Cloud Shell
2. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

Python

1. Di Cloud Shell Editor, buka kode sumber aplikasi contoh.
   Buka Editor Cloud Shell
2. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

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 Create 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. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Upload file sertifikat SSL ke folder sertifikat.
   1. Klik kanan folder sertifikasi di Editor Cloud Shell dan pilih Upload File.
   2. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
6. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

7. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

8. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

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 Membuat untuk membuat konektor.

Mem-build aplikasi contoh

1. Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
   Buka Editor Cloud Shell
2. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Jika kotak dialog Izinkan Cloud Shell muncul, klik Izinkan.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah mvn sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql \
     -DskipTests -Djib.to.credHelper=gcloud

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

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. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Upload file sertifikat SSL ke folder sertifikat.
   1. Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
   2. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

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. Di 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, di bagian paruh bawah layar di bawah Editor Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda. Ganti YOUR_PROJECT_ID dengan project ID Anda.

   gcloud config set project YOUR_PROJECT_ID

4. Upload file sertifikat SSL ke folder sertifikat.
   1. Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
   2. Pilih file berikut di komputer lokal Anda:
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
5. Jalankan perintah gcloud artifacts repositories create berikut di Cloud Shell untuk membuat repositori di Artifact Registry yang bernama quickstart-repo di region yang sama dengan instance Cloud SQL Anda. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud artifacts repositories create quickstart-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=YOUR_REGION_NAME \
     --description="Cloud Function Quickstart Cloud SQL sample app"

6. Jalankan perintah gcloud builds submit sebagai berikut di Cloud Shell untuk mem-build container Docker dan memublikasikannya ke Artifact Registry. Ganti YOUR_PROJECT_ID dengan ID project Anda dan YOUR_REGION_NAME dengan nama region Anda.

   gcloud builds submit \
     --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/quickstart-repo/function-sql .

7. Pada gen2 fungsi Cloud Run, mengonfigurasi dan menjalankan Proxy Auth Cloud SQL secara otomatis tidak didukung. Fungsi ini didukung dengan menggunakan Cloud Run. Anda harus merevisi layanan Cloud Run yang mendasarinya secara manual untuk mengonfigurasi dan menjalankan Proxy Auth Cloud SQL beserta layanannya dengan menggunakan flag --add-cloudsql-instances. Ganti INSTANCE_CONNECTION_NAME dengan nama koneksi instance Anda.

   gcloud run deploy quickstart-function --source . \
     --region YOUR_REGION_NAME \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME

Men-deploy aplikasi contoh

Langkah-langkah untuk men-deploy contoh ke fungsi Cloud Run bergantung pada jenis alamat IP yang Anda tetapkan ke instance Cloud SQL.

IP Publik

Konsol

1. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

2. Pilih quickstart-function yang Anda buat pada langkah sebelumnya di panduan memulai ini.
3. Di halaman Detail fungsi, klik link di panel Didukung oleh Cloud Run untuk mengakses layanan fungsi Cloud Run yang mendasarinya.
4. Klik Edit & deploy revisi baru.
5. Di kolom Container image URL, klik Pilih.
1. Pilih tab Artifact Registry, lalu luaskan node quickstart-repo.
2. Luaskan container function-sql, lalu pilih image container yang Anda buat di langkah sebelumnya.
3. Klik Pilih.
6. Buat variabel lingkungan berikut dengan mengklik Tambahkan variabel di bagian Variabel lingkungan:
• INSTANCE_UNIX_SOCKET: Tetapkan ke /cloudsql/YOUR_PROJECT_ID:YOUR_REGION_NAME:quickstart-instance.
• DB_NAME: Tetapkan ke quickstart-db.
• DB_USER: Tetapkan ke quickstart-user.
• DB_PASS: Tetapkan ke sandi quickstart-user yang Anda tentukan pada langkah panduan memulai Membuat pengguna sebelumnya.

7. Aktifkan koneksi ke Cloud SQL:

   1. Di bagian Koneksi Cloud SQL, klik Tambahkan koneksi.
   2. Pilih nama koneksi instance Anda.
8. Di bagian bawah halaman, klik Deploy.
9. Setelah fungsi panduan memulai di-deploy, halaman Detail layanan akan menampilkan URL ke layanan yang sedang berjalan. Klik link URL untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL. Aplikasinya harus serupa dengan berikut ini:

   

gcloud

Go

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama region Anda

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Java

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama region Anda

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Node.js

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama region Anda

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Python

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama region Anda

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--set-env-vars INSTANCE_UNIX_SOCKET=/cloudsql/INSTANCE_CONNECTION_NAME \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

IP Pribadi

Konsol

1. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

2. Pilih quickstart-function yang Anda buat pada langkah sebelumnya di panduan memulai ini.
3. Di halaman Detail fungsi, klik link di panel Didukung oleh Cloud Run untuk mengakses layanan fungsi Cloud Run yang mendasarinya.
4. Klik Edit & deploy revisi baru.
5. Di kolom Container image URL, klik Pilih.
1. Pilih tab Artifact Registry, lalu luaskan node quickstart-repo.
2. Luaskan container function-sql, lalu pilih image container yang Anda buat di langkah sebelumnya.
3. Klik Pilih.
6. Buat variabel lingkungan berikut dengan mengklik Tambahkan variabel di bagian Variabel lingkungan:
• DB_NAME: Tetapkan ke quickstart-db.
• DB_USER: Tetapkan ke quickstart-user.
• DB_PASS: Setel ke sandi quickstart-user yang Anda tentukan di langkah panduan memulai Membuat pengguna yang sebelumnya.
• INSTANCE_CONNECTION_NAME: Tetapkan ke Nama Koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud.
• DB_PORT: Tetapkan ke 3306.
Catatan: Untuk pengguna Java, konektor sudah menyediakan koneksi yang aman sehingga variabel lingkungan INSTANCE_HOST, DB_ROOT_CERT, DB_CERT, DB_KEY, dan PRIVATE_IP tidak boleh ditetapkan.
• INSTANCE_HOST: Menetapkan alamat IP Pribadi dari instance Anda yang ditampilkan di halaman instance Cloud SQL di konsol Google Cloud.
• DB_ROOT_CERT: Tetapkan ke certs/server-ca.pem.
• DB_CERT: Tetapkan ke certs/client-cert.pem.
• DB_KEY: Tetapkan ke certs/client-key.pem.
• PRIVATE_IP: Tetapkan ke TRUE.

7. Aktifkan koneksi ke Cloud SQL:

   1. Di bagian Koneksi Cloud SQL, klik Tambahkan koneksi.
   2. Pilih nama koneksi instance Anda.
   3. Pilih default: Serverless VPC Access Connector "quickstart-connector" dari menu drop-down Jaringan VPC.
   4. Pilih opsi Rutekan semua traffic melalui konektor VPC.
8. Di bagian bawah halaman, klik Deploy.
9. Setelah fungsi panduan memulai di-deploy, halaman Detail layanan akan menampilkan URL ke layanan yang sedang berjalan. Klik link URL untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL. Aplikasinya harus serupa dengan berikut ini:

   

gcloud

Go

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama wilayah Anda
• PRIVATE_IP_ADDRESS dengan alamat IP pribadi instance Cloud SQL Anda ditampilkan di halaman instance Cloud SQL di Konsol Google Cloud
• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Pengguna Java harus menjalankan perintah gcloud functions deploy tanpa flag INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY, dan PRIVATE_IP, sebagai berikut, untuk membuat fungsi Cloud Run karena konektor Java sudah menyediakan koneksi yang aman:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime go120 \
--trigger-http \
--allow-unauthenticated \
--entry-point Votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Java

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama wilayah Anda
• PRIVATE_IP_ADDRESS dengan alamat IP pribadi instance Cloud SQL Anda ditampilkan di halaman instance Cloud SQL di Konsol Google Cloud
• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Pengguna Java harus menjalankan perintah gcloud functions deploy tanpa flag INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY, dan PRIVATE_IP, sebagai berikut, untuk membuat fungsi Cloud Run karena konektor Java sudah menyediakan koneksi yang aman:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime java11 \
--trigger-http \
--allow-unauthenticated \
--entry-point com.example.cloudsql.functions.Main \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Node.js

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama wilayah Anda
• PRIVATE_IP_ADDRESS dengan alamat IP pribadi instance Cloud SQL Anda ditampilkan di halaman instance Cloud SQL di Konsol Google Cloud
• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Pengguna Java harus menjalankan perintah gcloud functions deploy tanpa flag INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY, dan PRIVATE_IP, sebagai berikut, untuk membuat fungsi Cloud Run karena konektor Java sudah menyediakan koneksi yang aman:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime nodejs18 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

Python

1. Untuk men-deploy fungsi gen2 ke fungsi Cloud Run, jalankan perintah gcloud functions deploy berikut. Sebelum menjalankan perintah, perbarui variabel berikut:
• YOUR_REGION_NAME dengan nama wilayah Anda
• PRIVATE_IP_ADDRESS dengan alamat IP pribadi instance Cloud SQL Anda ditampilkan di halaman instance Cloud SQL di Konsol Google Cloud
• DB_PASS dengan sandi quickstart-user yang Anda buat di langkah panduan memulai Membuat pengguna sebelumnya

• INSTANCE_CONNECTION_NAME dengan Nama koneksi instance Anda yang muncul di halaman instance Cloud SQL di Konsol Google Cloud

Jalankan perintah gcloud functions deploy sebagai berikut untuk membuat fungsi Cloud Run:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars INSTANCE_HOST=PRIVATE_IP_ADDRESS \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_PORT=3306 \
--set-env-vars DB_ROOT_CERT=certs/server-ca.pem \
--set-env-vars DB_CERT=certs/client-cert.pem \
--set-env-vars DB_KEY=certs/client-key.pem \
--set-env-vars PRIVATE_IP=TRUE

Pengguna Java harus menjalankan perintah gcloud functions deploy tanpa flag INSTANCE_HOST, DB_PORT, DB_ROOT_CERT, DB_CERT, DB_KEY, dan PRIVATE_IP, sebagai berikut, untuk membuat fungsi Cloud Run karena konektor Java sudah menyediakan koneksi yang aman:

gcloud functions deploy quickstart-function \
--gen2 \
--runtime python310 \
--trigger-http \
--allow-unauthenticated \
--entry-point votes \
--region YOUR_REGION_NAME \
--vpc-connector=quickstart-connector \
--vpc-egress=all-traffic \
--set-env-vars DB_NAME=quickstart-db \
--set-env-vars DB_USER=quickstart-user \
--set-env-vars DB_PASS=DB_PASS \
--set-env-vars INSTANCE_CONNECTION_NAME=INSTANCE_CONNECTION_NAME \
--set-env-vars PRIVATE_IP=TRUE

2. Setelah Anda melihat pesan konfirmasi bahwa fungsi Cloud Run telah di-deploy, klik link Service URL di pesan untuk melihat aplikasi contoh fungsi Cloud Run yang di-deploy dan terhubung ke Cloud SQL.

   

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.

5. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

6. Pilih kotak centang di samping nama layanan quickstart-function.
7. Klik Hapus di bagian atas halaman fungsi Cloud Run.

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 MySQL dan database untuk instance Cloud SQL Anda.

Untuk informasi selengkapnya tentang harga, lihat harga Cloud SQL untuk MySQL.

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