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

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

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לניהול משימות של Cloud Run, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד Cloud Run Developer (roles/run.developer) במשימה של Cloud Run.

רשימת ההרשאות והתפקידים ב-IAM שמשויכים ל-Cloud Run מופיעה במאמרים תפקידי IAM ב-Cloud Run והרשאות IAM ב-Cloud Run. אם עבודת Cloud Run שלכם מתקשרת עםGoogle Cloud ממשקי API, כמו ספריות לקוח ב-Cloud, כדאי לעיין במדריך להגדרת זהות שירות. מידע נוסף על מתן תפקידים זמין במאמרים הרשאות פריסה וניהול גישה.

הצגת הרצות של משימות בפרויקט

אפשר לראות רשימה של הפעלות המשימות בפרויקט באמצעותGoogle Cloud מסוף Google Cloud או Google Cloud CLI:

המסוף

כדי לראות את רשימת ההרצות של משימה:

1. כניסה לדף Cloud Run jobs

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

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

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

gcloud

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

gcloud run jobs executions list

כדי להציג רק את ההרצות של משימה ספציפית:

gcloud run jobs executions list --job JOB_NAME

מחליפים את JOB_NAME בשם המשימה שלפיה רוצים לסנן.

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

כדי לקבל את השם של ההרצה האחרונה של משימה ספציפית, משתמשים בדגל --format:

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

מחליפים את JOB_NAME בשם המשימה שלפיה רוצים לסנן.

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

ספריות לקוח

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

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי להציג רשימה של הפעלות של משימות, שולחים בקשת HTTP‏ GET לנקודת הקצה jobs של Cloud Run Admin API.

לדוגמה, באמצעות 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

מחליפים את:

• ‫ACCESS_TOKEN עם טוקן גישה תקין לחשבון שיש לו הרשאות IAM לצפייה בהפעלות של משימות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• JOB-NAME בשם של העבודה.
• ‫REGION עם האזור של המשרה. Google Cloud
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud

הצגת פרטי הביצוע של המשימה

אפשר לראות את פרטי ההפעלה של המשימה עבור 1,000 ההפעלות האחרונות של משימה באמצעות חלונית פרטי ההפעלה. פרטי הביצוע הישנים מוסרים ולא מוצגים יותר בחלונית פרטי הביצוע. עם זאת, נתוני היומנים והמעקב של הרצות ישנות יותר עדיין זמינים ב-Cloud Logging וב-Cloud Monitoring, בכפוף למדיניות שמירת הנתונים של המוצרים האלה.

אפשר להשתמש במסוף Google Cloud או ב-Google Cloud CLI כדי לראות פרטים נוספים על ביצוע של משימה.

המסוף

כדי לראות את הפרטים של הפעלת משימה ספציפית:

1. כניסה לדף Cloud Run jobs

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

3. לוחצים על ההפעלה של העבודה שרוצים לראות. פרטי ההרצה מוצגים בחלונית השמאלית.

4. שימו לב לכרטיסיות Tasks,‏ Containers,‏ Volumes,‏ Networking,‏ Security ו-YAML, וגם לקישור View Logs.

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

gcloud

כדי לראות פרטים על הפעלת משימה, מריצים את הפקודות הבאות:

• כדי לתאר ביצוע ספציפי של עבודה:

  gcloud run jobs executions describe EXECUTION_NAME

  מחליפים את EXECUTION_NAME בשם ההפעלה.

  אפשר להשתמש בדגל --format כדי לעצב את הפלט ולקבל מידע נוסף. לדוגמה, ב-YAML:

  gcloud run jobs executions describe EXECUTION_NAME --format yaml

• כדי לתאר את ההפעלה האחרונה של משימה:

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

  מחליפים את JOB_NAME בשם של המשימה.

ספריות לקוח

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

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי לראות את פרטי ההפעלה של העבודה, שולחים GET בקשת HTTP לנקודת הקצה jobs של Cloud Run Admin API.

לדוגמה, באמצעות 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

מחליפים את:

• ‫ACCESS_TOKEN עם טוקן גישה תקין לחשבון שיש לו הרשאות IAM לצפייה בפרטי ההרצה של העבודות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• JOB-NAME בשם של העבודה.
• EXECUTION-NAME בשם של ביצוע העבודה.
• ‫REGION עם האזור של המשרה. Google Cloud
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud

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

אפשר למחוק ביצוע של עבודה, גם במהלך הביצוע. אם מוחקים ביצוע, הוא מפסיק את המשך הביצוע.

הערה: לשם השוואה, אם משתמשים בשיטת cancel של הפעלת העבודה כדי להפסיק את הפעלת העבודה הנוכחית, הפעלת העבודה נשארת ברשימת הפעלות העבודה.

גם אם ביצעתם מחיקה של הפעלה, היא לא תופיע ברשימת ההפעלות, אבל היומנים שלה ימשיכו להיות זמינים ב-Cloud Logging למשך יתרת תקופת השמירה של היומן, ונתוני המעקב ימשיכו להיות זמינים ב-Cloud Monitoring.

המסוף

כדי למחוק הרצת משימה:

1. כניסה לדף Cloud Run jobs

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

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

4. בתפריט פעולות, לוחצים על סמל האפשרויות הנוספות (3 נקודות) ואז על מחיקה.

5. אם מוצגת בקשה לאישור המחיקה, לוחצים על אישור.

gcloud

כדי למחוק הרצת משימה:

1. משתמשים בפקודה:

   gcloud run jobs executions delete EXECUTION_NAME

   מחליפים את EXECUTION_NAME בשם ההפעלה.

2. אם מוצגת בקשה לאישור, משיבים y. אם הפעולה תצליח, תוצג הודעה על כך.

ספריות לקוח

כדי למחוק הפעלה של משימה מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

‫API בארכיטקטורת REST

כדי למחוק הפעלה של עבודה, שולחים בקשת HTTP לנקודת הקצה של Cloud Run Admin API jobsDELETE

לדוגמה, באמצעות 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

מחליפים את:

• ‫ACCESS_TOKEN עם טוקן גישה תקין לחשבון שיש לו הרשאות IAM למחיקת הפעלות של משימות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• JOB_NAME בשם של העבודה.
• EXECUTION-NAME בשם של ביצוע העבודה.
• ‫REGION עם האזור של המשרה. Google Cloud
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud