Men-deploy ke fungsi Cloud Run

Halaman ini menjelaskan cara men-deploy aplikasi ke Cloud Run Functions menggunakan Cloud Build. Jika Anda baru menggunakan Cloud Build, baca panduan memulai dan Ringkasan konfigurasi build terlebih dahulu.

Cloud Run Functions adalah lingkungan eksekusi serverless untuk membangun dan menghubungkan layanan cloud. Dengan Cloud Run Functions, Anda dapat menulis fungsi dengan tujuan tunggal yang terlampir ke peristiwa yang dikeluarkan dari layanan dan infrastruktur cloud Anda. Fungsi Anda akan terpicu ketika suatu peristiwa yang sedang dipantau diaktifkan. Untuk mengetahui informasi selengkapnya tentang Cloud Run Functions, baca dokumentasi Cloud Run Functions.

Sebelum memulai

Izin Identity and Access Management yang diperlukan

  1. Di Google Cloud konsol, buka halaman Cloud Build Izin:

    Buka Izin

  2. Untuk akun layanan Cloud Build yang Anda tentukan atau akun layanan Cloud Build default, tetapkan status peran berikut ke Diaktifkan:

    • Cloud Functions Developer (roles/cloudfunctions.developer) | Untuk men-deploy dan mengelola fungsi.
    • Cloud Run Admin (roles/run.admin) | Memungkinkan akun layanan Cloud Build Anda men-deploy versi baru ke Cloud Run.
    • Storage Admin (roles/storage.admin) | Memungkinkan pembacaan dan penulisan dari Cloud Storage.
    • Artifact Registry Writer (roles/artifactregistry.writer) | Memungkinkan pengambilan image dari dan penulisan ke Artifact Registry.
    • Logs Writer (roles/logging.logWriter) | Memungkinkan entri log ditulis ke Cloud Logging.
    • Cloud Build Editor (roles/cloudbuild.builds.editor) | Memungkinkan akun layanan Anda menjalankan build.

Mengonfigurasi deployment

Cloud Build memungkinkan Anda menggunakan image container yang tersedia secara publik untuk menjalankan tugas. Anda dapat melakukannya dengan menentukan image dalam step build di file konfigurasi Cloud Build.

Cloud Run Functions menyediakan perintah gcloud functions deploy, yang men-deploy fungsi Anda dari direktori yang berisi kode fungsi Anda. Anda dapat menggunakan image cloud-sdk sebagai langkah build dalam file konfigurasi untuk memanggil gcloud perintah dalam image. Argumen yang diteruskan ke langkah build ini diteruskan langsung ke Google Cloud CLI, sehingga Anda dapat menjalankan perintah gcloud apa pun dalam image ini.

Untuk men-deploy aplikasi ke Cloud Run Functions, gunakan langkah-langkah berikut:

  1. Di direktori root project Anda, buat file konfigurasi Cloud Build bernama cloudbuild.yaml atau cloudbuild.json.

  2. Di file konfigurasi:

    • Tambahkan kolom name dan tentukan langkah build gcloud.
    • Tambahkan functions deploy ke kolom args untuk memanggil perintah gcloud functions deploy. Untuk opsi konfigurasi yang tersedia, lihat gcloud functions deploy reference.

    • --source=. menunjukkan bahwa kode sumber berada di direktori kerja saat ini.

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON 

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Ganti nilai placeholder dalam file konfigurasi di atas dengan nilai berikut:

    • FUNCTION_NAME adalah nama Cloud Run Functions yang Anda deploy. Jika Anda mengupdate fungsi yang sudah ada, nilai ini harus cocok dengan nama fungsi yang Anda update.
    • FUNCTION_REGION adalah region tempat Anda men-deploy Cloud Run Functions. Untuk mengetahui daftar region yang didukung, lihat Lokasi Cloud Run Functions.
    • --trigger-http adalah jenis pemicu untuk fungsi ini, dalam hal ini permintaan HTTP (webhook).
    • RUNTIME adalah runtime tempat menjalankan fungsi.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan gcloud functions deploy, lihat dokumentasi Cloud Run Functions.

  3. Mulai build menggunakan file konfigurasi yang dibuat pada langkah sebelumnya:

     gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    Ganti nilai placeholder dalam file konfigurasi di atas dengan nilai berikut:

    • CONFIG_FILE_PATH adalah jalur ke file konfigurasi build.
    • SOURCE_DIRECTORY adalah jalur atau URL ke kode sumber.
    • REGION adalah salah satu region build yang didukung.

    Jika Anda tidak menentukan CONFIG_FILE_PATH dan SOURCE_DIRECTORY dalam perintah gcloud builds submit, Cloud Build akan mengasumsikan bahwa file konfigurasi dan kode sumber berada di direktori kerja saat ini.

Deployment berkelanjutan

Anda dapat mengotomatiskan deployment software ke Cloud Run Functions dengan membuat pemicu Cloud Build. Anda dapat mengonfigurasi pemicu untuk membangun dan men-deploy image setiap kali Anda mengupdate kode sumber.

Untuk mengotomatiskan deployment ke Cloud Run Functions:

  1. Di root repositori Anda, tambahkan file konfigurasi dengan langkah-langkah untuk memanggil perintah gcloud functions deploy:

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON 

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Ganti nilai placeholder dalam file konfigurasi di atas dengan nilai berikut:

    • FUNCTION_NAME adalah nama Cloud Run Functions yang Anda deploy. Jika Anda mengupdate fungsi yang sudah ada, nilai ini harus cocok dengan nama fungsi yang Anda update.
    • FUNCTION_REGION adalah region tempat Anda men-deploy Cloud Run Functions. Untuk mengetahui daftar region yang didukung, lihat Lokasi Cloud Run Functions.
    • --trigger-http adalah jenis pemicu untuk fungsi ini, dalam hal ini permintaan HTTP (webhook).
    • RUNTIME adalah runtime tempat menjalankan fungsi.

  2. Buat pemicu build dengan file konfigurasi yang dibuat pada langkah sebelumnya:

    1. Buka halaman Pemicu di Google Cloud konsol:

      Buka halaman Pemicu

    2. Pilih project Anda dari menu drop-down pemilih project di bagian atas halaman.

    3. Klik Create Trigger.

    4. Di kolom Nama, masukkan nama pemicu Anda.

    5. Di bagian Region, pilih region untuk pemicu Anda.

    6. Di bagian Peristiwa, pilih peristiwa repositori untuk memulai pemicu Anda.

    7. Di bagian Sumber, pilih repositori dan cabang atau nama tag yang akan memulai pemicu Anda. Untuk informasi selengkapnya tentang menentukan cabang yang akan otomatis di-build, lihat Membuat pemicu build.

    8. Di bagian Konfigurasi, pilih File konfigurasi Cloud Build (YAML atau JSON).

    9. Di kolom Lokasi file konfigurasi Cloud Build , ketik cloudbuild.yaml setelah /.

    10. Klik Buat untuk menyimpan pemicu build Anda.

Setiap kali Anda melakukan push kode baru ke repositori, Anda akan otomatis memicu build dan men-deploy di Cloud Run Functions.

Untuk mengetahui informasi selengkapnya tentang cara membuat pemicu Cloud Build, lihat Membuat dan mengelola pemicu build.

Langkah berikutnya