יצירה והרצה של משימה שמשתמשת בדיסקים מותאמים אישית לאתחול

בדף הזה מוסבר איך להתאים אישית את הדיסקים הקשיחים שמשמשים להפעלה של כל מופע של מכונה וירטואלית (VM) שמופעל על ידי עבודה.

באופן ספציפי, אתם יכולים להתאים אישית את הגודל, הסוג ו/או את קובץ האימג' של מערכת ההפעלה (OS) של המכונה הווירטואלית עבור דיסק אתחול. אם רוצים להתאים אישית רק את תמונת מערכת ההפעלה של מכונת ה-VM, אפשר לעיין במאמר בנושא ציון תמונת מערכת ההפעלה של מכונת ה-VM לעבודה.

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

לפני שמתחילים

1. אם עוד לא השתמשתם ב-Batch, כדאי לעיין במאמר תחילת העבודה עם Batch ולהפעיל את Batch על ידי השלמת הדרישות המוקדמות לפרויקטים ולמשתמשים.

2. כדי לקבל את ההרשאות שדרושות ליצירת משימה, אתם צריכים לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

   • הכלי לעריכת משימות באצווה (roles/batch.jobsEditor) בפרויקט
   • משתמש בחשבון שירות (roles/iam.serviceAccountUser) בחשבון השירות של המשימה, שמוגדר כברירת מחדל כחשבון השירות של Compute Engine שמוגדר כברירת מחדל

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

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

יצירה והרצה של משימה שמשתמשת בדיסק אתחול מותאם אישית

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

• שימוש בתבנית של הגדרות מכונה ב-Compute Engine שמציינת דיסק אתחול מותאם אישית קיים. אם רוצים להשתמש בתבנית של הגדרות מכונה בזמן יצירת העבודה הזו, או להשתמש בדיסק אתחול מותאם אישית שכבר קיים, צריך לבצע את השלבים הבאים:

  1. יוצרים או מזהים דיסק אתחול בהתאמה אישית.

     למידע על הדרישות של דיסק האתחול ב-Batch, אפשר לעיין במסמך הזה ובמאמר סקירה כללית של סביבת מערכת ההפעלה של מכונות וירטואליות. הוראות ליצירת דיסק אתחול מפורטות במאמר יצירת דיסק אתחול בהתאמה אישית במאמרי העזרה של Compute Engine.

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

     הוראות ליצירת תבנית של הגדרות מכונה מופיעות במאמר יצירת תבניות של מכונות במסמכי התיעוד של Compute Engine.

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

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

• בשדה 'דיסק אתחול' מציינים דיסק אתחול בהתאמה אישית חדש. כפי שמפורט בהוראות הבאות, אפשר להגדיר דיסק חדש בהתאמה אישית לאתחול באמצעות השדה של דיסק האתחול (bootDisk) כשיוצרים ומריצים משימה באמצעות ה-CLI של gcloud או Batch API.

  באופן ספציפי, אפשר להתאים אישית את דיסק האתחול על ידי הגדרת שדות המשנה VM OS image (image), persistent disk type (type), and/or size (sizeGb). ‫Batch מגדיר ערך ברירת מחדל לכל אחד משדות המשנה האלה שבוחרים להשמיט.

gcloud

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

   לדוגמה, כדי ליצור משימת סקריפט בסיסית שמשתמשת בדיסק אתחול חדש בהתאמה אישית, יוצרים קובץ JSON עם התוכן הבא:

   {
       "taskGroups": [
           {
               "taskSpec": {
                   "runnables": [
                       {
                           "script": {
                               "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                           }
                       }
                   ]
               },
               "taskCount": 3,
               "parallelism": 1
           }
       ],
       "allocationPolicy": {
         "instances": [
           {
             "policy": {
               "bootDisk": {
                 "image": "VM_OS_IMAGE_URI",
                 "type": "BOOT_DISK_TYPE",
                 "sizeGb": BOOT_DISK_SIZE
               }
             }
           }
         ]
       },
       "logsPolicy": {
       "destination": "CLOUD_LOGGING"
     }
   }
   

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

   • ‫VM_OS_IMAGE_URI: שם משאב יחסי של קובץ אימג' של מערכת ההפעלה של המכונה הווירטואלית. אפשר לבחור באחת מהאפשרויות הבאות:

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

       BATCH_OS_PREFIX
       

       מחליפים את BATCH_OS_PREFIX באחת מתחיליות של תמונות מערכת הפעלה של מכונות וירטואליות ב-Batch – לדוגמה, batch-debian היא התחילית של מערכת ההפעלה Batch Debian.

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

       projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY
       

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

       • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, אם רוצים להגדיר את כל התמונות בחבילה, מציינים batch-custom-image.
       • ‫IMAGE_FAMILY: משפחת התמונות, שכוללת תמונה ספציפית אחת או יותר ומייצגת את הסוג ואת הגרסה הראשית של מערכת ההפעלה. לדוגמה, כדי לראות את כל משפחות התמונות של מערכות ההפעלה של מכונות וירטואליות מ-Batch, אפשר לראות רשימה של תמונות של מערכות הפעלה של מכונות וירטואליות.

     • מציינים גרסת תמונה. כדי להשתמש בגרסה ספציפית של תמונת מערכת הפעלה של מכונת VM, משתמשים בפורמט הבא:

       projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME
       

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

       • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, אם רוצים להגדיר את כל התמונות בחבילה, מציינים batch-custom-image.
       • ‫IMAGE_NAME: שם התמונה, שמייצג גרסה ספציפית של תמונת מערכת הפעלה של מכונה וירטואלית. לדוגמה, כדי לראות את כל הגרסאות של תמונות מערכת ההפעלה של מכונות וירטואליות מ-Batch, צופים ברשימה של תמונות מערכת ההפעלה של מכונות וירטואליות.

   • ‫BOOT_DISK_TYPE: סוג הדיסק של דיסק האתחול, אחד מהערכים הבאים: pd-standard, ‏pd-balanced, ‏pd-ssd או pd-extreme. סוג הדיסק שמוגדר כברירת מחדל לדיסקים לאתחול הוא pd-balanced.

   • ‫BOOT_DISK_SIZE: הגודל של דיסק האתחול המתמיד החדש ב-GB. הערך הזה צריך לעמוד בכל דרישות הגודל של דיסק האתחול.

2. כדי ליצור את העבודה, מריצים את הפקודה gcloud batch jobs submit הבאה:

   gcloud batch jobs submit JOB_NAME \
       --location LOCATION \
       --config JSON_CONFIGURATION_FILE
   

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

   • ‫JOB_NAME: השם של המשימה.
   • ‫LOCATION: המיקום של המשרה.
   • ‫JSON_CONFIGURATION_FILE: הנתיב לקובץ ה-JSON עם פרטי ההגדרות של העבודה.

API

כדי ליצור משימה באמצעות Batch API, משתמשים בשיטה jobs.create ומציינים את פרטי ההגדרה של המשימה. כדי לציין את תמונת מערכת ההפעלה של מכונת ה-VM עבור העבודה, צריך לכלול את השדה bootDisk ושדות המשנה שלו. לדוגמה, כדי ליצור משימת סקריפט בסיסית שמשתמשת בדיסק אתחול חדש בהתאמה אישית, שולחים את בקשת POST הבאה:

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

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

• ‫VM_OS_IMAGE_URI: שם משאב יחסי של קובץ אימג' של מערכת ההפעלה של המכונה הווירטואלית. אפשר לבחור באחת מהאפשרויות הבאות:

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

    BATCH_OS_PREFIX
    

    מחליפים את BATCH_OS_PREFIX באחת מתחיליות של תמונות מערכת הפעלה של מכונות וירטואליות ב-Batch – לדוגמה, batch-debian היא התחילית של מערכת ההפעלה Batch Debian.

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

    projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY
    

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

    • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, אם רוצים להגדיר את כל התמונות בחבילה, מציינים batch-custom-image.
    • ‫IMAGE_FAMILY: משפחת התמונות, שכוללת תמונה ספציפית אחת או יותר ומייצגת את הסוג ואת הגרסה הראשית של מערכת ההפעלה. לדוגמה, כדי לראות את כל משפחות התמונות של מערכות ההפעלה של מכונות וירטואליות מ-Batch, אפשר לראות רשימה של תמונות של מערכות הפעלה של מכונות וירטואליות.

  • מציינים גרסת תמונה. כדי להשתמש בגרסה ספציפית של תמונת מערכת הפעלה של מכונת VM, משתמשים בפורמט הבא:

    projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME
    

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

    • ‫IMAGE_PROJECT_ID: מזהה הפרויקט שמכיל את התמונה. לדוגמה, אם רוצים להגדיר את כל התמונות בחבילה, מציינים batch-custom-image.
    • ‫IMAGE_NAME: שם התמונה, שמייצג גרסה ספציפית של תמונת מערכת הפעלה של מכונה וירטואלית. לדוגמה, כדי לראות את כל הגרסאות של תמונות מערכת ההפעלה של מכונות וירטואליות מ-Batch, צופים ברשימה של תמונות מערכת ההפעלה של מכונות וירטואליות.

• ‫BOOT_DISK_TYPE: סוג הדיסק של דיסק האתחול, אחד מהערכים הבאים: pd-standard,‏ pd-balanced,‏ pd-ssd או pd-extreme. סוג הדיסק שמוגדר כברירת מחדל לדיסקים לאתחול הוא pd-balanced.

• ‫BOOT_DISK_SIZE: הגודל של דיסק האתחול המתמיד החדש ב-GB. הערך הזה צריך לעמוד בכל דרישות הגודל של דיסק האתחול.

המאמרים הבאים

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