Terhubung dari Cloud Run

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Aktifkan Cloud API yang diperlukan untuk menjalankan aplikasi contoh AlloyDB for PostgreSQL di Cloud Run.

   Aktifkan API

   1. Pada langkah Confirm project, untuk mengonfirmasi nama project yang akan Anda ubah, klik Next.

   2. Pada langkah Enable APIs, klik Enable untuk mengaktifkan berikut ini:

      • 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 menampilkan pilihan jenis cluster. Pilih Sangat tersedia.

3. Klik Lanjutkan.

   Bagian Konfigurasi cluster Anda akan meluas.

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 Connectivity, pada drop-down Network, pilih default.

   Jika Anda belum menyiapkan akses layanan pribadi, dialog berlabel Koneksi akses layanan pribadi diperlukan akan muncul.

   Dalam dialog Private services 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 dihapus.

8. Klik Lanjutkan.

   Bagian Konfigurasi instance utama Anda akan diperluas.

9. Di bagian Info dasar, pada kolom ID instance, 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 di 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 Dashboard 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 panduan memulai ini.

Isi 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 Anda

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 panduan memulai ini.

   Contoh format alamat IP adalah 172.19.209.2:5432.

Membuat layanan untuk Cloud Run

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

   Buka Cloud Run

2. Di tab Services, klik Deploy Container.

3. Di halaman Create service, pilih opsi Deploy one revision from an existing container image.

4. Di kolom Container image URL, klik Pilih.

5. 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.

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

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

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

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

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

11. Di tab Container(s), pilih tab Variables & secrets dan selesaikan langkah-langkah berikut:

    1. Di bagian Environment variables, klik Add variable.

    2. Masukkan hal 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 Anda. Jangan sertakan nomor port—misalnya, setel ke 172.19.209.2, bukan 172.19.209.2:5432.

12. Beralih dari tab Container(s) 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.

13. Klik Buat untuk membuat layanan Cloud Run.

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

    Aplikasi ini menggunakan AlloyDB sebagai datastore-nya.

Melihat aplikasi contoh

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

   Buka Cloud Run

2. Di halaman quickstart-service, klik content_copy Copy to clipboard untuk menyalin URL aplikasi.

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

   Aplikasi web pengumpul suara contoh yang muncul akan terlihat mirip dengan berikut ini:

   

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada 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 more_vert Tindakan, lalu klik delete Hapus.

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

4. Klik Hapus.

Membersihkan layanan

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

   Buka Cloud Run

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

3. Klik delete Hapus di bagian atas halaman Cloud Run.

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

Langkah berikutnya

• Mengaktifkan akses project ke AlloyDB

• Memberikan akses AlloyDB kepada pengguna lain

• Mengaktifkan akses layanan pribadi

• Buat cluster dan instance utamanya