‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

ב-Compute Engine אפשר לקבל הנחות תמורת התחייבות לשימוש במשאבים (CUD) עבור עומסי עבודה צפויים. כשרוכשים התחייבויות לשימוש בכל סוגי ה-GPU או ברוב הדיסקים של SSD מקומי, צריך לשריין את המשאבים האלה ולצרף את השריון להתחייבות.

במאמר הזה מוסבר איך לרכוש התחייבויות לשימוש מבוססות-משאבים עם מקומות שמורים מצורפים באמצעות המסוף Google Cloud , ה-CLI של gcloud או REST.

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

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

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

אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף

כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud
gcloud
1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
  gcloud init
  אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
  
  הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם מותקנת הגרסה העדכנית.
הגדרת אזור ותחום כברירת מחדל

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

התקינו את ה-CLI של Google Cloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

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

כדי לקבל את ההרשאות שנדרשות לרכישת התחייבויות וליצירת הזמנות, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של Compute (roles/compute.admin) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

כדי לרכוש התחייבויות וליצור הזמנות, נדרשות ההרשאות הבאות:

compute.commitments.create
compute.reservations.create

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

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

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

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

שימוש בהזמנות קיימות שתואמות למאפייני ההתחייבות
יצירת מקומות שמורים חדשים שתואמים להתחייבות בזמן הרכישה

אחרי שרוכשים התחייבות, היא הופכת לפעילה ביום שלמחרת בחצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7 במהלך שעון הקיץ). ‫Compute Engine שומר על שיעבוד בפרויקט לכל אזור בפרויקט שבו רכשתם התחייבות. כשרוכשים התחייבות לשימוש חדשה לשימוש באזור כלשהו בפרויקט,‏ Compute Engine משייך את מנעול למניעת מחיקה לאותו אזור להתחייבות לשימוש החדשה שנוצרה.

בין מועד הרכישה של ההתחייבות לבין מועד ההפעלה שלה, הסטטוס של ההתחייבות נשאר NOT_YET_ACTIVE (או PENDING במסוףGoogle Cloud ). אחרי ההפעלה, סטטוס ההתחייבות ישתנה לACTIVE. לדוגמה, נניח שרכשתם את ההתחייבות ב-20 בינואר 2024 בשעה 22:00 לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7). ‫Compute Engine יוצר את ההתחייבות באופן מיידי, והסטטוס שלה הוא NOT_YET_ACTIVE. ההתחייבות שלכם תהפוך ל-ACTIVE ב-21 בינואר 2024, בשעה 00:00 לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7).

דרישות

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

צריך לרכוש את ההתחייבות וליצור את המקומות השמורים המצורפים באותו פרויקט ובאותו אזור.
אתם צריכים לרכוש את ההתחייבות וליצור את המקומות השמורים המצורפים למשאבים מאותה סדרת משפחות מכונות.
אם בהתחייבות שלכם צוינו סוגי משאבים שנדרשות להם בקשות שמירת מקום מצורפות, אתם צריכים להשבית את אפשרות המחיקה האוטומטית בבקשות שמירת המקום המצורפות. מידע נוסף על סוגי המשאבים שנדרשת להם הזמנה מצורפת
אם ההתחייבות כוללת GPUs, סוג ה-GPU שצוין בהזמנה ובמחויבות חייב להיות זהה.
ב-GPU וברוב הדיסקים המקומיים מסוג SSD, מספר המשאבים השמורים מכל סוג משאב חייב להיות זהה בדיוק למספר המשאבים שהתחייבתם להשתמש בהם מאותו סוג משאב. עם זאת, הדרישה הזו לא רלוונטית אם מציינים בהתחייבות דיסקים מקומיים של Titanium SSD לשימוש עם סוגי מכונות C4,‏ C4A,‏ C4D,‏ C4N,‏ G4,‏ H4D או Z3.

לדוגמה, אם אתם רוצים לרכוש התחייבות ל-4 יחידות GPU מסוג V100 ול-2 דיסקים של SSD מקומי, בהזמנות שמצורפות להתחייבות צריך לציין סך של 4 יחידות GPU מסוג V100 ו-2 דיסקים של SSD מקומי. כמות ה-vCPU והזיכרון שאתם מזמינים יכולה להיות גדולה או קטנה יותר מהכמות שהתחייבתם לה. עם זאת, אם תציינו בהתחייבות 4 מעבדי C4A וירטואליים ו-2 דיסקים מקומיים מסוג Titanium SSD, לא תצטרכו לצרף להתחייבות הזמנות של משאבים.
לגבי GPU, רוכשים התחייבויות לסוגי ה-GPU הספציפיים שבהם רוצים להשתמש. לדוגמה, אתם יכולים לרכוש התחייבויות ל-NVIDIA P100s או ל-NVIDIA V100s, אבל לא תוכלו להשתמש בהתחייבות שנרכשה עבור מעבדי GPU מסוג NVIDIA P100 כדי לכסות מעבדי GPU מסוג NVIDIA V100.
אם המקום השמור שצירפתם הוא מקום שמור משותף ואתם רוצים לקבל את ההנחות הרלוונטיות תמורת התחייבות לשימוש כשאתם משתמשים במקום השמור הזה מחוץ לפרויקט שבו ההתחייבות קיימת, אתם צריכים לבצע את שני השלבים הבאים:
- שתפו את המקומות השמורים רק בין פרויקטים ששייכים לאותו חשבון לחיוב ב-Cloud כמו ההתחייבות.
- מוודאים שחלוקת ה-CUD מופעלת בחשבון לחיוב ב-Cloud.

צירוף הזמנות קיימות

אתם יכולים לצרף הזמנות קיימות כשאתם רוכשים התחייבות באמצעות Google Cloud המסוף, Google Cloud CLI או REST.

ההרשאות שנדרשות למשימה הזו

כדי לבצע את המשימה הזו נדרשות ההרשאות הבאות:

כדי לרכוש התחייבות: compute.commitments.create בפרויקט
כדי ליצור הזמנות: compute.reservations.create בפרויקט

המסוף

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

נכנסים לדף Committed use discounts במסוף Google Cloud . לדף Committed use discounts
לוחצים על Purchase commitment. יופיע הדף Purchase a commitment (רכישת התחייבות).
בשדה שם, מזינים שם להתחייבות.
בשדה Region (אזור), בוחרים את האזור שבו רוצים לרכוש את ההתחייבות.
בשדה Commitment type, בוחרים את סדרת משפחת המכונות של ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:
- בסוגי מכונות A2, בוחרים באפשרות Accelerator-optimized A2.
- בסוגי המכונות A3 Edge ו-A3 High, בוחרים באפשרות Accelerator-optimized A3.
- לסוגי מכונות A3 Mega, בוחרים באפשרות Accelerator-optimized A3 Mega
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה future reservations in AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- בסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2
- בסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4 (מכונות G4 עם אופטימיזציה לגרפיקה).
- בסוגי מכונות C2, בוחרים באפשרות C2 מותאם לצריכת מעבד גבוהה (compute-optimized).
- בסוגי מכונות C2D, בוחרים באפשרות C2D מותאם לצריכת מעבד גבוהה (compute-optimized)
- לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3 (מכונות לשימוש כללי C3).
- בסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D (C3D למטרות כלליות).
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4 (מכונות לשימוש כללי C4).
- בסוגי מכונות C4A, בוחרים באפשרות General-Purpose C4A (מכונה וירטואלית לשימוש כללי C4A).
- לסוגי מכונות C4D, בוחרים באפשרות General-Purpose C4D (מכונות C4D לשימוש כללי).
- בסוגי מכונות C4N, בוחרים באפשרות Network-optimized C4N (מכונות C4N שעברו אופטימיזציה לרשת).
- בסוגי מכונות N1, בוחרים באפשרות General-Purpose N1 (לשימוש כללי N1).
- בסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
- בסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
- בסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2 (סוגי מכונות M1/M2 עם אופטימיזציה לזיכרון).
- בסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3 (מכונה וירטואלית מותאמת לזיכרון M3).
- לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3
כדי לצרף להתחייבות הזמנה קיימת אחת או יותר, מבצעים את הפעולות הבאות:
1. מסמנים את התיבה צירוף הזמנה חדשה או קיימת.
2. לוחצים על צירוף הזמנה קיימת. מופיעה החלונית Attach existing reservations (צירוף הזמנות קיימות) ומוצגות בה הזמנות מהפרויקט. הרשימה הזו מסוננת כך שיוצגו בה רק תוכניות שמתאימות לאזור ולסוג ההתחייבות שציינתם.
3. בחלונית Attach existing reservations (צירוף הזמנות קיימות), מסמנים את התיבה לצד כל הזמנה שרוצים לצרף.
4. בודקים את סיכום המשאבים של ההזמנות שנבחרו ולוחצים על צירוף.
אחרי שמצרפים את ההזמנות, המערכת של Compute Engine מאכלסת אוטומטית את השדות בקטע פרטי ההתחייבות בהתאם למספרים ולסוגים של המשאבים מההזמנות המצורפות. אם הזנתם ערכים באופן ידני למשאבים כלשהם בקטע פרטי ההתחייבות לפני שצירפתם הזמנות, הערכים שלכם יוחלפו בערכים מההזמנות.
בקטע פרטי ההתחייבות, מבצעים את הפעולות הבאות:
1. בשדה Cores (ליבות), בודקים את הערך שמולא מראש. אפשר גם לציין מספר שונה של vCPU.
2. בשדה זיכרון, בודקים את כמות הזיכרון שמולאה מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25 GB. כדי לציין ערך זיכרון מותאם אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.
3. מרחיבים את הקטע GPUs and local SSDs (מעבדי GPU ו-SSD מקומיים) ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות שצורפו, באופן הבא:
  1. בשדה סוג ה-GPU, מאמתים את סוג ה-GPU שמולא מראש.
  2. בשדה Number of GPUs (מספר יחידות ה-GPU), בודקים את המספר שמולא מראש של יחידות ה-GPU.
  3. בשדה Local SSDs (כונני SSD מקומיים), בודקים את מספר הדיסקים שמולא מראש.
  אם מציינים באופן ידני ערכים שונים מהערכים של ההזמנות המצורפות באחד מהשדות האלה, רכישת ההתחייבות לא תתבצע. בכל יחידות ה-GPU וברוב דיסקי ה-SSD המקומיים, המספרים והסוגים הכוללים צריכים להיות זהים בין ההתחייבות לבין ההזמנות המצורפות.
  
  הערה: הדרישה הזו לא חלה על דיסקים מקומיים של Titanium SSD לשימוש בסדרות המכונות C4,‏ C4A,‏ C4D,‏ C4N,‏ H4D,‏ Z3 או G4. רק לדיסקים האלה לא צריך לצרף הזמנות, ואפשר לציין מספרים שונים בין ההתחייבות לבין ההזמנות המצורפות.
בקטע Term:
1. כדי לציין את התוכנית של ההתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור הנחת ה-CUD ואת משך התקופה שנקבע מראש של ההתחייבות.
2. בודקים את השדה תאריך התחלה שבו מוצגים התאריך והשעה שבהם ההתחייבות שלכם מתחילה לפעול. השדה הזה מוגדר אוטומטית לחצות לפי שעון החוף המערבי בארה"ב ובקנדה ביום שאחרי התאריך הנוכחי.
3. זה שינוי אופציונלי. כדי להאריך את התקופה של ההתחייבות מעבר למשך התקופה המוגדר מראש בתוכנית ההתחייבות, בשדה תאריך סיום מציינים תאריך סיום מותאם אישית להתחייבות. מידע נוסף מופיע במאמר בנושא הארכת תקופת ההתחייבות.
4. זה שינוי אופציונלי. אם רוצים שההתחייבות תתחדש אוטומטית בסוף התקופה, צריך לסמן את התיבה התחייבות לחידוש אוטומטי.
בחלונית סיכום, בודקים את פרטי ההתחייבות ואת המגבלות הפוטנציאליות במכסה.
כדי לסיים את רכישת ההתחייבות, פועלים לפי השלבים הבאים:
1. עוברים לחלק התחתון של הדף.
2. קוראים את הקטע גילוי נאות שכולל מידע על עמלות, זכאות להנחות, תנאים והגבלות.
3. כדי לאשר את הסכמתכם למחיר ההתחייבות ולתנאים ספציפיים לשירות, מסמנים את תיבת הסימון.
4. לוחצים על רכישה.

gcloud

כדי לרכוש התחייבות על ידי צירוף הזמנות קיימות, מריצים את הפקודה gcloud compute commitments create. בפקודה, כוללים את הדגל --existing-reservation כדי לציין הזמנה קיימת שרוצים לצרף להתחייבות. צריך לכלול מופע חדש של הדגל הזה לכל הזמנה קיימת שרוצים לצרף. אפשר לצרף כמה הזמנות קיימות שרוצים להתחייבות.

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

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=PLAN \
    --type=COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

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

‫COMMITMENT_NAME: שם ההתחייבות.
‫REGION: האזור שבו נמצאת ההתחייבות.
‫PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
‫PLAN: תוכנית ההתחייבות, שקובעת את שיעור הנחת ה-CUD ואת משך התקופה שמוגדר מראש. מציינים 12-month או 36-month.
‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
‫COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים של Local SSD או לשניהם:
- למכונות מסוג A2, משתמשים ב-accelerator-optimized
- למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-accelerator-optimized-a3
- לסוגי מכונות A3 Mega, משתמשים באפשרות accelerator-optimized-a3-mega
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה הזמנות עתידיות ב-AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- למכונות מקבוצת G2, משתמשים ב-graphics-optimized
- לסוגי מכונות G4, משתמשים ב-graphics-optimized-g4
- לסוגי מכונות C2, משתמשים ב-compute-optimized
- לסוגי מכונות C2D, משתמשים ב-compute-optimized-c2d
- לסוגי מכונות C3, משתמשים ב-compute-optimized-c3
- בסוגי מכונות C3D, משתמשים ב-compute-optimized-c3d
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות N1, משתמשים ב-general-purpose
- לסוגי מכונות C4, משתמשים ב-general-purpose-c4
- לסוגי מכונות C4A, משתמשים ב-general-purpose-c4a
- לסוגי מכונות C4D, משתמשים ב-general-purpose-c4d
- לסוגי מכונות C4N, משתמשים ב-network-optimized-c4n
- בסוגי מכונות N2, משתמשים ב-general-purpose-n2
- לסוגי מכונות N2D, משתמשים ב-general-purpose-n2d
- לסוגי מכונות M1, משתמשים ב-memory-optimized
- לסוגי מכונות M3, משתמשים ב-memory-optimized-m3
- לסוגי מכונות Z3, משתמשים ב-storage-optimized-z3
‫COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות, ב-MB או ב-GB. לדוגמה, 10240MB או 10GB. ב-CLI של gcloud, אפשר לציין את הזיכרון במגה-בייט או בג'יגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.
‫COMMITTED_LOCAL_SSD: כמות המקום ב-SSD המקומי שרוצים בהתחייבות, בגיגה-בייט.
‫COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.
‫COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.
‫RESERVATION_NAME_1 ו-RESERVATION_NAME_2: השמות של ההזמנות הקיימות שרוצים לצרף להתחייבות.
‫RESERVATION_ZONE_1 ו-RESERVATION_ZONE_2: האזורים של המקומות השמורים הקיימים שרוצים לצרף להתחייבות.

דוגמה: רכישת התחייבות על ידי צירוף הזמנות קיימות

נניח שיש לכם שתי הזמנות res-01 ו-res-02 באזורים us-central1-a ו-us-central1-b של הפרויקט myproject. נניח שההזמנות האלה כוללות קיבולת משולבת של 4 יחידות GPU מסוג NVIDIA P100 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה עבור ה-GPU ודיסקי ה-SSD המקומיים האלה, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, מריצים את הפקודה הבאה. ההתחייבות כוללת 96 ליבות vCPU,‏ 624 GB של זיכרון, 4 יחידות NVIDIA P100 GPU ו-1,500 GB של אחסון SSD מקומי (שווה ל-4 דיסקים מקומיים של SSD). ערך האחסון ב-SSD המקומי צריך להיות בגיגה-בייט (לדוגמה, 375GB). ב-CLI של gcloud אפשר לציין את הזיכרון במגה-בייט או בגיגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b

REST

כדי לרכוש התחייבות על ידי צירוף של מקומות שמורים קיימים, שולחים בקשת POST אל ה-method‏ regionCommitments.insert. בבקשה, כוללים את השדה existingReservations כדי לציין רשימה מופרדת בפסיקים של כל ההזמנות הקיימות שרוצים לצרף להתחייבות. אתם יכולים לצרף להתחייבות כמה הזמנות קיימות שתרצו.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
  "name": "COMMITMENT_NAME",
  "plan": "PLAN",
  "type": "COMMITMENT_TYPE",
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    },
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLs"
}

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

‫COMMITMENT_NAME: שם ההתחייבות.
‫REGION: האזור שבו נמצאת ההתחייבות.
‫PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
‫PLAN: תוכנית ההתחייבות, שקובעת את שיעור הנחת ה-CUD ואת משך התקופה שמוגדר מראש. מציינים TWELVE_MONTH או THIRTY_SIX_MONTH.
‫COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים של Local SSD או לשניהם:
- למכונות מסוג A2, משתמשים ב-ACCELERATOR_OPTIMIZED
- למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-ACCELERATOR_OPTIMIZED_A3
- לסוגי מכונות A3 Mega, משתמשים באפשרות ACCELERATOR_OPTIMIZED_A3_MEGA
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה הזמנות עתידיות ב-AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- למכונות מקבוצת G2, משתמשים ב-GRAPHICS_OPTIMIZED
- לסוגי מכונות G4, משתמשים ב-GRAPHICS_OPTIMIZED_G4
- לסוגי מכונות C2, משתמשים ב-COMPUTE_OPTIMIZED
- לסוגי מכונות C2D, משתמשים ב-COMPUTE_OPTIMIZED_C2D
- לסוגי מכונות C3, משתמשים ב-COMPUTE_OPTIMIZED_C3
- בסוגי מכונות C3D, משתמשים ב-COMPUTE_OPTIMIZED_C3D
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות N1, משתמשים ב-GENERAL_PURPOSE
- לסוגי מכונות C4, משתמשים ב-GENERAL_PURPOSE_C4
- לסוגי מכונות C4A, משתמשים ב-GENERAL_PURPOSE_C4A
- לסוגי מכונות C4D, משתמשים ב-GENERAL_PURPOSE_C4D
- לסוגי מכונות C4N, משתמשים ב-NETWORK_OPTIMIZED_C4N
- בסוגי מכונות N2, משתמשים ב-GENERAL_PURPOSE_N2
- לסוגי מכונות N2D, משתמשים ב-GENERAL_PURPOSE_N2D
- לסוגי מכונות M1, משתמשים ב-MEMORY_OPTIMIZED
- לסוגי מכונות M3, משתמשים ב-MEMORY_OPTIMIZED_M3
- לסוגי מכונות Z3, משתמשים ב-STORAGE_OPTIMIZED_Z3
‫COMMITTED_VCPUS: מספר ליבות ה-vCPU שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.
‫COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי שרוצים בהתחייבות, בגיגה-בייט.
‫COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.
‫COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.
‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
‫END_TIME: חצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7), כהפרש מהזמן האוניברסלי המתואם (UTC). מציינים את הערך הזה רק אם הגדרתם תאריך סיום מותאם אישית להתחייבות. מציינים אחד מהערכים הבאים:
- במהלך שעון הקיץ: 07:00:00
- בזמנים אחרים: 08:00:00
‫RESERVATION_URLs: רשימה מופרדת בפסיקים של כתובות URL של ההזמנות הקיימות שרוצים לצרף להתחייבות. לדוגמה, כדי לצרף שתי הזמנות, res-1 ו-res-2, צריך לציין את הפרטים הבאים:
```
"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
```

דוגמה: רכישת התחייבות על ידי צירוף הזמנות קיימות

נניח שיש לכם שתי הזמנות res-01 ו-res-02 באזורים us-central1-a ו-us-central1-b של הפרויקט myproject. נניח שההזמנות האלה כוללות קיבולת משולבת של 4 יחידות GPU מסוג NVIDIA P100 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה עבור ה-GPU ודיסקי ה-SSD המקומיים האלה, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, שולחים את הבקשה הבאה ל-POST. ההתחייבות כוללת 96 ליבות vCPU,‏ 624 GB של זיכרון, 4 יחידות GPU מסוג NVIDIA P100 ו-1,500 GB של אחסון SSD מקומי. הערה: צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (GB). לגבי זיכרון, צריך לציין את הערך ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, ‏ Compute Engine משתמש ב-GB כיחידת ברירת המחדל לזיכרון.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1500",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-b/reservations/res-02"
  ]
}

יצירת הזמנות חדשות לצירוף

אפשר ליצור את ההזמנות המצורפות בזמן רכישת ההתחייבות באמצעות מסוף Google Cloud , Google Cloud CLI או REST.

ההרשאות שנדרשות למשימה הזו

כדי לבצע את המשימה הזו נדרשות ההרשאות הבאות:

כדי לרכוש התחייבות: compute.commitments.create בפרויקט
כדי ליצור הזמנות: compute.reservations.create בפרויקט

המסוף

נכנסים לדף Committed use discounts במסוף Google Cloud . לדף Committed use discounts
לוחצים על Purchase commitment. יופיע הדף Purchase a commitment (רכישת התחייבות).
בשדה שם, מזינים שם להתחייבות.
בשדה Region (אזור), בוחרים את האזור שבו רוצים לרכוש את ההתחייבות.
בשדה Commitment type, בוחרים את סדרת משפחת המכונות של ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:
- בסוגי מכונות A2, בוחרים באפשרות Accelerator-optimized A2.
- בסוגי המכונות A3 Edge ו-A3 High, בוחרים באפשרות Accelerator-optimized A3.
- לסוגי מכונות A3 Mega, בוחרים באפשרות Accelerator-optimized A3 Mega
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה future reservations in AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- בסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2
- בסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4 (מכונות G4 עם אופטימיזציה לגרפיקה).
- בסוגי מכונות C2, בוחרים באפשרות C2 מותאם לצריכת מעבד גבוהה (compute-optimized).
- בסוגי מכונות C2D, בוחרים באפשרות C2D מותאם לצריכת מעבד גבוהה (compute-optimized)
- לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3 (מכונות לשימוש כללי C3).
- בסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D (C3D למטרות כלליות).
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4 (מכונות לשימוש כללי C4).
- בסוגי מכונות C4A, בוחרים באפשרות General-Purpose C4A (מכונה וירטואלית לשימוש כללי C4A).
- לסוגי מכונות C4D, בוחרים באפשרות General-Purpose C4D (מכונות C4D לשימוש כללי).
- בסוגי מכונות C4N, בוחרים באפשרות Network-optimized C4N (מכונות C4N שעברו אופטימיזציה לרשת).
- בסוגי מכונות N1, בוחרים באפשרות General-Purpose N1 (לשימוש כללי N1).
- בסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
- בסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
- בסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2 (סוגי מכונות M1/M2 עם אופטימיזציה לזיכרון).
- בסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3 (מכונה וירטואלית מותאמת לזיכרון M3).
- לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3
כדי ליצור הזמנה חדשה ולצרף אותה להתחייבות, מבצעים את הפעולות הבאות:
1. מסמנים את התיבה צירוף הזמנה חדשה או קיימת.
2. לוחצים על יצירת הזמנה חדשה. יופיע החלונית Create a new reservation.
3. בשדה Name, מזינים שם להזמנה.
4. אופציונלי: בשדה תיאור, מזינים תיאור.
5. בשדה Zone, בוחרים את התחום שבו רוצים שהמשאבים השמורים יהיו זמינים.
6. בקטע Share type, מציינים איך רוצים לשתף את ההזמנה הזו:
  - כדי ליצור הזמנה לפרויקט יחיד, בוחרים באפשרות מקומי.
  - כדי ליצור הזמנה שמשותפת עם כמה פרויקטים, בוחרים באפשרות משותף. אחר כך לוחצים על הוספת פרויקטים ובוחרים את הפרויקטים הרצויים.
7. בקטע Google Cloud Services (שירותי Google Cloud), מציינים אם לשתף את השמירה הזו עם שירותים אחרים כמו Google Kubernetes Engine או Vertex AI.
8. בקטע Use with VM instance, בוחרים איך רוצים שהמכונות הווירטואליות ישתמשו בשריון:
  - כדי לאפשר למכונות וירטואליות עם מאפיינים תואמים להשתמש אוטומטית בבקשה הזו, מסמנים את האפשרות Use reservation automatically.
  - כדי להשתמש במשאבים שמתאימים לפרטי הבקשה רק כשמציינים אותה ספציפית (לפי שם), בוחרים באפשרות Select specific reservation.
9. בקטע Resource details (פרטי המשאב), מבצעים את הפעולות הבאות:
  1. בשדה Number of VM instances (מספר מכונות וירטואליות), מזינים את מספר המכונות הווירטואליות.
  2. בקטע Machine configuration, בוחרים באפשרות סוג מכונה כדי לציין מאפיינים. בוחרים סוג מכונה מהרשימה או בוחרים באפשרות בהתאמה אישית כדי לציין את מספר הליבות ואת כמות הזיכרון.
  3. אופציונלי: אם רוצים לשריין יחידות GPU, לוחצים על הוספת GPU ומציינים את סוג ה-GPU ומספר יחידות ה-GPU לכל מכונה וירטואלית.
  4. אופציונלי: אם רוצים לשריין דיסקים מסוג Local SSD, מציינים את Number of disks (מספר הדיסקים) ואת Interface type (סוג הממשק).
  5. אופציונלי: אם רוצים לציין מדיניות מיקום לקבוצה, בוחרים או יוצרים מדיניות ברשימה מדיניות מיקום לקבוצה.
10. כדי לסיים את הגדרת המאפיינים של ההזמנה הזו, לוחצים על יצירה וצירוף.
11. אופציונלי: אם רוצים ליצור ולצרף עוד הזמנות חדשות, לוחצים שוב על יצירת הזמנה חדשה וחוזרים על השלבים האלה.
אחרי שמצרפים את ההזמנות, המערכת של Compute Engine מאכלסת אוטומטית את השדות בקטע פרטי ההתחייבות בהתאם למספרים ולסוגים של המשאבים מההזמנות המצורפות. אם הזנתם ערכים באופן ידני למשאבים כלשהם בקטע פרטי ההתחייבות לפני שצירפתם הזמנות, הערכים שלכם יוחלפו בערכים מההזמנות.
בקטע פרטי ההתחייבות, מבצעים את הפעולות הבאות:
1. בשדה Cores (ליבות), בודקים את הערך שמולא מראש. אפשר גם לציין מספר שונה של vCPU.
2. בשדה זיכרון, בודקים את כמות הזיכרון שמולאה מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25 GB. כדי לציין ערך זיכרון מותאם אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.
3. מרחיבים את הקטע GPUs and local SSDs (מעבדי GPU ו-SSD מקומיים) ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות שצורפו, באופן הבא:
  1. בשדה סוג ה-GPU, מאמתים את סוג ה-GPU שמולא מראש.
  2. בשדה Number of GPUs (מספר יחידות ה-GPU), בודקים את המספר שמולא מראש של יחידות ה-GPU.
  3. בשדה Local SSDs (כונני SSD מקומיים), בודקים את מספר הדיסקים שמולא מראש.
  אם מציינים באופן ידני ערכים שונים מהערכים של ההזמנות המצורפות באחד מהשדות האלה, רכישת ההתחייבות לא תתבצע. בכל יחידות ה-GPU וברוב דיסקי ה-SSD המקומיים, המספרים והסוגים הכוללים צריכים להיות זהים בין ההתחייבות לבין ההזמנות המצורפות.
  
  הערה: הדרישה הזו לא חלה על דיסקים מקומיים של Titanium SSD לשימוש בסדרות המכונות C4,‏ C4A,‏ C4D,‏ C4N,‏ H4D,‏ Z3 או G4. רק לדיסקים האלה לא צריך לצרף הזמנות, ואפשר לציין מספרים שונים בין ההתחייבות לבין ההזמנות המצורפות.
בקטע Term:
1. כדי לציין את התוכנית של ההתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור הנחת ה-CUD ואת משך התקופה שנקבע מראש של ההתחייבות.
2. בודקים את השדה תאריך התחלה שבו מוצגים התאריך והשעה שבהם ההתחייבות שלכם מתחילה לפעול. השדה הזה מוגדר אוטומטית לחצות לפי שעון החוף המערבי בארה"ב ובקנדה ביום שאחרי התאריך הנוכחי.
3. זה שינוי אופציונלי. כדי להאריך את התקופה של ההתחייבות מעבר למשך התקופה המוגדר מראש בתוכנית ההתחייבות, בשדה תאריך סיום מציינים תאריך סיום מותאם אישית להתחייבות. מידע נוסף מופיע במאמר בנושא הארכת תקופת ההתחייבות.
4. זה שינוי אופציונלי. אם רוצים שההתחייבות תתחדש אוטומטית בסוף התקופה, צריך לסמן את התיבה התחייבות לחידוש אוטומטי.
בחלונית סיכום, בודקים את פרטי ההתחייבות ואת המגבלות הפוטנציאליות במכסה.
כדי לסיים את רכישת ההתחייבות, פועלים לפי השלבים הבאים:
1. עוברים לחלק התחתון של הדף.
2. קוראים את הקטע גילוי נאות שכולל מידע על עמלות, זכאות להנחות, תנאים והגבלות.
3. כדי לאשר את הסכמתכם למחיר ההתחייבות ולתנאים ספציפיים לשירות, מסמנים את תיבת הסימון.
4. לוחצים על רכישה.

gcloud

כדי ליצור את המקומות השמורים המצורפים בזמן רכישת ההתחייבות, מריצים את הפקודה gcloud compute commitments create.

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

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

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan PLAN \
    --type COMMITMENT_TYPE
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --reservation=RESERVATION_NAME \
    --reservation-zone=RESERVATION_ZONE \
    --machine-type=RESERVED_MACHINE_TYPE \
    --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
    --vm-count=NUMBER_OF_RESERVED_VMs \
    --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
    --local-ssd=interface=INTERFACE_1,size=375 \
    --local-ssd=interface=INTERFACE_2,size=375 \
    --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2

כדי ליצור כמה הזמנות ולצרף אותן להתחייבות, מגדירים את המאפיינים של ההזמנה באמצעות קובץ YAML, ואז מציינים את קובץ ה-YAML בפקודה שבה משתמשים כדי לרכוש את ההתחייבות. אופציונלי, אפשר גם להשתמש בגישה של קובץ YAML כדי ליצור ולצרף הזמנה אחת להתחייבות. כדי ליצור הזמנות מצורפות בשיטה הזו:
1. יוצרים את קובץ ה-YAML בספרייה הנוכחית ומציינים את ההגדרה הרצויה לכל הזמנה מצורפת. לדוגמה, כדי להגדיר הזמנה משותפת שמשותפת עם שני פרויקטים ומציינת יחידות GPU, שני דיסקים מקומיים מסוג SSD ופלטפורמת CPU מינימלית, צריך לכלול את הטקסט הבא בקובץ ה-YAML:
```
- reservation: RESERVATION_NAME
  reservation_zone: RESERVATION_ZONE
  require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
  vm_count: NUMBER_OF_RESERVED_VMs
  machine_type: RESERVED_MACHINE_TYPE
  accelerator:
  - count: RESERVED_ACCELERATOR_COUNT
    type: RESERVED_ACCELERATOR_TYPE
  localssd:
  - interface: INTERFACE_1
    size: 375
  - interface: INTERFACE_2
    size: 375
  project: OWNER_PROJECT_ID
  minimum-cpu-platform: MINIMUM_CPU_PLATFORM
  share-setting: SHARE_SETTING
  share-with:
  - CONSUMER_PROJECT_ID_1
  - CONSUMER_PROJECT_ID_2
```
  כדי לציין את ההגדרות לכמה הזמנות, חוזרים על המאפיינים האלה לכל הזמנה שרוצים ליצור. אתם יכולים לצרף להתחייבות כל מספר של שריונים קיימים שתרצו.
2. מריצים את הפקודה gcloud compute commitments create וכוללים את הדגל --reservation-from-file.
```
gcloud compute commitments create COMMITMENT_NAME \
    --region REGION \
    --project PROJECT_ID \
    --plan PLAN \
    --type COMMITMENT_TYPE \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --reservations-from-file=YAML_FILE
```

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

משך המינוי

‫COMMITMENT_NAME: שם ההתחייבות.
‫REGION: האזור שבו נמצאת ההתחייבות.
‫PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
‫PLAN: תוכנית ההתחייבות, שקובעת את שיעור הנחת ה-CUD ואת משך התקופה שמוגדר מראש. מציינים 12-month או 36-month.
‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
‫COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:
- למכונות מסוג A2, משתמשים ב-accelerator-optimized
- למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-accelerator-optimized-a3
- לסוגי מכונות A3 Mega, משתמשים באפשרות accelerator-optimized-a3-mega
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה הזמנות עתידיות ב-AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- למכונות מקבוצת G2, משתמשים ב-graphics-optimized
- לסוגי מכונות G4, משתמשים ב-graphics-optimized-g4
- לסוגי מכונות C2, משתמשים ב-compute-optimized
- לסוגי מכונות C2D, משתמשים ב-compute-optimized-c2d
- לסוגי מכונות C3, משתמשים ב-compute-optimized-c3
- בסוגי מכונות C3D, משתמשים ב-compute-optimized-c3d
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות N1, משתמשים ב-general-purpose
- לסוגי מכונות C4, משתמשים ב-general-purpose-c4
- לסוגי מכונות C4A, משתמשים ב-general-purpose-c4a
- לסוגי מכונות C4D, משתמשים ב-general-purpose-c4d
- לסוגי מכונות C4N, משתמשים ב-network-optimized-c4n
- בסוגי מכונות N2, משתמשים ב-general-purpose-n2
- לסוגי מכונות N2D, משתמשים ב-general-purpose-n2d
- לסוגי מכונות M1, משתמשים ב-memory-optimized
- לסוגי מכונות M3, משתמשים ב-memory-optimized-m3
- לסוגי מכונות Z3, משתמשים ב-storage-optimized-z3
‫COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות, ב-MB או ב-GB. לדוגמה, 10GB או 10240MB. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.
‫COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי, שצריך לציין ב-GB. לדוגמה, 375GB.
‫COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.
‫COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.
‫YAML_FILE: הנתיב לקובץ ה-YAML שמכיל את ההגדרות של ההזמנות המצורפות.

הזמנות מצורפות

‫RESERVATION_NAME: השם של ההזמנה המצורפת.
‫RESERVATION_ZONE: האזור של ההזמנה המצורפת.
‫REQUIRE_SPECIFIC_RESERVATION_VALUE: מציין אם ההזמנה המצורפת היא הזמנה שמכוונת למשאב ספציפי. הערכים האפשריים הם true או false. מידע נוסף על הזמנות שמכוונות באופן ספציפי זמין במאמר איך עובדות הזמנות.
‫NUMBER_OF_RESERVED_VMS: מספר המכונות הווירטואליות שרוצים לשריין בהזמנה המצורפת.
‫RESERVED_MACHINE_TYPE: סוג המכונה שרוצים למכונות הווירטואליות בהזמנה המצורפת.
- לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
- לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של מכונות מותאמות אישית.
  
  מחליפים את מה שכתוב בשדות הבאים:
  - ‫MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
  - ‫CPUS: מספר vCPUs.
  - ‫MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, והערך שלו צריך להיות ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדים וירטואליים ו-5 GB של זיכרון, כלומר 5,120 MB, משתמשים ב-n2-custom-4-5120.
‫RESERVED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה המצורפת.
‫RESERVED_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף להזמנה המצורפת.
‫INTERFACE_1 ו-INTERFACE_2: סוג הממשק שרוצים שדיסקי ה-SSD המקומיים של כל מכונת VM שמורה ישתמשו בו. האפשרויות התקפות הן: scsi ו-nvme. חוזרים על הפרמטר local_ssd לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים מסוג Local SSD.
‫OWNER_PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנה שצורפה. מציינים את השדה הזה אם רוצים לשתף את ההזמנה המצורפת בין כמה פרויקטים של צרכנים.
‫MINIMUM_CPU_PLATFORM: פלטפורמת ה-CPU המינימלית שרוצים לציין להזמנה המצורפת.
SHARE_SETTING: סוג השיתוף של ההזמנה המצורפת. מציינים בשדה הזה את הערך projects אם רוצים לשתף את ההזמנה המצורפת עם כמה פרויקטים של צרכנים. אם רוצים ליצור הזמנה לפרויקט יחיד, צריך להשמיט את השדה הזה.
‫CONSUMER_PROJECT_ID_1 ו-CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לשתף את ההזמנה הזו, לדוגמה project-1 ו-project-2. אפשר לכלול עד 100 פרויקטים לצרכן. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. אל תכללו את מזהה הפרויקט שבו אתם יוצרים את המקום השמור הזה, כי לפרויקט הזה יש הרשאה להשתמש במקום השמור הזה כברירת מחדל. אם רוצים ליצור הזמנה לפרויקט מסוים, צריך להשמיט את השדות האלה.

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

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

דוגמאות

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

דוגמה 1: רכישת התחייבות לשימוש במעבדי GPU על ידי צירוף הזמנה חדשה אחת

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות (או במשאבי GPU) באזור us-central1 עם 96 ליבות vCPU,‏ 624 GB של זיכרון ו-4 יחידות GPU של NVIDIA V100. אתם רוצים ליצור הזמנה חדשה reservation-01 בתחום us-central1-a ששומרת 2 n1-standard-32 מכונות וירטואליות (כל מכונה וירטואלית עם 32 ליבות וירטואליות, זיכרון של 120GB ו-2 יחידות GPU של NVIDIA V100) כדי לצרוך את המשאבים האלה שהתחייבתם להם. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור המצורף, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

דוגמה 2: רכישת התחייבות לשימוש ב-GPU בלי לציין vCPU או זיכרון

כדי להתחייב לשימוש ב-GPU ובדיסקים של SSD מקומיים ולשריין אותם בלי להתחייב לשימוש ב-vCPU או בזיכרון, צריך לציין 0 כערך של כמות ה-vCPU והזיכרון. לדוגמה, נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבי GPU באזור us-west2 עם 0 vCPU, זיכרון של 0 GB ו-GPU אחד מסוג NVIDIA P4. אתם רוצים גם ליצור הזמנה חדשה reservation-01 באזור us-west2-b ששומרת מקום למכונה וירטואלית אחת n1-standard-2 (עם 2 vCPU, זיכרון בנפח 7.5GB ו-GPU אחד מסוג NVIDIA P4) כדי לצרף אותה להתחייבות. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור שמשויך אליה, מריצים את הפקודה הבאה. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, חשוב לזכור שכאשר משתמשים ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB.

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

דוגמה 3: רכישת התחייבות לשימוש ב-GPU ובדיסקים של SSD מקומי על ידי צירוף של כמה הזמנות חדשות

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות (או במשאבי GPU ו-SSD מקומיים) באזור us-central1. אתם רוצים התחייבות ל-96 ליבות vCPU, ל-624 GB של זיכרון, ל-GPU אחד מסוג NVIDIA V100 ול-750 GB של אחסון ב-SSD מקומי (שמתאים ל-2 דיסקים מקומיים של SSD). בנוסף, רוצים ליצור ולצרף שתי הזמנות בus-central1-aאזור. בהזמנה הראשונה, res-01, רוצים להזמין מכונה וירטואלית אחת n1-standard-2 (עם 2 vCPU,‏ 7.5 GB זיכרון ו-GPU אחד של NVIDIA V100); זוהי הזמנה ממוקדת. בהזמנה השנייה, res-02, רוצים להזמין מכונה וירטואלית אחת n1-standard-8 (עם 8 ליבות וירטואליות, זיכרון של 30 GB) ולצרף 2 דיסקים של Local SSD (ממשק SCSI אחד וממשק NVMe אחד).

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

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

אחרי שיוצרים את קובץ ה-YAML, מריצים את הפקודה הבאה כדי לסיים את רכישת ההתחייבות עם ההזמנות שצורפו אליה. ערך האחסון של ה-SSD המקומי צריך להיות בגיגה-בייט (לדוגמה, 375GB). ב-CLI של gcloud אפשר לציין את הזיכרון במגה-בייט או בגיגה-בייט. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, שימו לב שכאשר משתמשים ב-REST, ‏ Compute Engine משתמש ב-MB כיחידת ברירת המחדל לזיכרון.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

כדי ליצור מקומות שמורים מצורפים בזמן רכישת ההתחייבות, שולחים בקשת POST אל ה-method‏ regionCommitments.insert. בבקשה, כוללים את השדה reservations כדי להגדיר רשימה של כל ההזמנות החדשות שרוצים ליצור ולצרף. אתם יכולים לצרף להתחייבות כמה הזמנות קיימות שתרצו.

כדי ליצור את ההזמנה החדשה על ידי ציון ידני של כל מאפייני מכונת ה-VM, צריך לכלול את השדה instanceProperties ולהשמיט את השדה sourceInstanceTemplate.

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
"name": "COMMITMENT_NAME",
"plan": "PLAN",
"type": "COMMITMENT_TYPE",
"resources":
[
  {
    "amount": "COMMITTED_VCPUS",
    "type": "VCPU"
  },
  {
    "amount": "COMMITTED_MEMORY",
    "type": "MEMORY"
  },
  {
    "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
    "amount": "COMMITTED_ACCELERATOR_COUNT",
    "type": "ACCELERATOR"
  },
  {
    "amount": "COMMITTED_LOCAL_SSD",
    "type": "LOCAL_SSD"
  }
],
"customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
"reservations":
[
  {
    "name": "RESERVATION_NAME",
    "specificReservation":
    {
      "count": "NUMBER_OF_RESERVED_VMS",
      "instanceProperties":
      {
        "guestAccelerators":
        [
          {
            "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
            "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
          }
        ],
        "localSsds":
        [
          {
            "diskSizeGb": "375",
            "interface": "RESERVED_INTERFACE_1"
          },
          {
            "diskSizeGb": "375",
            "interface": "RESERVED_INTERFACE_2"
          }
        ],
        "machineType": "RESERVED_MACHINE_TYPE",
        "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
      }
    },
    "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
    "zone": "RESERVED_ZONE",
    "shareSettings":
    {
      "shareType": "SPECIFIC_PROJECTS",
      "projectMap":
      {
        "CONSUMER_PROJECT_ID_1":
        {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2":
        {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
  }
]
}

כדי ליצור הזמנה חדשה באמצעות ציון תבנית של הגדרות מכונה, צריך לכלול את השדה sourceInstanceTemplate ולהחריג את השדה instanceProperties.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
"name": "COMMITMENT_NAME",
"plan": "PLAN",
"type": "COMMITMENT_TYPE",
"resources":
[
  {
    "amount": "COMMITTED_VCPUS",
    "type": "VCPU"
  },
  {
    "amount": "COMMITTED_MEMORY",
    "type": "MEMORY"
  },
  {
    "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
    "amount": "COMMITTED_ACCELERATOR_COUNT",
    "type": "ACCELERATOR"
  },
  {
    "amount": "COMMITTED_LOCAL_SSD",
    "type": "LOCAL_SSD"
  }
],
"customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
"reservations":
[
  {
    "name": "RESERVATION_NAME",
    "specificReservation":
    {
      "count": "NUMBER_OF_RESERVED_VMS",
      "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    },
    "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
    "zone": "RESERVED_ZONE",
    "shareSettings":
    {
      "shareType": "SPECIFIC_PROJECTS",
      "projectMap":
      {
        "CONSUMER_PROJECT_ID_1":
        {
          "projectId": "CONSUMER_PROJECT_ID_1"
        },
        "CONSUMER_PROJECT_ID_2":
        {
          "projectId": "CONSUMER_PROJECT_ID_2"
        }
      }
    }
  }
]
}

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

משך המינוי

‫COMMITMENT_NAME: שם ההתחייבות.
‫REGION: האזור שבו נמצאת ההתחייבות.
‫PROJECT_ID: מזהה הפרויקט שבו רוצים לרכוש את ההתחייבות עם ההזמנות שצורפו.
‫PLAN: תוכנית ההתחייבות, שקובעת את שיעור הנחת ה-CUD ואת משך התקופה שמוגדר מראש. מציינים TWELVE_MONTH או THIRTY_SIX_MONTH.
‫COMMITMENT_TYPE: סוג ההתחייבות. סוגי ההתחייבויות הבאים מספקים אפשרויות ל-GPU, לדיסקים מקומיים של SSD או לשניהם:
- למכונות מסוג A2, משתמשים ב-ACCELERATOR_OPTIMIZED
- למכונות מסוג A3 Edge ומסוג A3 High, משתמשים ב-ACCELERATOR_OPTIMIZED_A3
- לסוגי מכונות A3 Mega, משתמשים באפשרות ACCELERATOR_OPTIMIZED_A3_MEGA
  הערה: לסוגי מכונות A4X Max,‏ A4X,‏ A4 או A3 Ultra, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה הזמנות עתידיות ב-AI Hypercomputer. מידע נוסף זמין במאמר שמירת קיבולת דרך צוות ניהול החשבון.
- למכונות מקבוצת G2, משתמשים ב-GRAPHICS_OPTIMIZED
- לסוגי מכונות G4, משתמשים ב-GRAPHICS_OPTIMIZED_G4
- לסוגי מכונות C2, משתמשים ב-COMPUTE_OPTIMIZED
- לסוגי מכונות C2D, משתמשים ב-COMPUTE_OPTIMIZED_C2D
- לסוגי מכונות C3, משתמשים ב-COMPUTE_OPTIMIZED_C3
- בסוגי מכונות C3D, משתמשים ב-COMPUTE_OPTIMIZED_C3D
  שימו לב: בסוגי התחייבות C3 ו-C3D, משפחת המכונות שמוגדרת בסוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, הערכים של סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , הערכים של סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: General-Purpose.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שמתאים לממשק שבו אתם משתמשים.
- לסוגי מכונות N1, משתמשים ב-GENERAL_PURPOSE
- לסוגי מכונות C4, משתמשים ב-GENERAL_PURPOSE_C4
- לסוגי מכונות C4A, משתמשים ב-GENERAL_PURPOSE_C4A
- לסוגי מכונות C4D, משתמשים ב-GENERAL_PURPOSE_C4D
- לסוגי מכונות C4N, משתמשים ב-NETWORK_OPTIMIZED_C4N
- בסוגי מכונות N2, משתמשים ב-GENERAL_PURPOSE_N2
- לסוגי מכונות N2D, משתמשים ב-GENERAL_PURPOSE_N2D
- לסוגי מכונות M1, משתמשים ב-MEMORY_OPTIMIZED
- לסוגי מכונות M3, משתמשים ב-MEMORY_OPTIMIZED_M3
- לסוגי מכונות Z3, משתמשים ב-STORAGE_OPTIMIZED_Z3
‫COMMITTED_VCPUS: מספר המעבדים הווירטואליים שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל ב-Compute Engine היא MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.
‫COMMITTED_LOCAL_SSD: כמות האחסון ב-SSD מקומי שרוצים בהתחייבות, בגיגה-בייט.
‫COMMITTED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים בהתחייבות.
‫COMMITTED_ACCELERATOR_TYPE: סוג ה-GPU שרוצים בהתחייבות.
‫CUSTOM_END_DATE: אופציונלי. תאריך סיום מותאם אישית לתקופת המינוי, שצריך להיות בפורמט YYYY-MM-DD. לדוגמה, כדי לציין תאריך סיום מותאם אישית של 20 באפריל 2024, צריך להזין אותו בפורמט 2024-04-20.
‫END_TIME: חצות לפי שעון החוף המערבי בארה"ב ובקנדה (UTC-8 או UTC-7), כהפרש מהזמן האוניברסלי המתואם (UTC). מציינים את הערך הזה רק אם הגדרתם תאריך סיום מותאם אישית להתחייבות. מציינים אחד מהערכים הבאים:
- במהלך שעון הקיץ: 07:00:00
- בזמנים אחרים: 08:00:00

הזמנות מצורפות

‫RESERVATION_NAME: השם של ההזמנה המצורפת.
‫RESERVATION_ZONE: האזור של ההזמנה המצורפת.
‫REQUIRE_SPECIFIC_RESERVATION_VALUE: מציין אם ההזמנה המצורפת היא הזמנה שמכוונת למשאב ספציפי. הערכים האפשריים הם true או false. מידע נוסף על הזמנות שמכוונות באופן ספציפי זמין במאמר איך עובדות הזמנות.
‫NUMBER_OF_RESERVED_VMS: מספר המכונות הווירטואליות שרוצים לשריין בהזמנה המצורפת.
‫RESERVED_MACHINE_TYPE: סוג המכונה שרוצים למכונות הווירטואליות בהזמנה המצורפת.
- לסוגי מכונות מוגדרים מראש, משתמשים בפורמט MACHINE_FAMILY-standard-CPUS; לדוגמה, n2-standard-4.
- לסוגי מכונות מותאמים אישית, משתמשים בפורמט MACHINE_FAMILY-custom-CPUS-MEMORY; לדוגמה n2-custom-4-5120. רשימה מלאה של ההגבלות מופיעה במפרט של מכונות מותאמות אישית.
  
  מחליפים את מה שכתוב בשדות הבאים:
  - ‫MACHINE_FAMILY: משפחת סוגי המכונות. לדוגמה, מציינים n2 למכונות וירטואליות מסוג N2.
  - ‫CPUS: מספר vCPUs.
  - ‫MEMORY: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256 MB, וצריך לציין אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדים וירטואליים וזיכרון בנפח 5 GB, כלומר 5,120 MB, משתמשים ב-n2-custom-4-5120.
‫RESERVED_ACCELERATOR_COUNT: מספר ה-GPU שרוצים להוסיף, לכל מכונה וירטואלית, בהזמנה המצורפת.
‫RESERVED_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף להזמנה המצורפת.
‫INTERFACE_1 ו-INTERFACE_2: סוג הממשק שבו רוצים להשתמש בדיסקים של SSD מקומי לכל מכונה וירטואלית שמורה. האפשרויות התקפות הן: scsi ו-nvme. חוזרים על הפרמטר localSsds לכל דיסק SSD מקומי שרוצים להוסיף. אפשר לציין עד 24 דיסקים מסוג Local SSD.
‫MINIMUM_CPU_PLATFORM: פלטפורמת ה-CPU המינימלית שרוצים לציין להזמנה המצורפת.
‫INSTANCE_TEMPLATE_NAME: השם של תבנית של הגדרות מכונה שרוצים להשתמש בה כדי ליצור את המקום השמור המצורף.
SHARE_SETTING: סוג השיתוף של ההזמנה המצורפת. אם רוצים לשתף את ההזמנה המצורפת עם כמה פרויקטים של צרכנים, צריך לציין בשדה הזה את הערך SPECIFIC_PROJECTS. אם רוצים ליצור הזמנה לפרויקט יחיד, צריך להחריג את השדה הזה.
‫CONSUMER_PROJECT_ID_1 ו-CONSUMER_PROJECT_ID_2: מזהי הפרויקטים של הפרויקטים שיכולים לחלוק את ההזמנה הזו. לדוגמה, project-1 ו-project-2. אפשר לכלול עד 100 פרויקטים לצרכן. הפרויקטים האלה צריכים להיות באותו ארגון כמו פרויקט הבעלים. אל תכללו את מזהה הפרויקט שבו אתם יוצרים את המקום השמור הזה, כי לפרויקט הזה יש הרשאה להשתמש במקום השמור הזה כברירת מחדל. אם רוצים ליצור הזמנה לפרויקט יחיד, צריך להחריג את השדות האלה.

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

דוגמאות

דוגמה 1: רכישת התחייבות לשימוש במעבדי GPU על ידי צירוף הזמנה חדשה אחת

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות באזור us-central1, שכוללת 96 ליבות vCPU, זיכרון בנפח 624GB (ששווה ל-638,976MB) ו-4 יחידות GPU מסוג NVIDIA V100. אתם רוצים ליצור הזמנה חדשה reservation-01 באזור us-central1-a כדי להזמין 2 מכונות וירטואליות n1-standard-8 (כל מכונה וירטואלית עם 8 ליבות vCPU, זיכרון של 30 GB ו-2 יחידות GPU של NVIDIA V100) ולצרף אותן להתחייבות הזו. כדי לרכוש את ההתחייבות לדוגמה הזו עם ההזמנה המצורפת, שולחים את הבקשה הבאה של POST. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

דוגמה 2: רכישת התחייבות לשימוש ב-GPU בלי לציין vCPU או זיכרון

כדי להתחייב לשימוש ב-GPU ובדיסקים של SSD מקומיים ולשריין אותם בלי להתחייב לשימוש ב-vCPU או בזיכרון, צריך לציין 0 כערך של כמות ה-vCPU והזיכרון. לדוגמה, נניח שאתם רוצים לרכוש התחייבות לשנה אחת רק למשאבי GPU באזור us-west2, עם 0 vCPU,‏ 0 MB זיכרון ו-4 יחידות NVIDIA P4 GPU. אתם רוצים גם ליצור הזמנה חדשה reservation-01באזור us-west2-b, שתשמור מקום למכונה וירטואלית אחת מסוג n1-standard-2 (עם 2 ליבות vCPU, זיכרון בנפח 7.5 GB ו-4 יחידות GPU מסוג NVIDIA P4) כדי לצרף אותה להתחייבות. כדי לרכוש את ההתחייבות לדוגמה הזו עם המקום השמור שמצורף אליה, שולחים את בקשת POST הבאה. ב-REST, צריך לציין את הזיכרון ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, יחידת ברירת המחדל ב-Compute Engine היא GB.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

דוגמה 3: רכישת התחייבות לשימוש ב-GPU ובדיסקים של SSD מקומי על ידי צירוף של כמה הזמנות חדשות

נניח שאתם רוצים לרכוש התחייבות לשנה לשימוש במשאבים למטרות כלליות באזור us-central1, עם 96 ליבות vCPU, זיכרון בנפח 624GB (ששווה ל-638,976MB),‏ NVIDIA V100 GPU אחד ואחסון SSD מקומי בנפח 750GB. אתם רוצים גם ליצור ולצרף שתי הזמנות באזור us-central1-a. בהזמנה הראשונה, res-01, רוצים להזמין מכונה וירטואלית אחת n1-standard-2 (עם 2 vCPU, זיכרון של 7.5 GB ו-GPU אחד של NVIDIA V100). זוהי הזמנה ממוקדת. בהזמנה השנייה, res-02, רוצים להזמין מכונה וירטואלית אחת n1-standard-8 (עם 8 ליבות vCPU וזיכרון בנפח 30 GB) ולצרף 2 דיסקים של Local SSD (ממשק SCSI אחד וממשק NVMe אחד). כדי לרכוש את ההתחייבות לדוגמה הזו עם המקומות השמורים המצורפים, שולחים את הבקשה הבאה POST. הערה: צריך לציין את ערך האחסון של ה-SSD המקומי בגיגה-בייט (GB). לגבי זיכרון, צריך לציין את הערך ב-MB. עם זאת, חשוב לזכור שכאשר משתמשים ב-CLI של gcloud, ‏ Compute Engine משתמש ב-GB כיחידת ברירת המחדל לזיכרון.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "750",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

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

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

המסוף

gcloud

REST

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

ההרשאות הנדרשות

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

דרישות

צירוף הזמנות קיימות

ההרשאות שנדרשות למשימה הזו

המסוף

gcloud

REST

יצירת הזמנות חדשות לצירוף

ההרשאות שנדרשות למשימה הזו

המסוף

gcloud

משך המינוי

הזמנות מצורפות

דוגמאות

REST

משך המינוי

הזמנות מצורפות

דוגמאות

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

ההרשאות שנדרשות למשימה הזו

ההרשאות שנדרשות למשימה הזו