הגדרת מקביליות למשימות

משתמשים ב-parallelism כדי לציין את המספר המקסימלי של משימות בהרצת עבודה שאפשר להריץ במקביל. כברירת מחדל, המשימות יתחילו כמה שיותר מהר, עד מקסימום שמשתנה בהתאם למספר המעבדים (CPU) שבהם אתם משתמשים.

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

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

כדי לקבל את ההרשאות שדרושות להגדרת משימות של Cloud Run, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

• ‫Cloud Run Developer (roles/run.developer) במשימה ב-Cloud Run
• משתמש בחשבון שירות (roles/iam.serviceAccountUser) בזהות השירות

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

הגדרת מקביליות

אפשר להגדיר מקביליות לעבודת Cloud Run באמצעות מסוףGoogle Cloud , ה-CLI של gcloud,‏ YAML או Terraform:

המסוף

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

   כניסה ל-Cloud Run

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

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

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

3. לוחצים על Containers, Connections, Security (מאגרי תגים, חיבורים, אבטחה) כדי להרחיב את דף מאפייני העבודה.

4. בקטע Parallelism, בוחרים באפשרות Run as many tasks concurrently as possible (הפעלת כמה שיותר משימות בו-זמנית) כדי לקבל את הביצועים הטובים ביותר. אם אתם צריכים להקטין את מספר המשימות המקבילות, למשל אם המשאבים שלכם מוגבלים, בוחרים באפשרות הגבלת מספר המשימות המקבילות. לאחר מכן, מציינים מספר שלם בין 0 לבין המספר המקסימלי של משימות שפועלות במקביל שמותר לפי המכסה, שלא חורג ממספר המשימות.

5. לוחצים על יצירה או על עדכון.

gcloud

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

  gcloud run jobs create JOB --image IMAGE_URL --parallelism PARALLELISM

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

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

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

  gcloud run jobs update JOB --parallelism PARALLELISM

YAML

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

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

2. מעדכנים את מאפיין parallelism::

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

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

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

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

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

   gcloud run jobs replace job.yaml

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

Terraform

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

מוסיפים את השורות הבאות למשאב google_cloud_run_v2_job בתצורת Terraform:

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

  deletion_protection = false # set to "true" in production

  template {
    task_count  = 3
    parallelism = 3

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

הצגת הגדרות ההפעלה המקבילית

כדי לראות את הגדרות ההפעלה המקבילית הנוכחיות של משימת Cloud Run, משתמשים במסוף Google Cloud או ב-Google Cloud CLI:

המסוף

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

   כניסה לדף Cloud Run jobs

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

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

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

gcloud

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

   gcloud run jobs describe JOB

2. מחפשים את הגדרת המקביליות בהגדרה שמוחזרת.