הפעלת משימות

המסוף

כדי להריץ עבודה:

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

   כניסה לדף Cloud Run jobs

2. מאתרים את המשרה שמעניינת אתכם.

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

4. לוחצים על Execute.

gcloud

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

gcloud run jobs execute JOB

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

gcloud run jobs execute JOB --wait --region=REGION

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

gcloud beta run jobs execute JOB --tail --region=REGION

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

• ‫JOB: השם של המשימה ב-Cloud Run.
• ‫REGION: האזור שבו אפשר למצוא את המשאב. לדוגמה, europe-west1. אפשר גם להגדיר את המאפיין run/region.

ספריות לקוח

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

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

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

כדי להריץ משימה קיימת, שולחים בקשת HTTP‏ POST אל ה-method‏ jobs.run של ה-API.

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB:run

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

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

המסוף

כדי להריץ עבודה באופן מיידי:

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

   כניסה ל-Cloud Run

2. בתפריט הניווט של Cloud Run, לוחצים על Jobs (משימות):

   1. אם יוצרים משימה חדשה, לוחצים על Deploy container (פריסת מאגר תגים) כדי למלא את דף ההגדרות הראשוני של המשימה.

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

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

gcloud

אפשר לציין את הדגל --execute-now כשיוצרים או מעדכנים משימה.

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

  gcloud run jobs create JOB \
    --image IMAGE_URL \
    --execute-now \
    --region=REGION

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

  gcloud run jobs update JOB --execute-now --region=REGION

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

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

YAML

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

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

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

2. מגדירים את המאפיין startExecutionToken כמו שמוצג:

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

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

   • ‫JOB: השם של המשימה ב-Cloud Run.
   • ‫IMAGE_URL: הפניה לקובץ אימג' של קונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/job:latest.
   • ‫START_EXECUTION_SUFFIX: מחרוזת ייחודית שמשמשת כסיומת ליצירת הרצה חדשה. העבודה תהיה מוכנה כשההפעלה תתחיל בהצלחה. האורך הכולל של שם המשימה והאסימון צריך להיות קצר מ-63 תווים.

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

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

   gcloud run jobs replace job.yaml

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

Terraform

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

resource "google_cloud_run_v2_job" "default" {
   name     = "cloudrun-job"
   location = "REGION"
   deletion_protection = false
   start_execution_token = "START_EXECUTION_SUFFIX"
   template {
      template {
         containers {
         image = "us-docker.pkg.dev/cloudrun/container/job"
         }
      }
   }
}

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

• ‫REGION: Google Cloud האזור. לדוגמה, europe-west1.
• ‫START_EXECUTION_SUFFIX: מחרוזת ייחודית שמשמשת כסיומת ליצירת הרצה חדשה. הסטטוס של המשימה ישתנה ל'מוכנה' כשההפעלה תתחיל בהצלחה. האורך הכולל של שם המשרה והאסימון צריך להיות פחות מ-63 תווים.

ספריות לקוח

כדי להריץ עבודה באופן מיידי מקוד באמצעות ספריות לקוח של Cloud:

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

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

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

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{
     "template": {
        "template": {
           "containers":
              {
                 "image": "IMAGE_URL"
              }
        }
     },
     "startExecutionToken": "START_EXECUTION_SUFFIX"
  }' \
  "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.
• ‫START_EXECUTION_SUFFIX: מחרוזת ייחודית שמשמשת כסיומת ליצירת הרצה חדשה. העבודה תהיה מוכנה כשההפעלה תתחיל בהצלחה. האורך הכולל של שם המשרה והאסימון צריך להיות קצר מ-63 תווים.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫REGION: Google Cloud האזור של המשימה.
• ‫JOB: השם של המשימה ב-Cloud Run.

המסוף

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

   כניסה לדף Cloud Run jobs

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

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

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

gcloud

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

gcloud run jobs execute JOB \
     --args ARGS \
     --update-env-vars KEY=VALUE,KEY_N=VALUE_N \
     --tasks TASKS \
     --task-timeout TIMEOUT

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

• ‫JOB: השם של המשימה ב-Cloud Run.
• ‫ARGS: הארגומנטים של המשימה.
• זוגות של KEY ו-VALUE: משתני הסביבה.
• ‫TASKS: מספר המשימות.
• ‫TIMEOUT: פסק הזמן של המשימה.

ספריות לקוח

כדי להריץ משימה קיימת מקוד, תוך ביטול ההגדרה של המשימה:

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

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

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

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{"overrides": {"containerOverrides": [{"args": ["ARGS"], "env": [{"name": "KEY", "value": "VALUE"}]}], "taskCount": TASKS, "timeout": "TIMEOUT" }}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB:run

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

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

המסוף

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

   כניסה לדף Cloud Run jobs

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

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

4. בתפריט פעולות, לוחצים על סמל האליפסה ואז על ביטול.

gcloud

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

gcloud run jobs executions cancel EXECUTION_NAME

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

הפקודה הזו דורשת אישור, לכן צריך להזין y כדי לאשר.

ספריות לקוח

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

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

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

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

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

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB/executions/EXECUTION_NAME:cancel

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

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