Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
Anda dapat memilih salah satu runtime Java yang didukung untuk fungsi Anda selama deployment.
Anda dapat memilih versi runtime menggunakan Google Cloud console, 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. Contoh:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image java21
Ganti:
FUNCTION dengan nama fungsi yang Anda deployment. Anda dapat menghilangkan parameter ini sepenuhnya,
tetapi Anda akan diminta untuk memasukkan nama jika mengabaikannya.
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 Google Cloud console saat membuat fungsi, ikuti langkah-langkah berikut:
Klik Create, dan tunggu Cloud Run membuat layanan menggunakan revisi placeholder.
Konsol akan mengalihkan Anda ke tab Source, tempat Anda dapat melihat kode sumber fungsi. Klik Save and redeploy.
Untuk petunjuk mendetail tentang cara mengupdate 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 harus mengikuti struktur tertentu. Lihat artikel Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.
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 membuat fungsi menggunakan Cloud Run Admin API (misalnya, dengan menggunakan Google Cloud console, gcloud run, REST API, atau Terraform), Anda harus menetapkan variabel lingkungan LOG_EXECUTION_ID ke true untuk menggunakan fitur ini.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["# The Java runtime\n\nYour Cloud Run function runs in an environment consisting of an\noperating system version with add-on packages, language support, and\nthe [Java Functions Framework](https://github.com/GoogleCloudPlatform/functions-framework-java)\nlibrary that supports and invokes your function. This environment is identified\nby the language version, and is known as the runtime ID.\n\nFunction preparation\n--------------------\n\nYou can prepare a function directly from the Google Cloud console or write it on\nyour local machine and upload it. To prepare your local machine for Java\ndevelopment, see [Set up a Java development environment](/java/docs/setup).\n\nSupported Java runtimes and base images\n---------------------------------------\n\nSelect your runtime\n-------------------\n\nYou can select one of the supported Java runtimes for your function during\ndeployment.\n\n\nYou can select a runtime version using the Google Cloud console, or the\ngcloud CLI. Click the tab for instructions on using the tool of\nyour choice: \n\n### gcloud\n\nSpecify the [Java base image](/run/docs/configuring/services/runtime-base-images#how_to_obtain_base_images) for your function using the `--base-image` flag,\nwhile deploying your function. For example: \n\n gcloud run deploy \u003cvar translate=\"no\"\u003eFUNCTION\u003c/var\u003e \\\n --source . \\\n --function \u003cvar translate=\"no\"\u003eFUNCTION_ENTRYPOINT\u003c/var\u003e \\\n --base-image java21\n\nReplace:\n\n- \u003cvar translate=\"no\"\u003eFUNCTION\u003c/var\u003e with the name of the function you are\n deploying. You can omit this parameter entirely,\n but you will be prompted for the name if you omit it.\n\n- \u003cvar translate=\"no\"\u003eFUNCTION_ENTRYPOINT\u003c/var\u003e with the entry point to your function in\n your source code. This is the code Cloud Run executes when your\n function runs. The value of this flag must be a function name or\n fully-qualified class name that exists in your source code.\n\nFor detailed instructions on deploying a function using the gcloud CLI, see [Deploy functions in Cloud Run](/run/docs/deploy-functions#gcloud).\n\n### Console\n\nYou can select a runtime version when you create or update a Cloud Run function in the Google Cloud console. For detailed\ninstructions on deploying a function, see [Deploy functions in Cloud Run](/run/docs/deploy-functions#deploy-functions).\n\nTo select a runtime in the Google Cloud console when you create a function, follow these steps:\n\n1. In the Google Cloud console, go to the Cloud Run page:\n\n [Go to Cloud Run](https://console.cloud.google.com/run)\n2. Click **Write a function**.\n\n3. In the **Runtime** list, select a Java runtime version.\n\n4. Click **Create**, and wait for Cloud Run to create the service\n using a placeholder revision.\n\n5. The console will redirect you to the **Source**\n tab where you can see the source code of your function. Click **Save and redeploy**.\n\nFor detailed instructions on updating the runtime version after your function is\ndeployed, see\n[Re-deploy new source code](/run/docs/deploy-functions#update-code-functions).\n\nSource code structure\n---------------------\n\nFor Cloud Run functions to find your function's definition, your\nsource code must follow a specific structure. See\n[Write Cloud Run functions](/run/docs/write-functions#java) for\nmore information.\n\nSpecifying dependencies\n-----------------------\n\nYou can specify dependencies for your function using [Maven](https://maven.apache.org)\nor [Gradle](https://gradle.org). For more information, see [Specify\ndependencies in Java](/run/docs/runtimes/java-dependencies).\n\nEnvironment variables\n---------------------\n\nYour Java runtime automatically sets certain environment variables for your\nfunction to use as needed. For details, see [Configure environment\nvariables](/run/docs/configuring/services/environment-variables).\n\nExecution ID\n------------\n\nFor Java functions that use `functions-framework` version 1.4.0 or later, you\ncan use the logging class `java.util.logging.Logger` to add a unique execution\nID to log outputs. Using `stdout` or `stderr` (for example,\n`System.println()`) does not add the execution ID.\n\nNote that:\n\n- If you created your function using the\n [Cloud Functions v2 API](/functions/docs/reference/rest)\n (for example, by using `gcloud functions`, the REST API, or Terraform), this\n execution ID is added automatically.\n\n- If you created your function using the\n [Cloud Run Admin API](/run/docs/reference/cloud-run-admin-api-overview)\n (for example, by using Google Cloud console, `gcloud run`, the REST API, or\n Terraform), you need to set the `LOG_EXECUTION_ID` environment variable to\n `true` to use this feature."]]
