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

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

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

כדי לקבל את ההרשאות שדרושות לניהול משימות של 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 המסוף, ה-CLI של gcloud, ספריות לקוח או API בארכיטקטורת REST:

המסוף

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

1. במסוף Google Cloud , נכנסים לדף Cloud Run jobs:

   כניסה לדף Cloud Run jobs

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

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

gcloud

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

  gcloud run jobs executions list

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

  gcloud run jobs executions list --job JOB

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

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

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

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

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

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

ספריות לקוח

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

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

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

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

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

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

אפשר לראות פרטים נוספים על הרצת משימה באמצעות מסוף Google Cloud , ה-CLI של gcloud, ספריות לקוח או ה-API בארכיטקטורת REST:

המסוף

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

1. במסוף Google Cloud , נכנסים לדף Cloud Run jobs:

   כניסה לדף Cloud Run jobs

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

3. לוחצים על ההפעלה של העבודה שרוצים לראות. פרטי ההפעלה מוצגים בחלונית השמאלית. פרטים נוספים זמינים בכרטיסיות Tasks,‏ Containers,‏ Volumes,‏ Networking,‏ Security ו-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

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

ספריות לקוח

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

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

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

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

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

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

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

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

המסוף

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

1. במסוף Google Cloud , נכנסים לדף Cloud Run jobs:

   כניסה לדף 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 DELETE לנקודת הקצה של Cloud Run Admin API jobs.

לדוגמה, שימוש ב-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

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

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