Mengelola tugas

Halaman ini menjelaskan bagaimana cara mengelola tugas. Ikuti petunjuk untuk membuat tugas di Cloud Scheduler. Untuk mengeksekusi tugas, lihat Menyetujui tugas.

Beri tag dan ringkasan image container untuk tugas Cloud Run

Bagaimana memperbarui tugas untuk menjalankan versi terbaru dari kode Anda tergantung pada apakah image container Anda terspesifikasi dengan tag atau ringkasan.

Anda dapat menentukan image container dengan tag (misalnya, gcr.io/my-project/my-image:tag) atau dengan ringkasan yang tepat (misalnya, gcr.io/my-project/my-image@sha256:41f34ab970ee...). Jika Anda tidak menentukan image container, :latest fungsi tersebut akan memproses semua instance Realtime Database di region fungsi.

Jika Anda menentukan image container dengan tag, Cloud Run akan menyelesaikan gambar Anda ke ringkasan spesifik saat menyetujui tugas. Artinya, Anda tidak perlu memperbarui tugas secara eksplisit untuk mengambil versi terbaru container saat Anda menyetujui tugas.

Jika lebih memilih tugas Anda untuk menggunakan ringkasan container tertentu setiap kali dikerjakan, Anda dapat menentukan image container dengan ringkasan yang tepat. Dalam hal ini, Anda harus secara eksplisit memperbarui tugas untuk menggunakan ringkasan yang berbeda jika ingin tugas Anda mengambil perubahan kode yang dibuat:

gcloud run jobs update JOB_NAME --image IMAGE_URL

Ganti

  • JOB_NAME dengan nama huruf kecil tanpa garis bawah
  • IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/job:latest

Apa pun cara Anda menentukan image container, semua tugas yang dikerjakan akan selalu menggunakan ringkasan image container yang sama.

Melihat tugas di project Anda

Anda dapat melihat daftar tugas dalam project menggunakan command line gcloud:

Konsol

Untuk melihat tugas:

  1. Buka halaman tugas Cloud Run.

  2. Anda juga bisa memfilter tugas berdasarkan salah satu kriteria di menu dropdown, seperti nama tugas, waktu pengerjaan, region, dan sebagainya.

Command line

  1. Untuk menampilkan daftar semua tugas dalam project Anda:

    gcloud run jobs list
  2. Untuk memfilter tugas menurut region:

    gcloud run jobs list --region REGION

    Ganti REGION dengan nama bucket Anda us-central1.

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

Library klien

Untuk melihat tugas di project Anda dari kode:

REST API

Untuk melihat daftar tugas dalam project Anda, 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

Ganti:

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

Melihat detail tugas

Gunakan command line gcloud untuk melihat detail tugas lebih lanjut.

Konsol

Untuk melihat detail pengerjaan tugas tertentu:

  1. Buka halaman tugas Cloud Run

  2. Temukan tugas yang Anda minati.

  3. Klik tugas untuk menampilkan daftar pengerjaan.

  4. Catat Histori, Konfigurasi, Log, dan YAML.

    • Histori menampilkan informasi tentang pengerjaan tugas.
    • Log menampilkan informasi log.
    • Konfigurasi menampilkan informasi tentang tugas, container, keamanan, konektivitas, dan sebagainya.
    • YAML menampilkan konfigurasi tugas dalam format YAML.

Command line

Untuk melihat detail tugas:

Gunakan perintah:

gcloud run jobs describe  JOB_NAME

Ganti JOB_NAME dengan nama tugas.

Library klien

Untuk melihat detail tugas dari kode:

REST API

Untuk melihat detail tentang 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

Ganti:

  • ACCESS_TOKEN dengan token akses yang valid untuk akun yang memiliki izin IAM untuk melihat detail tugas. Misalnya, jika Anda 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.

Menghapus tugas

Anda dapat menghapus tugas hanya jika tidak ada pengerjaan tugas yang sedang berjalan.

Meskipun tugas yang dihapus tidak lagi muncul dalam daftar pengerjaan, log-nya akan terus tersedia di Cloud Logging selama sisa periode retensi log, dan pantauan data akan terus tersedia di Cloud Monitoring.

Konsol

Untuk menghapus tugas:

  1. Buka halaman tugas Cloud Run

  2. Pilih tugas.

  3. Klik Delete.

Command line

Untuk menghapus tugas:

  1. Gunakan perintah:

    gcloud run jobs delete JOB_NAME

    Ganti JOB_NAME dengan nama tugas.

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

Library klien

Untuk menghapus tugas dari kode:

REST API

Untuk menghapus 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

Ganti:

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