יצירת משרות

המסוף

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

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

   כניסה לדף Cloud Run jobs

2. לוחצים על Deploy container כדי להציג את הטופס Create job.

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

4. שם המשימה נוצר אוטומטית מקובץ האימג' בקונטיינר. אפשר לערוך את שם המשרה לפי הצורך בטופס. אחרי ששולחים את הטופס, אי אפשר לערוך את שם המשרה.

5. בשדה Region, משתמשים בערך ברירת המחדל.

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

7. לוחצים על Containers, Networking, Security כדי להגדיר מאפיינים נוספים של המשימה.

8. בקטע Edit container (עריכת מאגר התגים), אפשר להגדיר את ההגדרות הבאות בכרטיסיות המתאימות:

   • הגדרת מאגר התגים
   • מגבלות על יחידת העיבוד המרכזית (CPU)
   • מגבלות זיכרון
   • סודות
   • משתני סביבה
   • תוויות
   • חשבונות שירות
   • חיבורים ל-Cloud SQL
   • קישוריות VPC

9. בקטע Task capacity (קיבולת המשימות), מציינים את הפרטים הבאים:

   1. בשדה Task timeout (זמן קצוב לתפוגת משימה), מציינים את משך הזמן המקסימלי בשניות שהמשימה יכולה לפעול, עד 168 שעות (7 ימים). במשימות שמשתמשות ב-GPU, הזמן הקצוב המקסימלי הוא שעה. כל משימה חייבת להסתיים תוך פרק הזמן הזה. ברירת המחדל היא 10 דקות.

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

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

11. כשמסיימים להגדיר את העבודה, לוחצים על יצירה כדי ליצור את העבודה ב-Cloud Run.

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

gcloud

כדי להשתמש בשורת הפקודה, צריך להגדיר את ה-CLI של gcloud.

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

1. מריצים את הפקודה:

   gcloud run jobs create JOB --image IMAGE_URL OPTIONS

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

   gcloud run jobs deploy JOB --image IMAGE_URL OPTIONS

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

   • ‫JOB: השם של המשימה ב-Cloud Run.
   • ‫IMAGE_URL: הפניה לקובץ אימג' של קונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.

   • OPTIONS (אופציונלי): אחת מהאפשרויות הבאות:

     אפשרות	תיאור
     --tasks	הפונקציה מקבלת מספרים שלמים שגדולים מ-1 או שווים לו. ברירת המחדל היא 1, והערך המקסימלי הוא 10,000. כל משימה מקבלת את משתני הסביבה CLOUD_RUN_TASK_INDEX עם ערך בין 0 למספר המשימות פחות 1, וגם את CLOUD_RUN_TASK_COUNT, שהוא מספר המשימות.
     --max-retries	מספר הפעמים שמערכת מנסה לבצע משימה שנכשלה. אם משימה כלשהי נכשלת מעבר למגבלה הזו, כל העבודה מסומנת כנכשלה. לדוגמה, אם הערך הוא 1, המערכת תנסה להפעיל מחדש משימה שנכשלה פעם אחת, כך שיהיו שתי הפעלות בסך הכול. ערך ברירת המחדל הוא 3. אפשר להזין מספרים שלמים מ-0 עד 10.
     --task-timeout	אפשר להזין משך זמן כמו '2s'. ברירת המחדל היא 10 דקות, והמקסימום הוא 168 שעות (7 ימים). במשימות שמשתמשות במעבדי GPU, הזמן הקצוב לתפוגה המקסימלי הוא שעה אחת.
     --parallelism	המספר המקסימלי של משימות שאפשר להריץ במקביל. כברירת מחדל, המשימות יתחילו במקביל כמה שיותר מהר. במאמר בנושא מקביליות מפורט טווח הערכים.
     --execute-now	אם מוגדר, מיד אחרי יצירת המשימה מתחיל ביצוע המשימה. שווה ערך לקריאה ל-gcloud run jobs create ואז ל-gcloud run jobs execute.

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

     רשימה מלאה של האפשרויות הזמינות ליצירת משימה מופיעה במאמר בנושא הפקודה gcloud run jobs create.

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

3. כדי להריץ את המשימה, קראו את המאמרים הרצת משימות או הרצת משימות לפי לוח זמנים.

YAML

אפשר לשמור את מפרט העבודה בקובץ YAML ואז לפרוס אותו באמצעות ה-CLI של gcloud.

1. יוצרים קובץ job.yaml חדש עם התוכן הזה:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE_URL

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

   • ‫JOB: השם של המשימה ב-Cloud Run.
   • ‫IMAGE_URL: הפניה לקובץ אימג' של קונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.

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

2. מריצים את הפקודה הבאה כדי לפרוס את המשימה החדשה:

   gcloud run jobs replace job.yaml

Terraform

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

ספריות לקוח

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

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

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

כדי ליצור משימה, שולחים POST בקשת HTTP אל נקודת הקצה (endpoint) של Cloud Run Admin API‏ jobs.

לדוגמה, באמצעות curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון עם הרשאות IAM ליצירת משימות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מכונה של קונטיינר ב-Cloud Run, אתם יכולים לאחזר אסימון גישה באמצעות שרת המטא-נתונים של המכונה של הקונטיינר.
• ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
• ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance .
• ‫REGION: Cloud de Confiance האזור של המשימה.
• ‫JOB: השם של העבודה שרוצים ליצור.

המסוף

כדי לעדכן משרה קיימת:

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

   כניסה לדף Cloud Run jobs

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

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

4. אופציונלי: משנים את מספר המשימות במשימה לפי הצורך.

5. אופציונלי: לוחצים על Containers, Networking, Security כדי לעדכן מאפיינים נוספים של המשימה:

   • הגדרת מאגר התגים
   • מגבלות על יחידת העיבוד המרכזית (CPU)
   • מגבלות זיכרון
   • Secrets
   • משתני סביבה
   • תוויות
   • חשבונות שירות
   • חיבורים ל-Cloud SQL
   • קישוריות VPC

6. בקטע Task capacity (קיבולת המשימות), מציינים את הפרטים הבאים:

   1. בשדה Task timeout (זמן קצוב לתפוגת משימה), מציינים את משך הזמן המקסימלי בשניות שהמשימה יכולה לפעול, עד 168 שעות (7 ימים). במשימות שמשתמשות ב-GPU, הזמן הקצוב המקסימלי הוא שעה. כל משימה חייבת להסתיים תוך פרק הזמן הזה. ברירת המחדל היא 10 דקות.

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

7. בקטע Parallelism, בוחרים באפשרות Run as many tasks concurrently as possible אם צריך להגדיר מגבלה נמוכה יותר בגלל אילוצי התאמה לעומס (scaling) במשאבים שאליהם המשימה ניגשת, או בוחרים באפשרות Limit the maximum number of concurrent tasks ומציינים את מספר המשימות בו-זמנית בשדה Custom parallelism limit.

8. כשמסיימים להגדיר את העבודה, לוחצים על Update כדי לשנות את העבודה ב-Cloud Run ומחכים עד ליצירת העבודה.

9. כדי להריץ את המשימה, קראו את המאמרים הרצת משימות או הרצת משימות לפי לוח זמנים.

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. מריצים את הפקודה הבאה:

   gcloud run jobs update JOB

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

   • ‫JOB: השם של המשימה ב-Cloud Run.

   • OPTIONS (אופציונלי): עם האפשרויות הבאות:

     אפשרות	תיאור
     --tasks	אפשר להזין מספרים שלמים ששווים ל-1 או גדולים ממנו. ברירת המחדל היא 1, והערך המקסימלי הוא 10,000. כל משימה מקבלת את משתני הסביבה CLOUD_RUN_TASK_INDEX עם ערך בין 0 למספר המשימות פחות 1, וגם את CLOUD_RUN_TASK_COUNT, שהוא מספר המשימות.
     --max-retries	מספר הפעמים שמערכת מנסה לבצע מחדש משימה שנכשלה. אם משימה כלשהי נכשלת מעבר למגבלה הזו, כל העבודה מסומנת כנכשלה. לדוגמה, אם הערך מוגדר כ-1, המערכת תנסה לבצע משימה שנכשלה פעם אחת, כך שיהיו בסך הכול שני ניסיונות. ערך ברירת המחדל הוא 3. אפשר להזין מספרים שלמים מ-0 עד 10.
     --task-timeout	אפשר להזין משך זמן כמו '2s'. ברירת המחדל היא 10 דקות, והמקסימום הוא 168 שעות (7 ימים).
     --parallelism	המספר המקסימלי של משימות שאפשר להריץ במקביל. כברירת מחדל, המשימות יתחילו כמה שיותר מהר, במקביל. במאמר בנושא מקביליות מפורט טווח הערכים.

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

   • הגדרת מאגר התגים
   • מגבלות על יחידת העיבוד המרכזית (CPU)
   • מגבלות זיכרון
   • Secrets
   • משתני סביבה
   • תוויות
   • חשבונות שירות
   • חיבורים ל-Cloud SQL
   • חיבור VPC

   רשימה מלאה של האפשרויות הזמינות ליצירת משימה מופיעה במאמר בנושא הפקודה gcloud run jobs create.

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

   Job [JOB] has been successfully updated.
   View details about this job by running `gcloud run jobs describe JOB`.
   See logs for this execution at: https://console.cloud.s3nscloud.fr/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB

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

YAML

1. אם אתם צריכים להוריד או להציג את ההגדרות של משימה קיימת, מריצים את הפקודה הבאה כדי לשמור את התוצאות בקובץ YAML:

   gcloud run jobs describe JOB --format export > job.yaml

2. משנים את מאפייני הצאצא spec.template לפי הצורך, ואז פורסים מחדש על ידי הפעלת הפקודה הבאה:

   gcloud run jobs replace job.yaml

   אם קיים קובץ job.yaml, הפקודה gcloud run jobs replace משתמשת בו כברירת מחדל.

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

Terraform

משנים את הגדרות המשימה בקובץ main.tf באמצעות הפקודה terraform apply. הוראות מפורטות ל-Terraform זמינות עבור:

• מקביליות
• מספר הניסיונות המקסימלי
• חסימת האפשרות לפרסם תגובות

מידע נוסף זמין באפשרויות של שורת הפקודה terraform apply.

ספריות לקוח

כדי לעדכן משימה קיימת מקוד:

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

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

כדי לעדכן משימה, שולחים בקשת HTTP אל נקודת הקצה jobs של Cloud Run Admin API‏ PATCH.

לדוגמה, שימוש ב-curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB

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

• ‫ACCESS_TOKEN: אסימון גישה תקין לחשבון עם הרשאות IAM לעדכון משימות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• ‫IMAGE_URL: הפניה לקובץ אימג' של קונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
• ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance .
• ‫REGION: Cloud de Confiance האזור של המשימה.
• ‫JOB: השם של המשימה שרוצים לעדכן.

המסוף

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

   כניסה לדף Cloud Run jobs

2. כדי לפרוס למשרה קיימת, לוחצים על משרות. מאתרים את המשימה ברשימת המשימות ולוחצים עליה כדי לפתוח אותה. לאחר מכן לוחצים על View and edit configuration (הצגה ועריכה של ההגדרות) כדי להציג את הטופס לעריכת המשימה.

3. כדי ליצור משימה חדשה, לוחצים על Deploy container (פריסת קונטיינר). צריך לספק את כתובת ה-URL של קובץ אימג' של קונטיינר ואת שם הג'וב.

4. לוחצים על Containers, Networking, Security.

5. בכרטיס Edit container (עריכת מאגר), מגדירים את מאגר המשימות הראשי לפי הצורך.

6. לוחצים על Add container (הוספת מאגר תגים) ומגדירים מאגר תגים מסוג sidecar שרוצים להוסיף לצד מאגר התגים הראשי של המשימה. אם ה-sidecar תלוי בקונטיינר אחר בשירות, מציינים זאת בתפריט הנפתח Container start-up order. חוזרים על השלב הזה לכל קובץ sidecar שפורסים.

7. לוחצים על Create לשירות חדש או על Update למשימה קיימת, וממתינים לסיום הפריסה.

gcloud

1. מפעילים את Cloud Shell במסוף Cloud de Confiance .

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

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

   gcloud run jobs create JOB \
    --container JOB_CONTAINER_NAME \
    --image='IMAGE_URL' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

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

   • ‫JOB: השם של המשימה ב-Cloud Run.
   • ‫JOB_CONTAINER_NAME: שם לקונטיינר של המשימה הראשית.
   • ‫IMAGE_URL: הפניה לקובץ אימג' של קונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
   • ‫SIDECAR_CONTAINER_NAME: שם של קונטיינר ה-sidecar, לדוגמה sidecar.
   • ‫SIDECAR_IMAGE: הפניה לקובץ האימג' של הקונטיינר המשני (sidecar).

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

   gcloud run jobs create JOB \
     --container CONTAINER_1_NAME \
     --image='IMAGE_URL' \
     --set-env-vars=KEY=VALUE \
     --container SIDECAR_CONTAINER_NAME \
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

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

YAML

1. אם אתם יוצרים משרה חדשה, דלגו על השלב הזה. אם אתם מעדכנים משימה קיימת, אתם צריכים להוריד את הגדרת ה-YAML שלה:

   gcloud run jobs describe JOB --format export > job.yaml

2. מעדכנים את המאפיינים containers::

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
         - image: SIDECAR_IMAGE
   

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

   • ‫JOB: השם של המשימה ב-Cloud Run.
   • ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
   • ‫SIDECAR_IMAGE: הפניה לקובץ אימג' של קונטיינר sidecar.

3. יוצרים או מעדכנים את המשימה באמצעות הפקודה הבאה:

   gcloud run jobs replace job.yaml

   כברירת מחדל, הפקודה gcloud run jobs replace משתמשת בקובץ job.yaml אם הוא קיים.

Terraform

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB"
  location = "europe-west1"

  template {
    template {
      containers {
        name = "CONTAINER_NAME"
        image = "IMAGE_URL"
      }
      containers {
        name = "SIDECAR_CONTAINER_NAME"
        image = "SIDECAR_IMAGE_URL"
      }
    }
  }
}

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

• ‫JOB: השם של המשימה ב-Cloud Run.
• ‫CONTAINER_NAME: השם של הקונטיינר.
• ‫IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
• ‫SIDECAR_CONTAINER_NAME: השם של הקונטיינר המשני (sidecar).
• ‫SIDECAR_IMAGE_URL: הפניה לקובץ אימג' של קונטיינר sidecar.