Mengonfigurasi layanan Cloud Run

Di Application Design Center, Anda dapat mengonfigurasi layanan Cloud Run untuk menjalankan container stateless langsung di infrastruktur Google yang skalabel dan terkelola sepenuhnya. Anda dapat menyesuaikan layanan untuk koneksi komponen dan parameter konfigurasi tertentu. Parameter konfigurasi tercantum dalam modul Terraform terraform-google-cloud-run di GitHub.

Koneksi komponen

Tabel berikut mencakup komponen yang dapat Anda hubungkan ke layanan Cloud Run, serta update yang dihasilkan pada aplikasi Anda dan kode Terraform yang dihasilkan.

Komponen terhubung Update aplikasi Informasi latar belakang
Secret Manager
  • Layanan Cloud Run dapat mereferensikan data secret.
  • Kolom Secret Data Secret Manager direferensikan oleh kolom env_secret_vars Cloud Run.
  • Peran roles/secretmanager.secretAccessor diberikan ke akun layanan Cloud Run.
Mengonfigurasi secret untuk layanan

Service account

  • Layanan Cloud Run menggunakan akun layanan sebagai identitas layanan.
  • Peran roles/run.invoker diberikan ke akun layanan.
  • Email akun layanan dan informasi Identity and Access Management (IAM) ditambahkan ke variabel lingkungan Cloud Run.
Mengautentikasi service-to-service
AlloyDB untuk PostgreSQL
  • Layanan Cloud Run dapat terhubung ke instance AlloyDB.
  • Metadata resource AlloyDB ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/alloydb.admin diberikan ke akun layanan Cloud Run.
Terhubung dari Cloud Run
BigQuery
  • Layanan Cloud Run dapat berinteraksi dengan set data BigQuery.
  • Metadata resource BigQuery ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/bigquery.dataEditor diberikan ke akun layanan Cloud Run.
Ringkasan BigQuery

Bigtable

  • Layanan Cloud Run dapat menjalankan fungsi administratif pada instance Bigtable.
  • Informasi metadata resource Bigtable ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/bigtable.admin diberikan ke akun layanan Cloud Run.
Ringkasan Bigtable

Layanan Cloud Run lainnya

  • Layanan Cloud Run sumber dapat mengirim traffic ke layanan Cloud Run tujuan.
  • Layanan Cloud Run sumber berisi URI layanan Cloud Run tujuan dalam variabel lingkungannya.
Apa itu Cloud Run

Cloud SQL (MySQL)

  • Layanan Cloud Run dapat membaca dari dan menulis data ke instance Cloud SQL (MySQL).
  • Metadata koneksi Cloud SQL ditambahkan ke layanan Cloud Run.
  • Peran roles/cloudsql.instanceUser dan roles/cloudsql.client diberikan ke akun layanan Cloud Run.
  • Akun layanan Cloud Run ditambahkan sebagai pengguna IAM ke instance Cloud SQL.
Terhubung dari Cloud Run

Cloud SQL (PostgreSQL)

  • Layanan Cloud Run dapat membaca dari dan menulis data ke instance Cloud SQL (PostgreSQL).
  • Metadata koneksi Cloud SQL ditambahkan ke layanan Cloud Run.
  • Peran roles/cloudsql.instanceUser dan roles/cloudsql.client diberikan ke akun layanan Cloud Run.
  • Akun layanan Cloud Run ditambahkan sebagai pengguna IAM ke instance Cloud SQL.
Terhubung dari Cloud Run

Cloud Storage

  • Layanan Cloud Run dapat mengelola objek di bucket Cloud Storage.
  • Informasi IAM akun layanan Cloud Run ditambahkan ke bucket Cloud Storage.
  • Peran roles/storage.objectAdmin diberikan ke akun layanan Cloud Run.
Menghubungkan ke layanan Google Cloud

Backend Cloud Load Balancing global

  • Load balancer dapat mendistribusikan traffic masuk ke layanan Cloud Run.
  • Layanan Cloud Run ditambahkan sebagai endpoint backend dalam konfigurasi backend NEG serverless Cloud Load Balancing.
Menyiapkan Load Balancer Aplikasi eksternal global dengan Cloud Run

Memorystore for Redis

  • Layanan Cloud Run dapat meng-cache data di instance Memorystore for Redis.
  • Informasi koneksi Memorystore for Redis ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/redis.editor diberikan ke akun layanan Cloud Run.
Menghubungkan ke instance Redis dari layanan Cloud Run

Memorystore for Redis Cluster

  • Layanan Cloud Run dapat meng-cache data di instance Memorystore for Redis Cluster.
  • Informasi koneksi Memorystore for Redis Cluster ditambahkan ke variabel lingkungan Cloud Run.
  • App Design Center memberikan peran roles/redis.dbConnectionUser ke akun layanan Cloud Run.
Menghubungkan ke instance Memorystore for Redis Cluster

Memorystore for Valkey

  • Layanan Cloud Run dapat meng-cache data di instance Memorystore for Valkey.
  • App Design Center menambahkan informasi koneksi Memorystore for Valkey ke variabel lingkungan Cloud Run.
  • App Design Center memberikan peran roles/memorystore.dbConnectionUser ke akun layanan Cloud Run.
Menghubungkan ke instance Memorystore for Valkey

Pub/Sub

  • Layanan Cloud Run dapat menerima pesan atau memublikasikan ke topik Pub/Sub.
  • ID topik Pub/Sub ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/pubsub.publisher dan roles/pubsub.subscriber diberikan ke akun layanan Cloud Run.
  • Layanan Cloud Run ditambahkan ke kolom langganan push dan pull Pub/Sub.
Tutorial menggunakan Pub/Sub dengan Cloud Run

Backend Cloud Load Balancing regional

  • Load balancer dapat mendistribusikan traffic masuk ke layanan Cloud Run.
  • Layanan Cloud Run ditambahkan sebagai endpoint backend dalam konfigurasi backend NEG serverless Cloud Load Balancing.
Menyiapkan Load Balancer Aplikasi eksternal regional dengan Cloud Run

Frontend Cloud Load Balancing regional

  • Alamat IP HTTP dan HTTPS load balancer tersedia untuk aplikasi yang berjalan di container Cloud Run.
  • Metadata alamat Cloud Load Balancing ditambahkan ke variabel lingkungan Cloud Run.
Ringkasan aturan penerusan

Spanner

  • Layanan Cloud Run dapat mengelola instance Spanner.
  • Detail koneksi Spanner ditambahkan ke variabel lingkungan Cloud Run.
  • Peran roles/spanner.databaseAdmin diberikan ke akun layanan Cloud Run.
  • Informasi IAM akun layanan Cloud Run ditambahkan ke instance Spanner.
Menghubungkan ke layanan Google Cloud

Vertex AI

  • Layanan Cloud Run dapat berinteraksi dengan layanan Vertex AI.
  • Peran roles/aiplatform.user diberikan ke akun layanan Cloud Run.
Menghosting aplikasi dan agen AI di Cloud Run

Parameter konfigurasi yang diperlukan

Jika template Anda menyertakan komponen Cloud Run, Anda harus mengonfigurasi parameter berikut sebelum men-deploy.

Nama parameter Deskripsi dan batasan Informasi latar belakang

Project ID

Project tempat Anda ingin men-deploy resource Cloud Run.

Mengonfigurasi komponen

Region

Lokasi deployment layanan Cloud Run.

Lokasi Cloud Run

Nama Layanan

name Layanan Cloud Run

Parameter konfigurasi opsional

Parameter berikut bersifat opsional. Untuk menampilkan parameter lanjutan, di area Configuration, pilih Show advanced fields.

Fitur Nama parameter Informasi deskripsi dan batasan Informasi latar belakang
Container

Nama Penampung

name Membuat container
Container

Image Container

image Men-deploy image container ke Cloud Run
Container

Working Dir

Direktori kerja container. Jika tidak ditentukan, default runtime container akan digunakan, yang mungkin dikonfigurasi dalam image container.

workingDir
Container

Bergantung pada Penampung

dependsOn[] Mengonfigurasi urutan awal container untuk deployment file bantuan
Container

Argumen Container

args[] Mengonfigurasi container untuk layanan
Container

Perintah Penampung

perintah Mengonfigurasi container untuk layanan
Container: Env Var

Kunci

name Variabel lingkungan untuk layanan
Container: Env Var

Nilai

value Variabel lingkungan untuk layanan
Container: Variabel Secret Env

Kunci

EnvVarSource Membuat secret dapat diakses oleh Cloud Run
Container: Variabel Secret Env

Secret

secret Membuat secret dapat diakses oleh Cloud Run
Container: Variabel Secret Env

Version

version Membuat secret dapat diakses oleh Cloud Run
Container: Pemasangan Volume

Nama

name Terhubung dari Cloud Run
Container: Pemasangan Volume

Mount Path

mountPath Terhubung dari Cloud Run
Container: Port

Nama

name Menggunakan HTTP/2 untuk layanan
Container: Port

Port Container

containerPort Menggunakan HTTP/2 untuk layanan
Container: Resource

CPU

limits Mengonfigurasi batas CPU untuk layanan
Container: Resource

Memori

limits Mengonfigurasi batas memori untuk layanan
Container: Resource

CPU Tidak Ada Aktivitas

Apakah CPU hanya dialokasikan selama permintaan.

cpuIdle
Container: Resource

Penguatan CPU saat Startup

startupCPUBoost Menyetel penguatan CPU saat startup
Container: Pemeriksaan Startup

Batas Kegagalan

failureThreshold Mengonfigurasi health check container untuk layanan
Container: Pemeriksaan Startup

Detik Penundaan Awal

initialDelaySeconds Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Detik Waktu Tunggu

timeoutSeconds Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Detik Periode

periodSeconds Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

HTTP Get Path

path Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

HTTP Get Port

port Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Nama Header HTTP

name Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Nilai Header HTTP

value Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Port Soket TCP

port Pemeriksaan startup TCP default
Container: Pemeriksaan Startup

Port GRPC

port Mengonfigurasi pemeriksaan startup
Container: Pemeriksaan Startup

Layanan GRPC

service Mengonfigurasi pemeriksaan startup
Container

Pemeriksaan Keaktifan

livenessProbe Use cases

Deskripsi

description Menetapkan deskripsi layanan

Buat Akun Layanan

Buat akun layanan baru untuk layanan Cloud Run.

Mengonfigurasi identitas layanan untuk layanan

Peran Project Akun Layanan

Peran yang akan diberikan ke akun layanan yang baru dibuat. Aktifkan Create Service Account dan jangan berikan input untuk Service Account.

Mengonfigurasi identitas layanan untuk layanan

Ingress

IngressTraffic Membatasi ingress jaringan untuk Cloud Run

Anggota

Pengguna dan akun layanan yang dapat memanggil layanan. Untuk akses publik, masukkan allUsers. Untuk akses oleh pengguna Google yang login, masukkan allAuthenticatedUsers, atau masukkan daftar pengguna dan akun layanan tertentu. Untuk mengetahui informasi selengkapnya, lihat anggota.

Mengelola akses ke layanan
Akses VPC

Konektor

connector VPC dengan konektor
Akses VPC Egress egress Mengontrol traffic layanan egress
Akses VPC: Antarmuka Jaringan Network network Men-deploy layanan
Akses VPC: Antarmuka Jaringan Subnetwork subnetwork Men-deploy layanan
Akses VPC: Antarmuka Jaringan Tag tags Men-deploy layanan

Perlindungan dari Penghapusan Cloud Run

Mencegah Terraform menghancurkan atau membuat ulang tugas dan layanan Cloud Run.

deletion_protection

Mengaktifkan Sidecar Prometheus

Aktifkan file bantuan Prometheus di layanan Cloud Run.

Menulis metrik Prometheus menggunakan file bantuan Prometheus
Volume

Nama

name Mengonfigurasi volume dalam memori
Volume: Secret Secret secret Membuat secret dapat diakses oleh Cloud Run
Volume: Secret Mode Default defaultMode Membuat secret dapat diakses oleh Cloud Run
Volume: Secret Path path Membuat secret dapat diakses oleh Cloud Run
Volume: Secret Version version Membuat secret dapat diakses oleh Cloud Run
Volume: Secret Mode mode Membuat secret dapat diakses oleh Cloud Run
Volume: Instance Cloud SQL Instance instances[] Terhubung dari Cloud Run
Volume: Empty Dir Sedang medium Mengonfigurasi pemasangan volume dalam memori untuk layanan
Volume: Empty Dir Batas Ukuran sizeLimit Mengonfigurasi pemasangan volume dalam memori untuk layanan
Volume: GCS Bucket bucket Mengonfigurasi pemasangan volume Cloud Storage untuk layanan
Volume: GCS Read Only readOnly Mengonfigurasi pemasangan volume Cloud Storage untuk layanan
Volume: NFS Server server Mengonfigurasi pemasangan volume NFS untuk layanan
Volume: NFS Path path Mengonfigurasi pemasangan volume NFS untuk layanan
Volume: NFS Read Only readOnly Mengonfigurasi pemasangan volume NFS untuk layanan
Penskalaan Layanan

Jumlah Instance Minimum

minInstanceCount Menetapkan instance minimum untuk layanan

Revisi

revision Revisi layanan Cloud Run
Penskalaan Template

Jumlah Instance Minimum

minInstanceCount Menetapkan instance minimum untuk layanan
Penskalaan Template Jumlah Instance Maksimum maxInstanceCount Tentang instance maksimum

Kunci Enkripsi

encryptionKey Menggunakan kunci enkripsi yang dikelola pelanggan

Konkurensi Permintaan Instance Maksimum

maxInstanceRequestConcurrency Permintaan serentak maksimum untuk layanan

Afinitas Sesi

sessionAffinity Menetapkan afinitas sesi untuk layanan

Lingkungan Eksekusi

executionEnvironment Tentang lingkungan eksekusi layanan
Traffic

Jenis

jenis Rollback, peluncuran bertahap, dan migrasi traffic
Traffic Percent percent Rollback, peluncuran bertahap, dan migrasi traffic
Traffic Revisi revision Rollback, peluncuran bertahap, dan migrasi traffic
Traffic Tag tag Rollback, peluncuran bertahap, dan migrasi traffic
Label Layanan

Kunci

label Mengonfigurasi label untuk layanan
Label Layanan Nilai label Mengonfigurasi label untuk layanan
Anotasi Layanan

Kunci

anotasi anotasi
Anotasi Layanan Nilai anotasi anotasi
Klien

Nama

ID arbitrer untuk klien API.

klien
Klien Version

ID arbitrer untuk versi klien API.

clientVersion

Tahap Peluncuran

LaunchStage Tahap peluncuran produk

Audiens Kustom

customAudience Menetapkan audiens kustom untuk layanan
Otorisasi Biner

Justifikasi Akses Darurat

breakglassJustification Menggunakan akses darurat
Otorisasi Biner Gunakan Default useDefault Menggunakan Otorisasi Biner
Label Template

Kunci

label Mengonfigurasi label untuk layanan
Label Template Nilai label Mengonfigurasi label untuk layanan
Anotasi Template

Kunci

anotasi anotasi
Anotasi Template Nilai anotasi anotasi

Waktu tunggu

timeout Menetapkan waktu tunggu permintaan untuk layanan

Akun Layanan

serviceAccount Mengonfigurasi identitas layanan untuk layanan