Mem-build fungsi

Fungsi yang ditulis untuk fungsi Cloud Run dapat dibuat menggunakan buildpack Google Cloud.

Halaman ini menunjukkan dua cara untuk mem-build fungsi Anda untuk di-deploy ke Cloud Run:

• Menggunakan pack CLI
• Menggunakan Cloud Build sebagai sistem build jarak jauh

Titik Entri Fungsi

Untuk mem-build fungsi dengan buildpack:

• Sertakan library Framework Functions.

• Tetapkan variabel lingkungan GOOGLE_FUNCTION_TARGET ke nama fungsi yang Anda gunakan sebagai titik entri. Anda dapat melakukannya dengan menyertakan project.toml di folder yang sama dengan kode sumber Anda. File project.toml harus memiliki konfigurasi berikut:

[[build.env]]
    name = "GOOGLE_FUNCTION_TARGET"
    value =  "ENTRY_POINT"

Ganti ENTRY_POINT dengan metode fungsi.

Untuk mengetahui detail tentang cara menggunakan variabel lingkungan dengan fungsi Cloud Run, lihat Mengonfigurasi layanan fungsi Cloud Run.

Builder

Fungsi dibuat di atas image dasar yang dikelola dan dipublikasikan dalam buildpack Google Cloud.

Builder adalah image yang terdiri dari buildpack dan paket sistem operasi (juga dikenal sebagai Stack). Builder digunakan untuk mengonversi kode sumber fungsi Anda menjadi penampung yang sedang berjalan.

Anda dapat memilih dari daftar builder buildpack Google Cloud yang didukung.

Membangun dengan pack

Pack adalah alat CLI yang dikelola oleh project CNB untuk mendukung penggunaan buildpack. Gunakan CLI pack untuk mem-build fungsi secara lokal menjadi image container.

Sebelum memulai

1. Instal Docker Community Edition (CE) di workstation Anda. Docker digunakan oleh pack sebagai builder image OCI.
2. Instal Pack CLI.
3. Instal alat Kontrol sumber Git untuk mengambil aplikasi contoh dari GitHub.

Mem-build fungsi secara lokal

Anda menggunakan perintah pack build dan menentukan --builder=gcr.io/buildpacks/builder builder default untuk membuat image container secara lokal.

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

Ganti IMAGE_NAME dengan nama image container Anda.

Anda juga dapat menyesuaikan image container dengan memperluas build dan menjalankan image.

Mem-build fungsi contoh secara lokal

Contoh berikut menunjukkan cara membuat sampel secara lokal.

1. Clone repositori contoh ke komputer lokal Anda:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. Ubah ke direktori yang berisi kode contoh aplikasi:

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. Gunakan pack untuk membuat fungsi contoh:

   Go

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-go

   Java

   pack build --builder gcr.io/buildpacks/builder:v1 sample-functions-java-mvn

   Node.js

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-node

   Python

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-python

   Ruby

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-ruby

4. Jalankan image menggunakan docker:

   Go

   docker run -p8080:8080 sample-functions-framework-go

   Java

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-java-mvn

   Node.js

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-node

   Python

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-python

   Ruby

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-ruby

5. Kunjungi fungsi yang sedang berjalan dengan membuka localhost:8080.

Membangun dengan sistem build jarak jauh

Gunakan Cloud Build untuk mem-build fungsi Anda menjadi image container, dan Artifact Registry sebagai repositori container untuk menyimpan dan men-deploy setiap image.

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. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

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

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

9. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Jika Anda telah menginstal Google Cloud CLI sebelumnya, pastikan Anda memiliki versi terbaru yang tersedia dengan menjalankan gcloud components update.

12. Pastikan project Google Cloud Anda memiliki akses ke repositori image container.

    Untuk mengonfigurasi akses ke repositori Docker di Artifact Registry:

    1. Buat repositori Docker baru di lokasi yang sama dengan project Google Cloud Anda.

       gcloud artifacts repositories create REPO_NAME \
       --repository-format=docker \
       --location=REGION --description="DESCRIPTION"

       Ganti:
       • REPO_NAME dengan nama yang Anda pilih untuk repositori Docker.
       • REGION dengan lokasi di atau yang terdekat dengan lokasi project Google Cloud Anda.
       • DESCRIPTION dengan deskripsi pilihan Anda.

       Misalnya, untuk membuat repositori docker di us-west2 dengan deskripsi "repository Docker", jalankan:

       gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
       --location=us-west2 --description="Docker repository"

    2. Pastikan repositori Anda telah dibuat:

       gcloud artifacts repositories list

       Anda akan melihat nama yang dipilih untuk repositori Docker Anda dalam daftar.

Membangun fungsi dari jarak jauh

Anda menggunakan perintah gcloud builds submit untuk mem-build dan mengupload image container ke repositori.

Anda dapat memilih untuk menentukan image container dalam perintah itu sendiri atau menggunakan file konfigurasi.

Membangun dengan perintah

Untuk mem-build tanpa file konfigurasi, tentukan flag image:

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

Ganti:

• LOCATION dengan nama region repositori container Anda, misalnya, us-west2
• PROJECT_ID dengan ID project Google Cloud Anda.
• REPO_NAME dengan nama repositori Docker Anda.
• IMAGE_NAME dengan nama image container Anda.

Contoh:

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo

Membangun dengan file konfigurasi

Anda dapat menggunakan file konfigurasi untuk menentukan detail konfigurasi repositori image cukup dengan perintah build. File konfigurasi menggunakan format file YAML dan harus menyertakan langkah build yang menggunakan CLI pack.

1. Buat nama file YAML cloudbuild.yaml yang menyertakan URI repositori image container Anda.

  options:
    logging: CLOUD_LOGGING_ONLY
    pool: {}
  projectId: PROJECT_ID
  steps:
  - name: gcr.io/k8s-skaffold/pack
    entrypoint: pack
    args:
    - build
    - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
    - --builder
    - gcr.io/buildpacks/builder:latest
    - --network
    - cloudbuild
  images:
  - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

Ganti:

• LOCATION dengan nama region repositori container Anda, misalnya, us-west2.
• PROJECT_ID dengan ID project Google Cloud Anda.
• REPO_NAME dengan nama repositori Docker Anda.
• IMAGE_NAME dengan nama image container Anda.

1. Bangun aplikasi.

   Jika file konfigurasi diberi nama cloudbuild.yaml, Anda dapat menjalankan perintah berikut:

   gcloud builds submit .
   

   Tips: Jika menggunakan nama unik untuk file konfigurasi, Anda dapat menggunakan tanda --config.

Contoh: Mem-build fungsi contoh dari jarak jauh

Contoh berikut menunjukkan cara mem-build sampel dari jarak jauh, dan memverifikasi bahwa image container telah dikirim ke repositori Anda di Artifact Registry.

1. Clone repositori contoh ke komputer lokal Anda:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. Ubah ke direktori yang berisi kode contoh aplikasi:

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. Gunakan gcloud untuk mengirimkan kode sumber aplikasi ke Cloud Build:

   Go

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-go

   Java

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-gradle

   Node.js

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-node

   Python

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-python

   Ruby

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-ruby

   Ganti:

   • LOCATION dengan nama region repositori container Anda. Contoh: us-west2-docker.pkg.dev
   • PROJECT_ID dengan ID project Google Cloud Anda.
   • REPO_NAME dengan nama repositori Docker Anda.

4. Pastikan fungsi contoh berhasil dipublikasikan ke REPO_NAME:

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   Ganti:

   • LOCATION dengan nama region repositori container Anda, misalnya, us-west2.
   • PROJECT_ID dengan ID project Google Cloud Anda.
   • REPO_NAME dengan nama repositori Docker Anda.

Mem-build fungsi untuk update image dasar otomatis

Pratinjau — Cloud Run automatic base image updates

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Penampung fungsi juga dapat dibuat di scratch, sehingga dapat digunakan bersama dengan update keamanan otomatis Cloud Run.

pack CLI

pack build IMAGE_NAME \
  --builder LOCATION.pkg.dev/serverless-runtimes/google-22-full/builder/LANGUAGE:latest
  --run-image LOCATION-docker.pkg.dev/serverless-runtimes/google-22/scratch/RUNTIME_ID:latest

Ganti:

• LOCATION dengan nama region repositori container Anda, misalnya, us-west2.
• IMAGE_NAME dengan nama image container Anda.
• LANGUAGE dengan bahasa fungsi Anda, misalnya nodejs.
• RUNTIME_ID dengan ID runtime, misalnya nodejs22.

Cloud Build

options:
  logging: CLOUD_LOGGING_ONLY
  pool: {}
projectId: PROJECT_ID
steps:
- name: gcr.io/k8s-skaffold/pack
  entrypoint: pack
  args:
  - build
  - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
  - --builder
  - LOCATION-docker.pkg.dev/serverless-runtimes/google-22-full/builder/LANGUAGE:latest
  - --run-image
  - LOCATION-docker.pkg.dev/serverless-runtimes/google-22/scratch/RUNTIME_ID:latest
  - --network
  - cloudbuild
images:
- LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

Ganti:

• LOCATION dengan nama region repositori container Anda, misalnya, us-west2.
• PROJECT_ID dengan ID project Google Cloud Anda.
• REPO_NAME dengan nama repositori Docker Anda.
• IMAGE_NAME dengan nama image container Anda.
• LANGUAGE dengan bahasa fungsi Anda, misalnya nodejs.
• RUNTIME_ID dengan ID runtime, misalnya nodejs22.

Apa langkah selanjutnya?

• Setelah container Anda dibangun, Anda dapat menguji secara lokal sebelum men-deploy ke Cloud Run; lihat Menguji layanan Cloud Run secara lokal untuk mempelajari lebih lanjut.
• Untuk memahami persyaratan dan perilaku utama container di Cloud Run, lihat Kontrak container.
• Untuk men-deploy container Anda yang telah dibangun ke Cloud Run, ikuti Men-deploy layanan.
• Untuk mengotomatiskan build dan deployment layanan Cloud Run Anda menggunakan pemicu Cloud Build, lihat menyiapkan deployment berkelanjutan.
• Agar dapat menjalankan build container yang optimal untuk aplikasi Java, lihat Membangun container Java dengan Jib.