ניהול תורים ומשימות

באמצעות Cloud Tasks אתם יכולים לשלוט בביצוע של עומסי עבודה אסינכרוניים, להשהות את העיבוד של התור ולפתור בעיות בתהליכי עבודה פעילים. אתם יכולים להגדיר ולתחזק את התורים והמשימות באמצעות מסוף Google Cloud , ה-CLI של Google Cloud או Cloud Tasks API.

לפני שמתחילים

  1. מוודאים שיש לכם תור משימות קיים ב-Cloud Tasks. למידע נוסף, ראו יצירת תורי משימות ב-Cloud Tasks.
  2. מוודאים שיש לכם את התפקידים הנדרשים בניהול זהויות והרשאות גישה (IAM) כדי לנהל תורים ומשימות, כמו אדמין של Cloud Tasks‏ (roles/cloudtasks.admin), אדמין של תור ב-Cloud Tasks‏ (roles/cloudtasks.queueAdmin) או מחיקת משימות ב-Cloud Tasks‏ (roles/cloudtasks.taskDeleter).

מחיקת משימה מתור

אתם יכולים למחוק משימה אם היא מתוזמנת או נשלחה. לדוגמה, יכול להיות שתצטרכו למחוק משימה שלא ניתן להשלים אותה, לא משנה כמה פעמים תנסו. אי אפשר למחוק משימה אם היא הושלמה בהצלחה או אם היא נכשלה באופן עקבי ונגמרו ניסיונות ההפעלה החוזרים שלה. משימה נמחקת באופן אוטומטי אם מגיעים למגבלה של שמירת המשימות המקסימלית.

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Tasks > Queues.

    מעבר לתורים

  2. לוחצים על שם התור של המשימה שרוצים למחוק.

  3. מסמנים את התיבה של המשימה שרוצים למחוק.

  4. לוחצים על מחיקת המשימה.

  5. בהודעה שמופיעה, לוחצים על מחיקה.

gcloud

מוחקים משימה באמצעות הפקודה gcloud tasks delete:

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫TASK_NAME: המזהה או שם המשאב המלא של המשימה שרוצים למחוק.
  • ‫QUEUE_ID: שם התור שהמשימה שייכת אליו
  • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

REST

כדי למחוק משימה, משתמשים ב-method‏ projects.locations.queues.tasks.delete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫QUEUE_ID: שם התור שהמשימה שייכת אליו
  • ‫TASK_NAME: שם המשימה שרוצים למחוק.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫LOCATION: האזור שבו נמצא התור, לדוגמה us-central1

גוף הבקשה צריך להיות ריק.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אם הפעולה בוצעה ללא שגיאות, גוף התגובה ריק.

מחיקת קבוצת משימות מתור

כדי למחוק קבוצה של משימות מתור, אפשר להשתמש ב-method‏ projects.locations.queues.tasks.batchDelete כדי למחוק רשימה של שמות משימות.

שימו לב לנקודות הבאות:

  • צריך למחוק את כל המשימות מאותו תור.

  • יש הגבלה על מספר המשימות שאפשר למחוק באצווה אחת. מידע נוסף זמין במאמר מכסות ומגבלות.

  • בקשות Batch, שצוברות פעולות נפרדות לבקשה אחת, הן לא אטומיות כי יכול להיות שחלק מהפעולות שכלולות ב-Batch ייכשלו ואחרות יצליחו.

  • אפשר למחוק משימה רק אם היא מתוזמנת או נשלחה. אי אפשר למחוק משימה אם היא הושלמה בהצלחה או אם היא נכשלה באופן עקבי ונגמרו ניסיונות ההרצה שלה. משימה נמחקת באופן אוטומטי אם מגיעים למגבלה של שמירת המשימות המקסימלית.

  • אפשר גם ליצור קבוצה של משימות. מידע נוסף זמין במאמר יצירת קבוצת משימות.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫TASK_NAME: שם המשימות שרוצים למחוק, בפורמט הבא: projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫REGION: האזור שבו נמצא התור, לדוגמה us-central1
  • ‫QUEUE_ID: שם התור שאליו שייכות המשימות

גוף הבקשה מכיל רשימה של שמות משימות.

תוכן בקשת JSON:

{
  "names": [
    "TASK_NAME"
  ]
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
  },
  "done": false
}

מחיקת כל המשימות מתור מסוים

אתם יכולים למחוק את כל המשימות מתור על ידי מחיקה סופית שלהן. כל המשימות שנוצרו לפני קריאת הניקוי נמחקות באופן סופי. עם זאת, יכול להיות שיעבור עד דקה עד שהמשימות יימחקו, וייתכן שהן יישלחו לפני שהמחיקה תיכנס לתוקף.

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Tasks > Queues.

    מעבר לתורים

  2. לוחצים על שם התור של המשימות שרוצים למחוק.

  3. לוחצים על Purge queue.

  4. בהודעה, לוחצים על מחיקה.

gcloud

מנקים תור באמצעות הפקודה gcloud tasks queues purge:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫QUEUE_ID: שם התור שרוצים לנקות
  • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

REST

כדי לנקות תור, משתמשים ב-method‏ projects.locations.queues.purge.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫QUEUE_ID: שם התור שרוצים לנקות
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

גוף הבקשה צריך להיות ריק.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Queue:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING",
  "purgeTime": "2025-03-28T13:06:30.110255Z"
}

השהיה או המשך של תורים

אפשר להשהות או להמשיך את התור. השהיית תור מפסיקה את הביצוע והשליחה של המשימות. עדיין אפשר ליצור משימות ולהוסיף אותן לתור, אבל המשימות לא יעובדו עד שהתור יופעל מחדש. כשממשיכים את התור, Cloud Tasks מתחיל לשלוח משימות בצבר ללא סדר ביצוע מוגדר. אם אתם מחדשים תורים עם תנועה גבוהה וצבר משימות גדול, פעלו לפי ההנחיות להגברת העומס כדי למנוע עומס יתר על היעד.

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Tasks > Queues.

    מעבר לתורים

  2. מסמנים את התיבה של התור שרוצים להשהות או להפעיל מחדש.

  3. כדי להשהות את התור, לוחצים על השהיית התור ואז על השהיה בהודעה שמופיעה.

  4. כדי להמשיך תור שהושהה, לוחצים על Resume queue.

gcloud

  1. משהים תור באמצעות הפקודה gcloud tasks queues pause:

    gcloud tasks queues pause QUEUE_ID \
        --location=LOCATION

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫QUEUE_ID: שם התור שרוצים להשהות
    • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1
  2. ממשיכים את התור באמצעות הפקודה gcloud tasks queues resume:

    gcloud tasks queues resume QUEUE_ID \
        --location=LOCATION

REST

  1. כדי להשהות תור, משתמשים ב-method‏ projects.locations.queues.pause.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫QUEUE_ID: שם התור שרוצים להשהות
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
    • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

    גוף הבקשה צריך להיות ריק.

    כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

    אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Queue:

    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "PAUSED"
    }
    

  2. כדי להמשיך את התור, משתמשים ב-method‏ projects.locations.queues.resume.

    לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

    • ‫QUEUE_ID: שם התור שרוצים להמשיך את העיבוד שלו
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
    • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

    גוף הבקשה צריך להיות ריק.

    כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

    אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Queue:

    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "RUNNING"
    }
    

הצגת רשימת תורים

אתם יכולים להציג רשימה של תורים. כשמציגים תורים, מוחזרים פרטים מסוימים של הגבלת קצב של יצירת בקשות ופרמטר ניסיון חוזר. שימו לב שהשדות הבאים זהים:

  • ‫Max rate (מסוף), MAX_RATE (gcloud),‏ maxDispatchesPerSecond (REST)
  • ‫Max concurrent (מסוף), MAX_NUM_OF_TASKS (gcloud),‏ maxConcurrentDispatches (REST)

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Tasks > Queues.

    מעבר לתורים

    כל התורים בפרויקט ב- Google Cloud מופיעים ברשימה.

  2. כדי לראות פרטים נוספים, לוחצים על שם התור ואז על הכרטיסייה Configuration.

    מוצגים פרטים על הגבלת קצב של יצירת בקשות ועל הפרמטרים של ניסיון חוזר.

gcloud

מציגים את רשימת התורים באמצעות הפקודה gcloud tasks queues list:

gcloud tasks queues list \
    --location=LOCATION

מחליפים את LOCATION באזור שבו נפרס התור, לדוגמה us-central1. אם לא מציינים מיקום, המערכת משתמשת במיקום של אפליקציית App Engine של הפרויקט ב- Google Cloud , אם היא קיימת. אחרת, צריך לציין מיקום.

הפלט אמור להיראות כך:

QUEUE_NAME: my-queue
STATE: PAUSED
MAX_NUM_OF_TASKS: 1000
MAX_RATE (/sec): 500.0
MAX_ATTEMPTS: 100
...

REST

כדי להציג רשימה של תורים, משתמשים ב-method‏ projects.locations.queues.list.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
  • ‫LOCATION: האזור שבו נוצרו התורים, לדוגמה us-central1.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל מופעים של משאבי Queue, והתשובה אמורה להיות דומה לדוגמה הבאה:

{
  "queues": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "PAUSED",
      "purgeTime": "2025-03-28T13:37:32.292552Z"
    },
    ...
  ],
  "nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}

מחיקת תורים

אתם יכולים למחוק כל תור כשאתם לא צריכים אותו יותר, חוץ מהתור default של App Engine. אחרי שמוחקים תור, צריך לחכות 3 ימים לפני שיוצרים אותו מחדש עם אותו שם. תקופת ההמתנה הזו חלה על תורים שנמחקו דרך כל ממשק, כולל מסוף Google Cloud , ה-CLI של gcloud, ה-API ל-REST או ל-RPC או Terraform. כך אפשר למנוע התנהגות לא צפויה במשימות שפועלות בזמן המחיקה, ולמנוע כשלים בתהליכים פנימיים במהלך מחזור המחיקה והיצירה מחדש.

במהלך חלון הזמן הזה של עד 3 ימים, יכול להיות שבקשה ליצירת תור תיראה כאילו היא הצליחה, בלי ליצור מחדש את התור. כדי לוודא שהתור נוצר מחדש עם אותו שם, מאחזרים את התור באמצעות הפקודה gcloud tasks queues describe או השיטה projects.locations.queues.get. תגובה מוצלחת (200 OK) מאשרת שהתור נוצר מחדש.

כדי לנקות משימות, לשנות הגדרות של תורים או לנהל תורים בצינורות עיבוד נתונים של CI/CD בלי לאבד את התור או להפעיל את תקופת ההמתנה של 3 ימים, השתמשו בחלופות הבאות במקום למחוק וליצור מחדש תור:

כדי למחוק תור, משתמשים במסוף Google Cloud , ב-CLI של gcloud או ב-Cloud Tasks API:

המסוף

  1. במסוף Google Cloud , נכנסים לדף Cloud Tasks > Queues.

    מעבר לתורים

  2. מסמנים את התיבה של התור שרוצים למחוק.

  3. לוחצים על Delete queue.

  4. מזינים את שם התור ולוחצים על Confirm.

gcloud

מוחקים תור באמצעות הפקודה gcloud tasks queues delete:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫QUEUE_ID: המזהה או המזהה המלא של התור שרוצים למחוק.
  • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

ה-CLI של gcloud מבקש אישור לפני מחיקת התור, אלא אם מעבירים את הדגל --quiet.

REST

כדי למחוק תור, משתמשים ב-method‏ projects.locations.queues.delete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫QUEUE_ID: שם התור שרוצים למחוק
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫LOCATION: האזור שבו נפרס התור, לדוגמה us-central1

גוף הבקשה צריך להיות ריק.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אם הפעולה בוצעה ללא שגיאות, גוף התגובה ריק.

המאמרים הבאים