Panduan ini membandingkan pilihan Google Cloud terbaru dan asli untuk men-deploy fungsi. Halaman ini membantu pengguna yang sebelumnya membuat fungsi dengan Cloud Functions API dan bertransisi ke Cloud Run Admin API. Halaman ini menjelaskan perbedaan utama di beberapa area, seperti konsep, konfigurasi, deployment, serta pemicu dan percobaan ulang.
Perbandingan
Ada dua versi fungsi Cloud Run:
Fungsi Cloud Run, yang dapat dibuat dengan salah satu cara berikut:
- Cloud Run Admin API
(Direkomendasikan): Fungsi yang dibuat dengan API ini (misalnya, dengan menggunakan konsol Google Cloud,
gcloud run
, REST API, atau Terraform) akan di-deploy sebagai layanan di Cloud Run. - Cloud Functions v2 API: Fungsi yang dibuat dengan API ini (misalnya, dengan menggunakan
gcloud functions
, REST API, atau Terraform) dapat dikelola dengan Cloud Run Admin API serta Cloud Functions v2 API. Saat menggunakan API ini, Anda menentukan pemicu saat men-deploy fungsi. Pelajari cara melepaskan fungsi v2 API agar dapat dikelola secara eksklusif menggunakan lingkungan Cloud Run Admin API.
- Cloud Run Admin API
(Direkomendasikan): Fungsi yang dibuat dengan API ini (misalnya, dengan menggunakan konsol Google Cloud,
Cloud Run Functions (generasi ke-1), yang sebelumnya dikenal sebagai Cloud Functions (generasi ke-1), adalah versi asli fungsi dengan pemicu peristiwa dan kemampuan konfigurasi terbatas.
Dengan men-deploy fungsi langsung ke Cloud Run, fungsi Anda akan di-build secara otomatis sebagai container dan di-deploy sebagai layanan Cloud Run.
Konsep
Tabel berikut merangkum perbedaan konseptual untuk fungsi.
Cloud Run Functions | Cloud Run Functions (generasi ke-1) | |
---|---|---|
Nama produk sebelumnya | Cloud Functions (generasi ke-2) | Cloud Functions (generasi ke-1) |
Model resource | Fungsi adalah layanan Cloud Run yang di-deploy dari kode sumber | Fungsi di-deploy dari kode sumber |
Jenis terminologi fungsi |
|
|
URL HTTPS yang Ditetapkan | run.app Fungsi yang dibuat dengan Cloud Functions v2 API juga memiliki endpoint cloudfunctions.net . |
cloudfunctions.net |
Registry image | Hanya Artifact Registry | Artifact Registry atau Container Registry (tidak digunakan lagi) |
Peran IAM untuk deployment |
|
|
Infrastruktur internal | Cloud Run | Internal Google |
Model penetapan harga | Harga Cloud Run | Harga Cloud Run Functions (generasi ke-1) |
Konfigurasi
Cloud Run mem-build fungsi ke dalam container dan men-deploynya sebagai layanan. Saat men-deploy fungsi ke Cloud Run, Anda memiliki akses dan kontrol penuh atas perilaku fungsi. Misalnya, Anda dapat mengaktifkan VPC Langsung, mengonfigurasi GPU, menggunakan pemasangan volume, dan lainnya.
Tabel berikut merangkum perbedaan konfigurasi untuk fungsi:
Cloud Run Functions | Cloud Run Functions (generasi ke-1) | |
---|---|---|
Waktu tunggu permintaan |
|
|
Ukuran instance | RAM hingga 16 GiB dengan 4 vCPU | RAM hingga 8 GB dengan 2 vCPU |
Serentak | Hingga 1.000 permintaan serentak per instance fungsi | 1 permintaan serentak per instance fungsi |
Pemisahan traffic | Didukung | Tidak didukung |
Deployment
Mulai Agustus 2024, Anda dapat menggunakan Cloud Run untuk men-deploy dan mengelola fungsi yang dibuat dengan Cloud Functions v2 API. Akibat perubahan ini:
- Metadata fungsi seperti ID runtime dan konfigurasi build disimpan dalam definisi layanan Cloud Run.
- Anda dapat mengedit fungsi dengan aman menggunakan Cloud Run Admin API.
- Anda dapat mengandalkan definisi layanan Cloud Run sebagai sumber kebenaran untuk fungsi Anda.
Namun, perlu diperhatikan bahwa fungsi yang dibuat dengan Cloud Run Admin API tidak dapat diubah dengan Cloud Functions API.
Tabel berikut merangkum perbedaan dalam cara Anda membuat, men-deploy, mengedit, dan mengelola fungsi:
Cloud Run Functions | Cloud Run Functions (generasi ke-1) | |
---|---|---|
Konsol Google Cloud | Cloud Run | Cloud Run Functions (generasi ke-1) |
Cloud SDK |
|
|
REST API |
|
|
Terraform |
|
Pemicu dan percobaan ulang
Tabel berikut membandingkan pemicu dan percobaan ulang untuk fungsi:
Cloud Run Functions | Cloud Run Functions (generasi ke-1) | |
---|---|---|
Memicu dan memanggil fungsi | Untuk fungsi yang dibuat dengan Cloud Run Admin API, Anda
menentukan pemicu sebagai bagian dari deployment fungsi
di konsol Google Cloud atau setelah men-deploy fungsi saat menggunakan
gcloud CLI. Untuk fungsi yang dibuat dengan Cloud Functions v2 API, Anda menentukan pemicu sebagai bagian dari deployment fungsi. |
Anda menentukan pemicu sebagai bagian dari deployment fungsi. |
Jenis peristiwa | Dukungan untuk jenis peristiwa apa pun yang didukung oleh Eventarc, termasuk lebih dari 90 sumber peristiwa melalui Cloud Audit Logs. | Dukungan langsung untuk peristiwa dari 7 sumber. |
Upaya coba lagi | Untuk fungsi yang dibuat dengan Cloud Run Admin API, perbarui kebijakan percobaan ulang di Eventarc dan konfigurasikan topik dead-letter di Pub/Sub. Untuk fungsi yang dibuat dengan Cloud Functions v2 API, Anda menentukan percobaan ulang sebagai bagian dari deployment fungsi dengan flag --retry .
|
Anda menentukan percobaan ulang sebagai bagian dari deployment fungsi dengan flag --retry . |
Melepaskan fungsi
Fungsi yang dibuat menggunakan Cloud Functions v2 API (misalnya, dengan menggunakan gcloud functions
, REST API, atau Terraform) dapat dilepaskan dari lingkungan API yang ada. Setelah melepaskan fungsi, Anda hanya dapat mengelolanya menggunakan Cloud Run Admin API. Anda mungkin
ingin melakukannya jika beban kerja Anda harus tetap berada dalam
batas API run.googleapis.com
untuk
Workload Terjamin, atau untuk memastikan
bahwa beban kerja Anda menggunakan
SKU Cloud Run. Lihat artikel Mengelola fungsi dalam dokumentasi API Cloud Functions v2 untuk mempelajari lebih lanjut.
Langkah berikutnya
- Coba panduan memulai untuk men-deploy fungsi di Cloud Run.