Terhubung ke Cloud SQL untuk PostgreSQL dari Cloud Functions
Pelajari cara men-deploy aplikasi contoh di Cloud Functions yang terhubung ke instance PostgreSQL dengan 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
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan Cloud API yang diperlukan untuk menjalankan aplikasi contoh Cloud SQL di Cloud Functions.
Konsol
Klik Aktifkan API untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.
Tindakan ini memungkinkan API berikut:
- Cloud 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.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 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
Tambahkan peran IAM Cloud Functions Invoker ke pengguna Anda.
Menyiapkan Cloud SQL
Membuat instance Cloud SQL
Buat database
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih
quickstart-instance
. - Dari menu navigasi SQL, pilih Databases.
- Klik Buat Instance.
- Di kolom Nama Database di kotak dialog Database baru
, masukkan
quickstart-db
. - Klik Create.
gcloud
Jalankan perintah gcloud
sql databases create
untuk membuat database.
gcloud sql databases create quickstart-db --instance=quickstart-instance
Membuat pengguna
Konsol
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Untuk membuka halaman Ringkasan instance, klik nama instance.
- Dari menu navigasi SQL, pilih Pengguna.
- Klik Tambahkan pengguna akun.
- Di halaman Tambahkan pengguna akun 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.
- Di kolom Nama pengguna, masukkan
- Klik Tambahkan.
gcloud
Sebelum menjalankan perintah berikut, buat pengganti berikut:
- 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 sama seperti PostgreSQL lokal.
Mengonfigurasi akun layanan Cloud Functions
Konsol
-
Di konsol Google Cloud, buka halaman IAM.
- Untuk akun layanan bernama akun layanan default Compute Engine, klik ikon pensil.
- Klik ADD ANOTHER ROLE.
- Tambahkan Peran bernama Cloud SQL Client.
- Klik Simpan.
gcloud
-
Jalankan perintah
gcloud
berikut untuk mendapatkan daftar akun layanan project Anda:gcloud iam service-accounts list
- Salin EMAIL akun layanan Compute Engine.
- 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
-
Di konsol Google Cloud, buka halaman Cloud Function.
- Klik Buat fungsi.
- Untuk Lingkungan, pilih generasi ke 2.
- Di kolom Nama fungsi, masukkan
quickstart-function
. - Di region Autentikasi, pilih Izinkan pemanggilan yang tidak diautentikasi.
- Klik Next.
- Dari menu Runtime, pilih salah satu bahasa berikut ini:
- Pada menu Kode sumber, pastikan Editor inline dipilih. Pada langkah ini, Anda akan menggunakan fungsi default yang telah disediakan di editor.
Pemodelan bahasa | Nomor versi |
---|---|
Go | 1,20 |
Java | 17 |
Node.js | 18 |
Python | 3.10 |
Men-deploy fungsi
- Di bagian bawah halaman Cloud Functions, klik Deploy. Konsol Google Cloud akan mengalihkan Anda ke halaman detail fungsi.
- Setelah deployment fungsi selesai, klik link URL untuk melihat
browser web yang menampilkan pesan
Hello, World!
.
Men-deploy aplikasi contoh Cloud SQL sebagai sebuah fungsi
Anda mengonfigurasi dan men-deploy aplikasi contoh Cloud SQL sebagai fungsi di Cloud Functions. Pertama, Anda menggunakan Cloud Shell untuk mengonfigurasi dan mem-build aplikasi contoh. Kemudian, Anda akan menggunakan Cloud Functions untuk men-deploy aplikasi contoh.
Ada dua cara untuk mengonfigurasi, mem-build, dan men-deploy aplikasi, bergantung pada apakah Anda membuat instance Cloud SQL untuk PostgreSQL dengan IP Publik atau IP Pribadi.
Mengonfigurasi aplikasi contoh Cloud SQL
Men-deploy aplikasi sampel
Langkah-langkah untuk men-deploy sampel ke Cloud Functions bergantung pada jenis alamat IP yang Anda tetapkan ke instance Cloud SQL Anda.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance
quickstart-instance
untuk membuka halaman Detail instance. - Pada panel ikon di bagian atas halaman, klik Hapus.
- Di kotak dialog Hapus instance, ketik
quickstart-instance
, lalu klik Hapus untuk menghapus instance. -
Di konsol Google Cloud, buka halaman Cloud Function.
- Pilih kotak centang di samping nama layanan
quickstart-function
. - Klik Hapus di bagian atas halaman Cloud Functions.
Langkah-langkah pembersihan opsional
Jika tidak menggunakan peran klien Cloud SQL yang ditetapkan ke akun layanan Compute Engine, Anda dapat menghapusnya.
-
Di Konsol Google Cloud, buka halaman IAM.
- Klik ikon edit (yang terlihat seperti pensil) untuk akun IAM yang bernama akun layanan default Compute Engine default.
- Hapus peran Klien Cloud SQL client.
- Klik Simpan.
Jika 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
Di konsol Google Cloud, buka halaman APIs.
Pilih API yang ingin Anda nonaktifkan, lalu klik tombol Nonaktifkan API.
Langkah selanjutnya
Berdasarkan kebutuhan, Anda dapat mempelajari lebih lanjut cara membuat instance Cloud SQL.Anda juga dapat mempelajari cara membuat pengguna PostgreSQL dan database untuk instance Cloud SQL.
Untuk mengetahui informasi selengkapnya tentang harga, lihat harga Cloud SQL untuk PostgreSQL.
Pelajari lebih lanjut:
- Mengonfigurasi instance Cloud SQL Anda dengan alamat IP publik.
- Mengonfigurasi instance Cloud SQL Anda dengan alamat IP pribadi.
Selain itu, Anda dapat mempelajari cara menghubungkan ke instance Cloud SQL dari aplikasi Google Cloud lainnya: