Fungsi Cloud Run Anda berjalan di lingkungan yang terdiri dari versi sistem operasi dengan paket add-on, dukungan bahasa, dan library Java Functions Framework yang mendukung dan memanggil fungsi Anda. Lingkungan ini diidentifikasi berdasarkan versi bahasa, dan dikenal sebagai ID runtime.
Persiapan fungsi
Anda dapat menyiapkan fungsi langsung dari konsol Google Cloud atau menulisnya di komputer lokal, lalu menguploadnya. Guna menyiapkan mesin lokal untuk pengembangan Java, lihat Menyiapkan lingkungan pengembangan Java.
Image dasar dan runtime Java yang didukung
| Runtime | ID Runtime | Tumpukan | Image dasar runtime |
|---|---|---|---|
| Java 25 (Pratinjau) |
java25 |
|
|
| Java 21 | java21 |
|
|
| Java 17 | java17 |
|
|
| Java 11 | java11 | google-18-full | google-18-full/java11 |
Memilih runtime Anda
Anda dapat memilih salah satu runtime Java yang didukung untuk fungsi Anda selama deployment.
Anda dapat memilih versi runtime menggunakan konsol Google Cloud atau gcloud CLI. Klik tab untuk mendapatkan petunjuk cara menggunakan alat pilihan Anda:
gcloud
Tentukan image dasar Java untuk fungsi Anda menggunakan flag --base-image,
saat men-deploy fungsi Anda. Contoh:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image java21
Ganti:
FUNCTION dengan nama fungsi yang Anda deploy. Anda dapat menghilangkan parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama jika menghilangkannya.
FUNCTION_ENTRYPOINT dengan titik entri ke fungsi Anda dalam kode sumber. Ini adalah kode yang dijalankan Cloud Run saat fungsi Anda berjalan. Nilai flag ini harus berupa nama fungsi atau nama class yang sepenuhnya memenuhi syarat yang ada dalam kode sumber Anda.
Untuk mendapatkan petunjuk mendetail tentang cara men-deploy fungsi menggunakan gcloud CLI, lihat Men-deploy fungsi di Cloud Run.
Konsol
Anda dapat memilih versi runtime saat membuat atau memperbarui fungsi Cloud Run di konsol Google Cloud . Untuk mengetahui petunjuk mendetail tentang cara men-deploy fungsi, lihat Men-deploy fungsi di Cloud Run.
Untuk memilih runtime di konsol Google Cloud saat Anda membuat fungsi, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Cloud Run:
Klik Write a function.
Dalam daftar Runtime, pilih versi runtime Java.
Klik Buat, dan tunggu hingga Cloud Run membuat layanan menggunakan revisi placeholder.
Konsol akan mengalihkan Anda ke tab Sumber tempat Anda dapat melihat kode sumber fungsi. Klik Simpan dan deploy ulang.
Untuk mengetahui petunjuk mendetail tentang cara memperbarui versi runtime setelah fungsi Anda di-deploy, lihat Men-deploy ulang kode sumber baru.
Struktur kode sumber
Agar fungsi Cloud Run dapat menemukan definisi fungsi Anda, kode sumber Anda harus mengikuti struktur tertentu. Baca artikel Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.
Menentukan dependensi
Anda dapat menentukan dependensi untuk fungsi Anda menggunakan Maven atau Gradle. Untuk mengetahui informasi selengkapnya, lihat Menentukan dependensi di Java.
Variabel lingkungan
Runtime Java Anda akan otomatis menetapkan variabel lingkungan tertentu untuk digunakan fungsi Anda sesuai kebutuhan. Untuk mengetahui detailnya, lihat Mengonfigurasi variabel lingkungan.
ID eksekusi
Untuk fungsi Java yang menggunakan functions-framework versi 1.4.0 atau yang lebih baru, Anda dapat menggunakan class logging java.util.logging.Logger untuk menambahkan ID eksekusi unik ke output log. Menggunakan stdout atau stderr (misalnya,
System.println()) tidak akan menambahkan ID eksekusi.
Perhatikan bahwa:
Jika Anda membuat fungsi menggunakan Cloud Functions v2 API (misalnya, dengan menggunakan
gcloud functions, REST API, atau Terraform), ID eksekusi ini akan ditambahkan secara otomatis.Jika Anda membuat fungsi menggunakan Cloud Run Admin API (misalnya, dengan menggunakan konsol Google Cloud ,
gcloud run, REST API, atau Terraform), Anda perlu menyetel variabel lingkunganLOG_EXECUTION_IDketrueuntuk menggunakan fitur ini.