Terhubung ke Cloud SQL untuk PostgreSQL dari lingkungan fleksibel App Engine
Pelajari cara men-deploy aplikasi contoh di lingkungan fleksibel App Engine yang terhubung ke instance PostgreSQL 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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Mengaktifkan Cloud API yang diperlukan untuk menjalankan aplikasi contoh Cloud SQL pada lingkungan fleksibel App Engine.
Klik tombol di bawah untuk mengaktifkan API yang diperlukan untuk panduan memulai ini.
Tindakan ini memungkinkan API berikut:
- Cloud SQL Admin API
- Compute Engine API
- Cloud Build API
- Cloud Logging API
Dengan mengklik tombol tersebut, Anda juga mengaktifkan Lingkungan Fleksibel Google App Engine.
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 appengineflex.googleapis.com 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
Dengan menjalankan perintah di atas, Anda juga mengaktifkan Lingkungan Fleksibel Google App Engine.
Menyiapkan Cloud SQL
Membuat instance Cloud SQL
IP Publik
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik Buat instance.
- Klik Pilih PostgreSQL.
- Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
- Di kolom Instance ID masukkan
quickstart-instance
. - Pada kolom Password, masukkan sandi untuk pengguna postgres. Simpan sandi ini untuk penggunaan berikutnya.
- Di bagian Pilih region dan ketersediaan zonal, pilih Zona tunggal.
- Klik menu Tampilkan opsi konfigurasi.
- Luaskan node Machine configuration.
- Dari region Machine shapes, pilih bentuk 4 vCPU, 32 GB.
- Klik Buat instance lalu tunggu hingga instance melakukan inisialisasi dan dimulai.
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 createquickstart-instance \ --database-version=POSTGRES_14 \ --cpu=1 \ --memory=4GB \ --region=us-central \ --root-password=DB_ROOT_PASSWORD
IP Pribadi
Mengalokasikan rentang alamat IP dan membuat koneksi pribadi guna mengonfigurasi akses layanan pribadi untuk Cloud SQL
-
Di konsol Google Cloud, buka halaman jaringan VPC.
- Pilih jaringan VPC
default
- Pilih tab Private service connection.
- Pilih tab Rentang IP yang dialokasikan untuk layanan.
- Klik Alokasikan rentang IP.
- Untuk Nama rentang yang dialokasikan, tentukan
google-managed-services-default
. - Pilih opsi Otomatis untuk rentang IP dan tentukan panjang awalan sebagai
16
. - Klik Alokasikan untuk membuat rentang yang dialokasikan.
- Pilih tab Koneksi pribadi pada layanan untuk jaringan VPC
default
. - Klik Buat koneksi untuk membuat koneksi pribadi antara jaringan Anda dan produsen layanan.
- Untuk Alokasi yang ditetapkan, pilih
google-managed-services-default
. - Klik Hubungkan untuk membuat koneksi.
Membuat instance dengan alamat IP pribadi dan SSL diaktifkan
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik Buat instance.
- Klik Pilih PostgreSQL.
- Pastikan Enterprise Plus dipilih sebagai edisi Cloud SQL untuk instance Anda.
- Di kolom Instance ID masukkan
quickstart-instance
. - Pada kolom Password, masukkan sandi untuk pengguna postgres. Simpan sandi ini untuk penggunaan berikutnya.
- Di bagian Pilih region dan ketersediaan zonal, pilih Zona tunggal.
- Klik menu Tampilkan opsi konfigurasi.
- Luaskan node Machine configuration.
- Dari region Machine shapes, pilih bentuk 4 vCPU, 32 GB.
- Luaskan node Connections.
- Hapus centang pada kotak IP Publik untuk membuat instance hanya dengan alamat IP pribadi.
- Centang kotak IP Pribadi.
- Dari menu Network, pilih default.
- Klik Buat instance, lalu tunggu hingga instance diinisialisasi dan dimulai.
- Klik Koneksi.
- Di bagian Keamanan, pilih Hanya izinkan koneksi SSL untuk mengaktifkan koneksi SSL.
- Pada dialog Hanya izinkan koneksi SSL, klik Simpan, lalu tunggu hingga instance dimulai ulang.
Mengalokasikan rentang alamat IP dan membuat koneksi pribadi guna mengonfigurasi akses layanan pribadi untuk Cloud SQL
-
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 -
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
-
Sebelum menjalankan perintah berikut ini, ganti DB_ROOT_PASSWORD dengan sandi pengguna database Anda.
- --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 patch
untuk mengaktifkan hanya izinkan koneksi SSL untuk instance.
Atau, ubah nilai untuk parameter berikut:
Jalankan perintah gcloud
sql instances create
untuk membuat instance Cloud SQL dengan alamat IP Pribadi.
gcloud sql instances createquickstart-instance \ --database-version=POSTGRES_14 \ --cpu=1 \ --memory=4GB \ --region=us-central \ --root-password=DB_ROOT_PASSWORD \ --no-assign-ip \ --network=default
gcloud sql instances patchquickstart-instance --require-ssl
Buat database
-
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 Buat.
Jalankan perintah gcloud
sql databases create
untuk membuat database.
gcloud sql databases createquickstart-db --instance=quickstart-instance
Membuat pengguna
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Pilih instance PostgreSQL instance panduan memulai yang telah Anda buat.
- Dari menu navigasi SQL, pilih Pengguna.
- Klik Tambahkan akun pengguna.
- Pada halaman Tambahkan akun pengguna ke instance panduan memulai,
tambahkan informasi berikut:
- Pada kolom Nama pengguna, masukkan
quickstart-user
. - Pada kolom Sandi, tetapkan sandi untuk pengguna database Anda. Catat sandi ini untuk digunakan pada langkah selanjutnya dalam panduan memulai ini.
- Pada kolom Nama pengguna, masukkan
- Klik Tambahkan.
Sebelum menjalankan perintah berikut, buat pengganti berikut:
- PASSWORD dengan sandi untuk pengguna database Anda. Catat hal ini untuk digunakan di langkah selanjutnya dalam panduan memulai ini.
Jalankan perintah gcloud sql users create
untuk membuat pengguna.
gcloud sql users createquickstart-user \ --instance=quickstart-instance \ --password=PASSWORD
Batas panjang nama pengguna untuk Cloud SQL sama seperti PostgreSQL lokal.
Men-deploy aplikasi contoh ke lingkungan fleksibel App Engine
Membuat aplikasi App Engine
-
Pada konsol Google Cloud, buka halaman App Engine.
- Klik Create application.
- Dari menu drop-down Pilih region, pilih us-central.
- Klik Next.
- Setelah halaman Mulai muncul, scroll ke bagian bawah halaman.
- Klik link Saya akan melakukannya nanti.
-
Jalankan perintah
gcloud app create
berikut untuk membuat aplikasi App Engine: - Saat diminta memilih region tempat Anda ingin menjalankan aplikasi App Engine, masukkan pilihan numerik untuk us-central.
gcloud app create
Mengonfigurasi akun layanan App Engine
-
Di konsol Google Cloud, buka halaman IAM.
- Untuk akun layanan yang bernama akun layanan default App Engine, klik ikon pensil.
- Klik Add another role.
- Tambahkan Peran bernama Klien Cloud SQL.
- Klik Simpan.
-
Jalankan perintah
gcloud
berikut untuk mendapatkan daftar akun layanan project Anda:gcloud iam service-accounts list
- Salin EMAIL akun layanan App Engine.
- 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 untuk Cloud SQL
Setelah Anda membuat instance dan database Cloud SQL, serta mengonfigurasi akun layanan App Engine agar memiliki izin untuk terhubung ke Cloud SQL, Anda dapat mengonfigurasi dan men-deploy aplikasi contoh untuk terhubung ke Cloud SQL instance.
IP Publik
Untuk jalur IP publik, lingkungan fleksibel App Engine menyediakan enkripsi. Metode ini menggunakan soket Unix dan Proxy Auth Cloud SQL untuk terhubung ke instance Cloud SQL Anda.-
Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
Buka Editor Cloud Shell - Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml
. -
Ganti placeholder untuk variabel lingkungan dalam file
app.flexible.yaml
dengan nilai berikut: - <PROJECT-ID> dengan ID project Anda.
- <INSTANCE-REGION> dengan
us-central1
. - <INSTANCE-NAME> dengan
quickstart-instance
. - <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
. - Pada command prompt Cloud Shell, di
direktori
cloudshell_open/golang-samples/cloudsql/postgres/database-sql
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
gcloud app deploy app.flexible.yaml
gcloud app browse
-
Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
Buka Editor Cloud Shell - Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml
. -
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
. - Pada command prompt Cloud Shell, di
direktori
cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet
, jalankan perintah Apache Mavenmvn clean package
berikut untuk men-deploy aplikasi contoh ke Lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
mvn clean package appengine:deploy -DskipTests
gcloud app browse
-
Di Cloud Shell Editor, buka kode source aplikasi contoh.
Buka Editor Cloud Shell - Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml
. -
Ganti placeholder untuk variabel lingkungan dalam file
app.flexible.yaml
dengan nilai berikut: - <MY-PROJECT> dengan ID project Anda.
- <INSTANCE-REGION> dengan
us-central1
. - <INSTANCE-NAME> dengan
quickstart-instance
. - MY_DB_USER dengan
quickstart-user
. - MY_DB_PASSWORD dengan sandi
quickstart-user
yang Anda buat di Membuat pengguna. - MY_DATABASE dengan
quickstart-db
. - Pada command prompt Cloud Shell, di
direktori
cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
gcloud app deploy app.flexible.yaml
gcloud app browse
-
Di Cloud Shell Editor, buka kode source aplikasi contoh.
Buka Editor Cloud Shell - Pada kotak dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Editor Cloud Shell.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika kotak dialog Otorisasi Cloud Shell muncul, klik Otorisasi.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml
. -
Ganti placeholder untuk variabel lingkungan dalam file
app.flexible.yaml
dengan nilai berikut: - <PROJECT-ID> dengan ID project Anda.
- <INSTANCE-REGION> dengan
us-central1
. - <INSTANCE-NAME> dengan
quickstart-instance
. - <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
. - Pada command prompt Cloud Shell, di
direktori
cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
gcloud app deploy app.flexible.yaml
gcloud app browse
IP Pribadi
Untuk jalur IP pribadi, pastikan VM lingkungan fleksibel App Engine dan instance Cloud SQL Anda dihosting di jaringan Virtual Private Cloud (VPC) yang sama. Jika berada di jaringan VPC yang sama, aplikasi lingkungan fleksibel App Engine Anda dapat terhubung langsung ke instance Cloud SQL tanpa menggunakan Proxy Auth Cloud SQL.Membuat dan mendownload sertifikat klien dan server SSL
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik
quickstart-instance
untuk melihat halaman Ringkasan - Klik tab Koneksi.
- Di bawah bagian Keamanan, klik Buat sertifikat klien.
- Pada dialog Buat sertifikat klien,
masukkan
quickstart-key
sebagai nama, lalu klik Buat. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.
Membangun aplikasi contoh dengan sertifikat SSL
-
Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
Buka Cloud Shell Editor - Pada dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Cloud Shell Editor.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika dialog Izinkan Cloud Shell muncul, klik Izinkan.
-
Upload file sertifikat SSL ke folder sertifikat.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
golang-samples/cloudsql/postgres/database-sql/certs
. - Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
- Pilih file berikut di komputer lokal Anda:
client-key.pem
client-cert.pem
server-ca.pem
- Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/golang-samples/cloudsql/postgres/database-sql/app.flexible.yaml
. - Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:
- 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.
- Pada command prompt Cloud Shell, di
direktori
cloudshell_open/golang-samples/cloudsql/postgres/database-sql
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
runtime: custom env: flex 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
gcloud app deploy app.flexible.yaml
gcloud app browse
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.
Membangun Aplikasi Contoh
-
Di Cloud Shell Editor, buka kode source aplikasi contoh.
Buka Cloud Shell Editor - Pada dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Cloud Shell Editor.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika dialog Izinkan Cloud Shell muncul, klik Izinkan.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet/src/main/webapp/WEB-INF/appengine-web.xml
. -
Salin dan tempel kode berikut ke dalam file
appengine-web.xml
yang akan menggantikan konten file yang ada: - 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 ID project Anda.
- Pada command prompt Cloud Shell, di
direktori
cloudshell_open/java-docs-samples/cloud-sql/postgres/servlet
, jalankan perintah Apache Mavenmvn clean package
berikut untuk men-deploy aplikasi contoh ke Lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
<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>
mvn clean package appengine:deploy -DskipTests
gcloud app browse
Membuat serta mendownload sertifikat klien dan server SSL
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik
quickstart-instance
untuk melihat halaman Ringkasan - Klik tab Koneksi.
- Di bawah bagian Keamanan, klik Buat sertifikat klien.
- Pada dialog Buat sertifikat klien,
masukkan
quickstart-key
sebagai nama, lalu klik Buat. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.
Membangun aplikasi contoh dengan sertifikat SSL
-
Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
Buka Cloud Shell Editor - Pada dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Cloud Shell Editor.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika dialog Izinkan Cloud Shell muncul, klik Izinkan.
-
Upload file sertifikat SSL ke folder sertifikat.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
nodejs-docs-samples/cloud-sql/postgres/knex/certs
. - Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
- Pilih file berikut di komputer lokal Anda:
client-key.pem
client-cert.pem
server-ca.pem
- Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex/app.flexible.yaml
. - Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:
- 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.
- Pada command prompt Cloud Shell, di
direktori
cloudshell_open/nodejs-docs-samples/cloud-sql/postgres/knex
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
runtime: nodejs env: flex 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
gcloud app deploy app.flexible.yaml
gcloud app browse
Membuat serta mendownload sertifikat klien dan server SSL
-
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
- Klik
quickstart-instance
untuk melihat halaman Ringkasan - Klik tab Koneksi.
- Di bawah bagian Keamanan, klik Buat sertifikat klien.
- Pada dialog Buat sertifikat klien,
masukkan
quickstart-key
sebagai nama, lalu klik Buat. Pada dialog Sertifikat SSL baru telah dibuat, klik setiap link download untuk mendownload sertifikat. Selanjutnya, klik Tutup.
Membangun aplikasi contoh dengan sertifikat SSL
-
Di Editor Cloud Shell, buka kode sumber aplikasi contoh.
Buka Cloud Shell Editor - Pada dialog Buka di Cloud Shell, klik Konfirmasi untuk mendownload kode aplikasi contoh dan membuka direktori aplikasi contoh di Cloud Shell Editor.
- Pada command prompt Cloud Shell, jalankan perintah berikut untuk mengaktifkan project Anda:
gcloud config set project
YOUR-PROJECT-ID - Jika dialog Izinkan Cloud Shell muncul, klik Izinkan.
-
Upload file sertifikat SSL ke folder sertifikat.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
python-docs-samples/cloud-sql/postgres/sqlalchemy/certs
. - Klik kanan folder sertifikat di Editor Cloud Shell dan pilih Upload File
- Pilih file berikut di komputer lokal Anda:
client-key.pem
client-cert.pem
server-ca.pem
- Setelah memilih tiga file sertifikat SSL, klik Buka untuk menyelesaikan proses upload file ke Editor Cloud Shell.
- Dari menu navigasi Penjelajah di Editor Cloud Shell, buka
folder
- Dari menu navigasi Penjelajah di Editor Cloud Shell, klik node yang dapat diperluas yang merupakan nama pengguna akun Google Cloud Anda.
- Pilih dan buka file
cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy/app.flexible.yaml
. - Salin dan tempel kode berikut ke dalam file, yang akan menggantikan konten file yang sudah ada:
- 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.
- Pada command prompt Cloud Shell, di
direktori
cloudshell_open/python-docs-samples/cloud-sql/postgres/sqlalchemy
, jalankan perintahgcloud app deploy
berikut untuk men-deploy aplikasi contoh ke lingkungan fleksibel App Engine. - Saat muncul dialog Ingin melanjutkan?, masukkan
Y
. - Setelah tindakan yang dilakukan dengan menjalankan perintah
gcloud app deploy
selesai, jalankan perintahgcloud app browse
: - Klik link yang dihasilkan untuk melihat aplikasi contoh yang berjalan di lingkungan fleksibel App Engine. Lingkungan ini terhubung ke Cloud SQL.
runtime: custom env: flex entrypoint: gunicorn -b :$PORT app:appentrypoint: 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
gcloud app deploy app.flexible.yaml
gcloud app browse
Pembersihan
Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan di 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. 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:
Di konsol Google Cloud, buka halaman Setelan:
Pada tab Setelan aplikasi, klik Nonaktifkan aplikasi.
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.
-
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 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 produk Google Cloud lainnya: