Terhubung dari Cloud Run

Terhubung dari Cloud Run

Halaman ini memandu Anda melalui proses deployment aplikasi contoh di layanan Cloud Run menggunakan konsol Google Cloud dan aplikasi klien. Aplikasi contoh ini menghubungkan Cloud Run ke AlloyDB untuk PostgreSQL.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

6. Mengaktifkan Cloud API yang diperlukan untuk menjalankan aplikasi contoh AlloyDB untuk PostgreSQL di Cloud Run.

   Aktifkan API

   1. Pada langkah Konfirmasi project, klik Berikutnya untuk mengonfirmasi nama project yang akan Anda ubah.

   2. Pada langkah Aktifkan API, klik Aktifkan untuk mengaktifkan hal berikut:

      • AlloyDB API
      • Cloud Run Admin API
      • Compute Engine API
      • Cloud Build API
      • Container Registry API
      • Service Networking API
      • Cloud Resource Manager API

Membuat cluster dan instance utamanya

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Klik Buat kluster.

   Konsol Google Cloud akan menampilkan pilihan jenis cluster. Pilih Sangat tersedia.

3. Klik Lanjutkan.

   Bagian Konfigurasikan cluster Anda akan diperluas.

4. Di bagian Info dasar, di kolom Cluster ID, masukkan my-cluster.

5. Di kolom Password, masukkan sandi yang Anda inginkan. Catat sandi ini. Anda akan menggunakannya lagi nanti dalam panduan memulai ini.

6. Di kolom Region, pilih us-central1 (Iowa).

7. Di bagian Networking, pilih default.

   Jika Anda belum menyiapkan akses layanan pribadi, dialog berlabel Private service access connection required akan muncul.

   Dalam dialog Private service access connection required, untuk membuat koneksi akses layanan pribadi, selesaikan langkah-langkah berikut:

   1. Klik Siapkan koneksi.

      Panel baru berlabel Enable Service Networking API akan muncul.

   2. Di panel, pilih Use an automatically allocated IP range.

   3. Klik Lanjutkan.

   4. Klik Create connection, dan tunggu hingga konfigurasi koneksi selesai.

      Panel akan dihapus.

8. Klik Lanjutkan.

   Bagian Configure your primary instance akan diperluas.

9. Di bagian Info dasar, di kolom Instance ID, masukkan my-primary.

10. Untuk nilai Mesin, pilih 2 vCPU, 16 GB.

11. Klik Buat kluster.

    Tunggu hingga cluster selesai dibuat.

Menghubungkan ke instance dan membuat database

1. Jika Anda tidak berada di halaman Ringkasan cluster yang baru dibuat, buka halaman Cluster di konsol Google Cloud.

   Buka Cluster

2. Untuk menampilkan halaman Ringkasan cluster, klik nama cluster my-cluster.

3. Di menu navigasi, klik AlloyDB Studio.

4. Di daftar Database pada halaman Login ke AlloyDB Studio, pilih postgres.

5. Di menu drop-down Pengguna, pilih postgres.

6. Di kolom Password, masukkan sandi yang Anda buat di Membuat cluster dan instance utamanya.

7. Klik Autentikasi. Panel Explorer menampilkan daftar objek di database Anda.

8. Di tab Editor 1, buat database:

   CREATE DATABASE quickstart_db;
   

9. Klik Run. Tunggu hingga pesan Statement executed successfully ditampilkan di panel Results.

Menemukan project ID

1. Buka halaman Dasbor di konsol Google Cloud.

   Buka Dasbor

2. Temukan project ID di kartu Project info.

3. Catat project ID Anda. Anda memerlukannya untuk langkah berikutnya dalam quickstart ini.

Mengisi Artifact Registry dengan image aplikasi contoh

1. Di konsol Google Cloud, buka Cloud Shell.

   Buka Cloud Shell

2. Di Cloud Shell Editor, gunakan perintah berikut untuk meng-clone repositori dengan kode aplikasi contoh dari GitHub:

   cloudshell_open --repo_url \
   "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
   --dir \
   "examples/go" \
   --force_new_clone

3. Buat repositori di Artifact Registry untuk image docker:

   gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

   Ganti PROJECT_ID dengan ID project Anda.

4. Di dialog Authorize Cloud Shell, klik Authorize. Perintah ini tidak muncul jika Anda telah melakukan langkah ini sebelumnya.

5. Untuk mem-build container Docker dan memublikasikannya ke Artifact Registry, gunakan perintah berikut:

    gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

   Ganti PROJECT_ID dengan ID project Anda.

Menemukan alamat IP untuk instance baru

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Temukan baris dalam tabel yang Nama resource-nya adalah my-primary.

3. Catat Alamat IP pribadi baris tersebut. Anda memerlukannya untuk langkah berikutnya dalam quickstart ini.

   Contoh format alamat IP adalah 172.19.209.2:5432.

Membuat layanan untuk Cloud Run

1. Pada konsol Google Cloud, buka halaman Cloud Run.

   Buka Cloud Run

2. Di tab Services, klik Create Service.

3. Di kolom Container image URL, klik Pilih.

4. Di panel Select container image, selesaikan langkah-langkah berikut:

   1. Pilih tab Artifact registry.
   2. Luaskan us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy.
   3. Luaskan run-sql.
   4. Pilih gambar terbaru.
   5. Klik Pilih.

5. Di kolom Nama layanan, masukkan quickstart-service.

6. Pastikan us-central1 (Iowa) dipilih di daftar Region secara default.

7. Di bagian Autentikasi, pilih Izinkan pemanggilan tanpa autentikasi.

8. Pastikan CPU hanya dialokasikan selama pemrosesan permintaan dipilih di bagian Alokasi CPU dan harga.

9. Luaskan bagian Container(s), Volumes, Networking, Security.

10. Di tab Container, pilih tab Variables & secrets, lalu selesaikan langkah-langkah berikut:

    1. Di bagian Environment variables, klik Add variable.

    2. Masukkan kode berikut di kolom Name dan Value:

       • DB_NAME: quickstart_db
       • DB_USER: postgres
       • DB_PASS: Sandi yang Anda masukkan saat membuat cluster di Membuat cluster dan instance utamanya.
       • DB_PORT: 5432
       • INSTANCE_HOST: Alamat IP instance utama cluster Anda, yang Anda temukan di Menemukan alamat IP untuk instance baru. Jangan sertakan nomor port—misalnya, tetapkan ke 172.19.209.2, bukan 172.19.209.2:5432.

11. Beralih dari tab Container ke tab Networking dan selesaikan langkah-langkah berikut:

    1. Centang kotak Hubungkan ke VPC untuk traffic keluar.

    2. Pilih opsi Kirim traffic langsung ke VPC.

    3. Di menu drop-down Network, pilih nilai default.

    4. Di menu drop-down Subnet, pastikan nilai default dipilih.

12. Klik Buat untuk membuat layanan Cloud Run.

    Setelah layanan Cloud Run di-deploy, halaman layanan panduan memulai akan menampilkan URL aplikasi contoh di kolom URL.

    Aplikasi ini menggunakan AlloyDB sebagai datastore-nya.

Melihat aplikasi contoh

1. Pada konsol Google Cloud, buka halaman Cloud Run.

   Buka Cloud Run

2. Di halaman quickstart-service, klik Salin ke papan klip untuk menyalin URL aplikasi.

3. Di tab browser baru, tempel URL aplikasi yang disalin, lalu klik Enter.

   Contoh aplikasi web pengumpulan suara yang muncul terlihat mirip dengan berikut ini:

   

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan di halaman ini, ikuti langkah-langkah berikut.

Membersihkan cluster

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Di samping cluster my-cluster yang ingin Anda hapus, klik Tindakan, lalu klik Hapus.

3. Pada dialog Delete cluster yang muncul, ketik my-cluster di kolom my-cluster, yang mengonfirmasi bahwa Anda ingin menghapusnya.

4. Klik Delete.

Membersihkan layanan

1. Pada konsol Google Cloud, buka halaman Cloud Run.

   Buka Cloud Run

2. Pilih kotak centang di samping nama layanan quickstart-service.

3. Klik Delete di bagian atas halaman Cloud Run.

4. Pada dialog Delete quickstart-service yang muncul, klik Delete untuk mengonfirmasi.

Langkah selanjutnya

• Mengaktifkan akses project ke AlloyDB

• Memberikan akses AlloyDB kepada pengguna lain

• Mengaktifkan akses layanan pribadi

• Membuat cluster dan instance utamanya