Mengelola eksekusi tugas

Halaman ini menjelaskan cara menampilkan dan menghapus eksekusi tugas. Untuk mengeksekusi, membatalkan, atau mengganti konfigurasi tugas, lihat Jalankan tugas.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola tugas Cloud Run, minta administrator untuk memberi Anda peran IAM Cloud Run Developer (roles/run.developer) pada tugas Cloud Run Anda.

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.

Tampilkan eksekusi tugas di project Anda

Anda dapat menampilkan daftar eksekusi tugas di project Anda menggunakan konsol Google Cloud atau Google Cloud CLI:

Konsol

Untuk menampilkan daftar eksekusi tugas:

  1. Buka halaman tugas Cloud Run

  2. Dalam daftar, cari tugas yang ingin Anda kelola eksekusinya.

  3. Klik tugas untuk menampilkan daftar eksekusi.

  4. Di halaman detail eksekusi, pilih eksekusi yang Anda minati dari daftar. Secara opsional Anda dapat menggunakan filter yang ditetapkan ke kriteria yang diinginkan contohnya, Status dengan nilai completed:

gcloud

Untuk mencantumkan semua eksekusi tugas untuk semua tugas pada project Anda:

gcloud run jobs executions list

Untuk mencantumkan hanya eksekusi untuk tugas tertentu:

gcloud run jobs executions list --job JOB_NAME

Ganti JOB_NAME dengan nama tugas yang sedang Anda filter.

Untuk mengetahui cara lain untuk menyaring daftar yang ditampilkan, termasuk penggunaan filter, lihat daftar eksekusi tugas.

Untuk mendapatkan nama eksekusi terbaru dari tugas tertentu, gunakan --format flag:

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Ganti JOB_NAME dengan nama tugas yang sedang Anda filter.

Library klien

Untuk mencantumkan semua eksekusi tugas dari kode:

REST API

Untuk mencantumkan eksekusi tugas, kirim permintaan HTTP GET ke endpoint jobs Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

Ganti:

  • ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk melihat 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.
  • REGION dengan region Google Cloud tugas.
  • PROJECT-ID dengan ID project Google Cloud.

Tampilan detail eksekusi tugas

Anda dapat menampilkan detail eksekusi tugas untuk 10.000 eksekusi tugas yang paling baru menggunakan panel detail eksekusi, beserta tiap eksekusi yang terjadi dalam tujuh hari terakhir. Detail eksekusi yang lebih lama akan dihapus dan tidak lagi terlihat di panel detail eksekusi. Namun, log dan data pemantauan untuk eksekusi yang lebih lama masih tersedia di Cloud Logging dan Cloud Monitoring, tunduk pada kebijakan retensi untuk produk tersebut.

Anda dapat menggunakan konsol Google Cloud atau Google Cloud CLI untuk melihat lebih detail tentang eksekusi tugas.

Konsol

Untuk melihat detail pengerjaan tugas tertentu:

  1. Buka halaman tugas Cloud Run

  2. Klik tugas untuk membuka panel detail tugas.

  3. Klik eksekusi tugas yang ingin Anda lihat. Detail eksekusi ditampilkan di panel sebelah kanan.

  4. Perhatikan tab Tasks, Containers, Volumes, Networking, Security, dan YAML, serta link View Logs.

    • Tasks menampilkan informasi tentang pekerjaan dan eksekusi tugas.
    • YAML menampilkan konfigurasi tugas dalam format YAML.
    • Klik link Lihat Log untuk melihat log yang terkait dengan eksekusi.
    • Tab lainnya menampilkan informasi tentang tugas, penampung, keamanan, konektivitas, dan sebagainya yang digunakan dalam eksekusi.

gcloud

Untuk melihat detail tentang eksekusi tugas:

Gunakan perintah:

gcloud run jobs executions describe EXECUTION_NAME

Ganti EXECUTION_NAME dengan nama eksekusi.

Anda dapat menggunakan --format flag untuk melakukan pemformatan output dan mendapatkan informasi tambahan. Contohnya sebagai YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Library klien

Untuk melihat detail eksekusi tugas dari kode:

REST API

Untuk melihat detail eksekusi tugas, kirim permintaan HTTP GET ke endpoint jobs Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

Ganti:

  • ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk melihat detail 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, bahkan saat sedang eksekusi Jika Anda menghapus eksekusi, proses eksekusi akan terhenti

Meskipun eksekusi yang dihapus tidak muncul di daftar eksekusi, log eksekusi terus tersedia di Cloud Logging selama sisa periode retensi data log, dan pemantauan data terus tersedia di Cloud Monitoring.

Konsol

Untuk menghapus eksekusi tugas:

  1. Buka halaman tugas Cloud Run

  2. Klik tugas untuk membuka panel detail tugas.

  3. Pilih eksekusi tugas yang ingin Anda hapus.

  4. Di bagian menu Tindakan, klik ikon elipsis, lalu klik Hapus.

  5. Jika diminta untuk mengonfirmasi penghapusan, klik Confirm.

gcloud

Untuk menghapus eksekusi tugas:

  1. Gunakan perintah:

    gcloud run jobs executions delete EXECUTION_NAME

    Ganti EXECUTION_NAME dengan nama eksekusi.

  2. Jika diminta untuk mengonfirmasi, respons y. Setelah berhasil, pesan berhasil akan ditampilkan.

Library klien

Untuk menghapus eksekusi tugas dari kode:

REST API

Untuk menghapus eksekusi tugas, kirim permintaan HTTP DELETE ke endpoint jobs Cloud Run Admin API

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

Ganti:

  • ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk menghapus 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.