Mengelola eksekusi tugas

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola tugas Cloud Run, minta administrator untuk memberi Anda peran IAM Cloud Run Developer (roles/run.developer) di 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 melihat daftar eksekusi tugas di project Anda menggunakan konsolGoogle Cloud , gcloud CLI, library klien, atau REST API:

Konsol

Untuk melihat daftar eksekusi tugas, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman tugas Cloud Run:

    Buka tugas Cloud Run

  2. Klik tugas untuk menampilkan daftar eksekusi.

  3. Di halaman detail eksekusi, pilih eksekusi yang Anda minati dari daftar. Anda dapat memfilter menurut kriteria secara opsional.

gcloud

  • Untuk mencantumkan semua eksekusi tugas untuk semua tugas pada project Anda, jalankan perintah berikut:

    gcloud run jobs executions list
  • Untuk mencantumkan hanya eksekusi untuk tugas tertentu, jalankan perintah berikut:

    gcloud run jobs executions list --job JOB

    Ganti JOB 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 --format="value(status.latestCreatedExecution.name)"

    Ganti JOB dengan nama tugas yang sedang Anda filter.

Atau, untuk melihat detail eksekusi tugas terbaru, lihat Melihat detail eksekusi tugas.

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/executions

Ganti kode berikut:

  • ACCESS_TOKEN: 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.
  • PROJECT_ID: Google Cloud Project ID
  • REGION: Google Cloud region tugas.
  • JOB: nama tugas Cloud Run Anda.

Tampilan detail eksekusi tugas

Anda dapat melihat detail eksekusi tugas untuk 1.000 eksekusi tugas yang paling baru menggunakan panel detail eksekusi. 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.

Anda dapat melihat detail selengkapnya tentang eksekusi tugas menggunakan konsol Google Cloud , gcloud CLI, library klien, atau REST API:

Konsol

Untuk melihat detail pengerjaan tugas tertentu:

  1. Di konsol Google Cloud , buka halaman tugas Cloud Run:

    Buka 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. Lihat tab Tasks, Containers, Volumes, Networking, Security, dan YAML untuk mengetahui detail selengkapnya.

gcloud

Untuk melihat detail tentang eksekusi tugas, jalankan perintah berikut:

  • Untuk mendeskripsikan eksekusi tugas tertentu:

    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
  • Untuk mendeskripsikan eksekusi terbaru suatu tugas:

    gcloud run jobs executions describe-latest --job=JOB

    Ganti JOB dengan nama tugas.

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/executions/EXECUTION_NAME

Ganti kode berikut:

  • ACCESS_TOKEN: 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.
  • PROJECT_ID: Google Cloud Project ID
  • REGION: Google Cloud region tugas.
  • JOB: nama tugas Cloud Run Anda.
  • EXECUTION_NAME: nama eksekusi tugas.

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. Di konsol Google Cloud , buka halaman tugas Cloud Run:

    Buka tugas Cloud Run

  2. Klik tugas untuk membuka panel detail tugas.

  3. Pilih eksekusi tugas yang ingin Anda hapus.

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

  5. Jika diminta untuk mengonfirmasi penghapusan, klik Confirm.

gcloud

Untuk menghapus eksekusi tugas, ikuti langkah-langkah berikut:

  1. Jalankan perintah berikut:

    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 Cloud Run Admin API jobs.

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/executions/EXECUTION_NAME

Ganti kode berikut:

  • ACCESS_TOKEN: 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.
  • PROJECT_ID: Google Cloud Project ID
  • REGION: Google Cloud region tugas.
  • JOB: nama tugas Cloud Run Anda.
  • EXECUTION_NAME: nama eksekusi tugas.