Halaman ini menjelaskan cara Cloud Run menjalankan tugasnya. Mengeksekusi tugas membuat eksekusi tugas di mana semua tugas harus dijalankan hingga selesai dengan sukses agar eksekusi tugas berhasil. Eksekusi tugas akan menulis log ke Cloud Logging dan mengirim data pemantauan ke Cloud Monitoring.
Selain fitur logging ini, Anda juga dapat melihat detail eksekusi tugas untuk 1.000 eksekusi tugas terbaru menggunakan panel detail eksekusi, beserta eksekusi yang terjadi dalam tujuh hari terakhir. Detail eksekusi lama dipindahkan dan tidak akan lagi terlihat di panel detail eksekusi. Namun, log dan data pemantauan untuk eksekusi yang lebih lama masih tersedia di Cloud Logging dan Cloud Monitoring, yang tunduk pada kebijakan retensi untuk produk tersebut
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk operasi yang dijelaskan di halaman ini, minta administrator untuk memberi Anda salah satu peran IAM berikut pada tugas Cloud Run Anda:
- Untuk menjalankan tugas menggunakan Google Cloud CLI: Cloud Run Invoker (
roles/run.invoker) pada tugas Cloud Run - Untuk menjalankan tugas menggunakan konsol Google Cloud, mengganti konfigurasi tugas, atau membatalkan eksekusi tugas: Cloud Run Developer (
roles/run.developer) di tugas Cloud Run
Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat peran IAM Cloud Run dan izin IAM Cloud Run. Jika tugas Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.
Menjalankan tugas
Anda dapat menjalankan tugas menggunakan Konsol Google Cloud atau Google Cloud CLI.
Konsol
Untuk menjalankan tugas:
Temukan tugas yang Anda minati.
Klik tugas untuk menampilkan halaman detail tugas.
Klik Jalankan.
gcloud
Untuk menjalankan tugas yang ada:
gcloud run jobs execute JOB_NAME
Jika Anda ingin perintahnya menunggu sampai eksekusi selesai, gunakan
gcloud run jobs execute JOB_NAME --wait --region=REGION
Ganti:
- JOB_NAME dengan nama tugas.
- REGION dengan region tempat resource dapat ditemukan.
Atau, tetapkan properti
run/region.
Library klien
Untuk menjalankan tugas yang ada dari kode:
REST API
Untuk menjalankan tugas yang ada, kirim permintaan HTTP POST ke
metode API jobs.run
Misalnya, menggunakan curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME:run
Ganti:
- ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk menjalankan tugas.
Misalnya, jika login ke gcloud, Anda dapat mengambil
token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - JOB-NAME dengan nama tugas.
- REGION dengan region Google Cloud tugas.
- PROJECT-ID dengan ID project Google Cloud.
Menjalankan tugas segera pada saat pembuatan tugas
Jika menggunakan command line, Anda dapat menentukan eksekusi tugas segera setelah Anda membuat tugas:
gcloud run jobs create JOB_NAME --execute-now --region=REGION
Mengganti konfigurasi tugas untuk eksekusi tertentu
Dengan menetapkan parameter ini saat memulai eksekusi tugas baru, Anda dapat mengganti argumen, variabel lingkungan, jumlah, dan waktu tunggu yang dikonfigurasi untuk menjalankan suatu tugas. Parameter yang Anda tentukan hanya memengaruhi eksekusi ini, bukan eksekusi berikutnya karena definisi tugas yang mendasarinya tidak berubah.
Beberapa kasus penggunaan umum mencakup:
- Anda menjalankan tugas secara terprogram dari kode Anda, dan ingin mengganti argumen dan/atau variabel lingkungan, misalnya untuk memberi tahu tugas lokasi data input untuk eksekusi ini.
- Anda memiliki tugas dengan setiap tugas hanya digunakan untuk memproses satu bagian data input. Anda ingin mengganti jumlah tugas berdasarkan jumlah input yang diproses.
- Waktu berjalannya tugas Anda bervariasi di setiap eksekusi. Anda ingin mengganti waktu tunggu tugas berdasarkan waktu berjalannya tugas yang diharapkan.
Untuk mengganti konfigurasi tugas suatu eksekusi:
Konsol
Temukan tugas yang Anda minati.
Klik tugas untuk menampilkan halaman detail tugas.
Klik panah luaskan di depan tombol Edit, lalu klik Execute dengan penggantian untuk menampilkan formulir Jalankan tugas dengan penggantian.
Ubah argumen, variabel lingkungan, jumlah tugas, dan/atau konfigurasi waktu tunggu tugas untuk eksekusi ini sesuai keinginan, lalu klik Jalankan.
gcloud
Gunakan perintah:
gcloud run jobs execute JOB_NAME \ --args ARGS \ --update-env-vars KEY=VALUE>,KEY_N=VALUE_N \ --tasks TASKS \ --task-timeout TIMEOUT
Ganti
- JOB_NAME dengan nama tugas.
- ARGS dengan argumen tugas yang diinginkan
- KEY dan VALUE berpasangan dengan variabel lingkungan yang diinginkan
- TASKS dengan jumlah tugas yang diinginkan
- TIMEOUT dengan waktu tunggu tugas yang diinginkan
Library klien
Untuk menjalankan tugas yang ada dari kode, ganti konfigurasi tugas:
REST API
Untuk mengganti konfigurasi tugas untuk tugas yang ada, kirim permintaan HTTP POST ke
endpoint jobs Cloud Run Admin API
Misalnya, menggunakan curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '{"overrides": {"containerOverrides": [{"args": ["ARGS"], "env": [{"name": "KEY", "value": "VALUE"}]}], "taskCount": TASK-COUNT, "timeout": "TIMEOUT" }}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME:run
Ganti:
- ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk menjalankan penggantian tugas.
Misalnya, jika login ke gcloud, Anda dapat mengambil
token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - JOB_NAME dengan nama tugas.
- ARGS dengan argumen tugas.
- KEY dan VALUE berpasangan dengan variabel lingkungan.
- TASKS dengan jumlah tugas.
- TIMEOUT dengan waktu tunggu tugas.
- REGION dengan region Google Cloud tugas.
- PROJECT-ID dengan ID project Google Cloud.
Membatalkan eksekusi tugas
Untuk menghentikan eksekusi tugas Cloud Run yang sedang berjalan, gunakan fitur pembatalan. Membatalkan eksekusi tugas akan menghentikan eksekusi tugas saat ini. Eksekusi yang dibatalkan akan berstatus cancelled. Anda tetap dapat melihat eksekusi tersebut, termasuk data konfigurasi, log, dan data pemantauan.
Membatalkan eksekusi tugas tidak akan membatalkan tagihan untuk penggunaan tugas Cloud Run selama tugas dijalankan.
Untuk membatalkan eksekusi:
Konsol
Klik tugas untuk membuka panel detail tugas.
Pilih eksekusi tugas yang ingin Anda batalkan.
Di bagian menu Tindakan, klik ikon elipsis, lalu klik Batalkan.
gcloud
Gunakan perintah:
gcloud run jobs executions cancel EXECUTION_NAME
Ganti EXECUTION_NAME dengan nama eksekusi.
Perintah ini meminta konfirmasi, jadi tanggapi permintaan dengan memasukkan
y untuk mengonfirmasi.
Library klien
Untuk membatalkan eksekusi tugas dari kode:
REST API
Untuk membatalkan eksekusi tugas, kirim permintaan HTTP POST ke
endpoint jobs Cloud Run Admin API
Misalnya, menggunakan curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME:cancel
Ganti:
- ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk membatalkan eksekusi tugas.
Misalnya, jika login ke gcloud, Anda dapat mengambil
token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - JOB_NAME dengan nama tugas.
- EXECUTION-NAME dengan nama eksekusi tugas.
- REGION dengan region Google Cloud tugas.
- PROJECT-ID dengan ID project Google Cloud.
Menghapus eksekusi tugas
Anda dapat menghapus eksekusi tugas, meskipun sedang dijalankan. Jika sebuah eksekusi dihapus, eksekusi akan berhenti dilanjutkan. Untuk mengetahui detailnya, lihat Menghapus eksekusi tugas.
Langkah berikutnya
Setelah Anda menyelesaikan eksekusi tugas, Anda dapat melakukan tahapan berikut: