Halaman ini diterjemahkan oleh Cloud Translation API.

Mem-build fungsi ke dalam penampung

Cloud Run mendukung deployment fungsi secara langsung, tetapi Anda juga dapat mem-build fungsi ke dalam image container menggunakan buildpack Google Cloud, lalu men-deploy image container ini ke Cloud Run.

Kasus penggunaan umum untuk membangun fungsi ke dalam container meliputi:

Continuous Integration dan Delivery: Developer menulis dan mengirimkan kode fungsi ke repositori sumber, sistem CI/CD secara otomatis membangun fungsi ke dalam container, menjalankan pengujian, dan men-deploy-nya secara otomatis ke lingkungan staging.
Infrastructure as Code: Resource Cloud Run yang dikelola menggunakan YAML atau Terraform merujuk ke URL image container. Kode fungsi yang ditulis oleh developer harus dibangun menjadi image container.

Halaman ini menjelaskan secara mendetail cara mereplikasi proses build yang persis sama dari fungsi Cloud Run menggunakan dua cara:

Menggunakan pack CLI
Menggunakan Cloud Build sebagai sistem build jarak jauh

Titik entri fungsi

Untuk membuat fungsi dengan buildpack:

Sertakan library Functions Framework.
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 Cloud Run dibangun di atas image dasar yang dikelola dan dipublikasikan di bawah 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 container 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

Instal Docker Community Edition (CE) di workstation Anda. Docker digunakan oleh pack sebagai builder image OCI.
Instal Pack CLI.
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.

Clone repositori contoh ke komputer lokal Anda:

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

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

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

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

Kunjungi fungsi yang sedang berjalan dengan mengakses 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

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.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Pastikan Google Cloud project 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 membangun 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.

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.

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

Contoh: Mem-build fungsi contoh dari jarak jauh

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

Clone repositori contoh ke komputer lokal Anda:

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

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

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.

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.

Membangun fungsi untuk update image dasar otomatis

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

Dockerfile

Anda dapat menggunakan toolchain build yang ada untuk membuat image container fungsi yang kompatibel dengan pembaruan image dasar otomatis. Lihat petunjuk tentang cara membuat container di scratch.

`pack` CLI

pack build 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

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 mem-build fungsi ke dalam container, uji secara lokal sebelum men-deploy ke Cloud Run. Lihat Menguji layanan Cloud Run secara lokal untuk mempelajari lebih lanjut.
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.

Mem-build fungsi ke dalam penampung Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Titik entri fungsi

Builder

Membangun dengan pack

Sebelum memulai

Mem-build fungsi secara lokal

Mem-build fungsi contoh secara lokal

Go

Java

Node.js

Python

Ruby

Go

Java

Node.js

Python

Ruby

Go

Java

Node.js

Python

Ruby

Membangun dengan sistem build jarak jauh

Sebelum memulai

Membangun fungsi dari jarak jauh

Membangun dengan perintah

Membangun dengan file konfigurasi

Contoh: Mem-build fungsi contoh dari jarak jauh

Go

Java

Node.js

Python

Ruby

Go

Java

Node.js

Python

Ruby

Membangun fungsi untuk update image dasar otomatis

Dockerfile

pack CLI

Cloud Build

Apa langkah selanjutnya?

Mem-build fungsi ke dalam penampung

Membangun dengan `pack`

`pack` CLI