‫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

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

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

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

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

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

אחרי שרוכשים התחייבות, היא נכנסת לתוקף ביום הבא בשעה 00:00 (חצות) לפי שעון החוף המערבי בארה"ב ובקנדה (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).

דרישות

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

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

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

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

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

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

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

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

המסוף

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

במסוף Google Cloud , עוברים לדף הנחות תמורת התחייבות לשימוש. לדף Committed use discounts
‫ לוחצים על Purchase commitment. מופיע הדף Purchase a commitment.
בשדה Name, נותנים שם להתחייבות.
בשדה 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, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה מקום שמור לעתיד ב-AI Hypercomputer. למידע נוסף, קראו את המאמר שמירת קיבולת דרך צוות ניהול החשבון.
- לסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2.
- לסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4.
- לסוגי מכונות C2, בוחרים באפשרות Compute-optimized C2.
- לסוגי מכונות C2D, בוחרים באפשרות Compute-optimized C2D.
- לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3.
- לסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D
  זהירות: לסוגי התחייבויות C3 ו-C3D, משפחת המכונות שצוינה לפי סוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, ערכי סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4.
- לסוגי מכונות C4A, בוחרים באפשרות C4A לשימוש כללי.
- לסוגי מכונות C4D, בוחרים באפשרות C4D לשימוש כללי.
- לסוגי מכונות C4N, בוחרים באפשרות Network-optimized C4N.
- לסוגי מכונות N1, בוחרים באפשרות לשימוש כללי N1.
- לסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
- לסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
- לסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2.
- לסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3.
- לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3.
- לסוגי מכונות Z4D, בוחרים באפשרות Storage-optimized Z4D.
- בסוגי המכונות Z4M, בוחרים באפשרות Storage-optimized Z4M.
כדי לצרף להתחייבות הזמנה קיימת אחת או יותר:
1. מסמנים את התיבה Attach a new or existing reservation.
2. לוחצים על Attach an existing reservation. מופיע החלונית Attach existing reservations ומוצגות בה ההזמנות מהפרויקט. הרשימה הזו מסוננת בהתאם לאזור ולסוג ההתחייבות שציינתם.
3. בחלונית Attach existing reservations, מסמנים את התיבה של כל הזמנה שרוצים לצרף.
4. בודקים את סיכום המשאבים של ההזמנות שנבחרו ולוחצים על Attach.
אחרי שמצרפים את המקומות השמורים, המערכת של Compute Engine ממלאת באופן אוטומטי את השדות בקטע Commitment details בהתאם למספרים ולסוגי המשאבים של המקומות השמורים שצורפו. אם הזנתם ידנית ערכים למשאבים כלשהם בקטע Commitment details לפני שקישרתם את ההזמנות, הערכים שהזנתם יוחלפו בערכים מההזמנות.
בקטע Commitment details:
1. בשדה Cores, מאמתים את הערך שמולא מראש. אפשר גם לציין מספר אחר של מעבדי vCPU.
2. בשדה Memory, בודקים את נפח הזיכרון שמולא מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25GB. כדי לציין ערך זיכרון בהתאמה אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.
3. מרחיבים את הקטע GPUs and local SSDs ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות המצורפות, באופן הבא:
  1. בשדה GPU type, מוודאים שסוג ה-GPU מולא מראש.
  2. בשדה Number of GPUs, מוודאים שמספר ה-GPU שמולא מראש נכון.
  3. בשדה Local SSDs, מוודאים שמספר הדיסקים שמולא מראש נכון.
  אם תציינו באופן ידני ערכים שונים מההזמנות המצורפות לאחד מהשדות האלה, רכישת ההתחייבות לא תתבצע. בכל המעבדים הגרפיים וברוב כונני ה-SSD המקומיים, המספרים הכוללים והסוגים צריכים להיות זהים בהתחייבות ובהזמנות המצורפות.
  
  הערה: הדרישה הזו לא חלה על כונני Titanium SSD מקומיים לשימוש עם סדרות המכונות C4,‏ C4A,‏ C4D,‏ C4N,‏ H4D,‏ Z3 או G4. רק בדיסקים האלה, אתם לא צריכים לצרף הקצאות, ואתם יכולים לבחור לציין מספרים שונים בין ההתחייבות לבין ההקצאות המצורפות.
בקטע Term:
1. כדי לציין את התוכנית להתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור ההנחה של ה-CUD ואת משך תקופת ההתחייבות שהוגדרה מראש.
2. בודקים את השדה Start date, שבו מוצגים התאריך והשעה שבהם ההתחייבות נכנסת לתוקף. השדה הזה מוגדר באופן אוטומטי לחצות לפי שעון החוף המערבי בארה"ב ובקנדה, ביום שאחרי התאריך הנוכחי.
3. זה שינוי אופציונלי. כדי להאריך את תקופת ההתחייבות מעבר לתקופה שמוגדרת בתוכנית ההתחייבות, בשדה End date מציינים תאריך סיום בהתאמה אישית. מידע נוסף זמין במאמר הארכת תקופת ההתחייבות.
4. זה שינוי אופציונלי. אם רוצים שההתחייבות תתחדש אוטומטית בסוף התקופה, מסמנים את התיבה Auto-renew commitment.
בחלונית Summary, בודקים את פרטי ההתחייבות ואת מגבלות המכסות האפשריות.
כדי לסיים את רכישת ההתחייבות:
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, לדיסקים מסוג 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 , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות 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
- במכונות מסוג Z4D, משתמשים ב-storage-optimized-z4d
- במכונות מסוג Z4M, משתמשים ב-storage-optimized-z4m
‫COMMITTED_VCPUS: מספר ה-vCPUs שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות, ב-MB או ב-GB. לדוגמה, 10240MB או 10GB. ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, Compute Engine משתמש ב-GB כיחידת ברירת המחדל. עם זאת, שימו לב שכאשר משתמשים ב-REST, ‏Compute Engine משתמש ב-MB כיחידת ברירת המחדל.
‫COMMITTED_LOCAL_SSD: נפח האחסון ב-SSD מקומי (ב-GB) שאתם רוצים לכלול בהתחייבות.
‫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 T4 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה למעבדי ה-GPU ולדיסקים של ה-SSD המקומיים, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, מריצים את הפקודה הבאה. ההתחייבות כוללת 96 מעבדי vCPU, זיכרון בנפח 624GB,‏ 4 מעבדי GPU מסוג NVIDIA T4 ואחסון בנפח 1,500GB ב-SSD מקומי (שווה ערך ל-4 דיסקים של SSD מקומי). צריך לציין את ערך האחסון של Local SSD ב-GB (לדוגמה, 375GB). ב-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,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-t4,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, לדיסקים מסוג 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 , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות 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
- במכונות מסוג Z4D, משתמשים ב-STORAGE_OPTIMIZED_Z4D
- במכונות מסוג Z4M, משתמשים ב-STORAGE_OPTIMIZED_Z4M
‫COMMITTED_VCPUS: מספר ה-vCPUs שאתם רוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל של Compute Engine היא MB. עם זאת, שימו לב שכאשר משתמשים ב-CLI של gcloud, ‏Compute Engine משתמש ב-GB כיחידת ברירת המחדל.
‫COMMITTED_LOCAL_SSD: נפח האחסון ב-SSD מקומי, ב-GB, שאתם רוצים בהתחייבות.
‫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 T4 ו-4 דיסקים מקומיים של SSD. כדי לרכוש התחייבות חדשה באזור us-central1 של הפרויקט הזה ל-GPU ולדיסקים של SSD מקומיים, ולהשתמש בהזמנות הקיימות האלה כהזמנות מצורפות, צריך לשלוח את הבקשה הבאה ב-POST. ההתחייבות כוללת 96 מעבדי vCPU, זיכרון בנפח 624GB,‏ 4 מעבדי NVIDIA T4 GPU ואחסון SSD מקומי בנפח 1,500GB. שימו לב שצריך לציין את ערך האחסון ב-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-t4",
      "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 , ה-CLI של gcloud או REST.

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

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

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

המסוף

במסוף Google Cloud , עוברים לדף הנחות תמורת התחייבות לשימוש. לדף Committed use discounts
‫ לוחצים על Purchase commitment. מופיע הדף Purchase a commitment.
בשדה Name, נותנים שם להתחייבות.
בשדה 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, צריך לרכוש את ההתחייבויות באמצעות אפשרות הצריכה מקום שמור לעתיד ב-AI Hypercomputer. למידע נוסף, קראו את המאמר שמירת קיבולת דרך צוות ניהול החשבון.
- לסוגי מכונות G2, בוחרים באפשרות Graphics-optimized G2.
- לסוגי מכונות G4, בוחרים באפשרות Graphics-optimized G4.
- לסוגי מכונות C2, בוחרים באפשרות Compute-optimized C2.
- לסוגי מכונות C2D, בוחרים באפשרות Compute-optimized C2D.
- לסוגי מכונות C3, בוחרים באפשרות General-Purpose C3.
- לסוגי מכונות C3D, בוחרים באפשרות General-Purpose C3D
  זהירות: לסוגי התחייבויות C3 ו-C3D, משפחת המכונות שצוינה לפי סוג ההתחייבות משתנה בהתאם לממשק:
  - ב-CLI של gcloud וב-REST, ערכי סוג ההתחייבות משתמשים ב-Compute-optimized כמשפחת המכונות, למרות ש-C3 ו-C3D הם חלק ממשפחת המכונות לשימוש כללי.
  - במסוף Google Cloud , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות C4, בוחרים באפשרות General-Purpose C4.
- לסוגי מכונות C4A, בוחרים באפשרות C4A לשימוש כללי.
- לסוגי מכונות C4D, בוחרים באפשרות C4D לשימוש כללי.
- לסוגי מכונות C4N, בוחרים באפשרות Network-optimized C4N.
- לסוגי מכונות N1, בוחרים באפשרות לשימוש כללי N1.
- לסוגי מכונות N2, בוחרים באפשרות לשימוש כללי N2.
- לסוגי מכונות N2D, בוחרים באפשרות General-Purpose N2D.
- לסוגי מכונות M1, בוחרים באפשרות Memory-optimized M1/M2.
- לסוגי מכונות M3, בוחרים באפשרות Memory-optimized M3.
- לסוגי מכונות Z3, בוחרים באפשרות Storage-optimized Z3.
- לסוגי מכונות Z4D, בוחרים באפשרות Storage-optimized Z4D.
- בסוגי המכונות Z4M, בוחרים באפשרות Storage-optimized Z4M.
כדי ליצור הזמנה חדשה ולצרף אותה להתחייבות:
1. מסמנים את התיבה Attach a new or existing reservation.
2. לוחצים על Create new reservation. ייפתח החלונית Create a new reservation.
3. בשדה Name, נותנים שם לבקשה.
4. אופציונלי: בשדה תיאור, מזינים תיאור.
5. בשדה Zone, בוחרים את האזור שבו רוצים שהמשאבים השמורים יהיו זמינים.
6. בקטע Share type, מציינים איך רוצים לשתף את ההזמנה:
  - כדי ליצור מקום שמור לפרויקט יחיד, בוחרים באפשרות Local.
  - כדי ליצור בקשה לשמירת מקום שמשותפת עם כמה פרויקטים, בוחרים באפשרות Shared. לוחצים על Add projects ובוחרים את הפרויקטים הרצויים.
7. בקטע Google Cloud Services, מציינים אם לשתף את ההזמנה הזו עם שירותים אחרים כמו 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, בוחרים את המאפיינים של Machine type. בוחרים סוג מכונה מהרשימה, או בוחרים באפשרות Custom כדי לציין את מספר הליבות (Cores) ואת כמות הזיכרון (Memory).
  3. אופציונלי: אם רוצים להקצות יחידות GPU, לוחצים על Add GPU ומציינים את סוג ה-GPU ואת מספר יחידות ה-GPU לכל מכונה וירטואלית.
  4. אופציונלי: אם רוצים לשמור דיסקים מסוג Local SSD, מציינים את מספר הדיסקים ואת סוג הממשק.
  5. אופציונלי: אם רוצים לציין מדיניות מיקום קבוצתית, בוחרים או יוצרים מדיניות ברשימה Group placement policy.
10. כדי לסיים את הגדרת המאפיינים של הבקשה לשמירת מקום, לוחצים על Create and attach.
11. אופציונלי: אם רוצים ליצור ולצרף עוד הזמנות חדשות, לוחצים שוב על Create new reservation וחוזרים על השלבים האלה.
אחרי שמצרפים את המקומות השמורים, המערכת של Compute Engine ממלאת באופן אוטומטי את השדות בקטע Commitment details בהתאם למספרים ולסוגי המשאבים של המקומות השמורים שצורפו. אם הזנתם ידנית ערכים למשאבים כלשהם בקטע Commitment details לפני שקישרתם את ההזמנות, הערכים שהזנתם יוחלפו בערכים מההזמנות.
בקטע Commitment details:
1. בשדה Cores, מאמתים את הערך שמולא מראש. אפשר גם לציין מספר אחר של מעבדי vCPU.
2. בשדה Memory, בודקים את נפח הזיכרון שמולא מראש ב-GB. אפשר גם לציין סכום אחר. אפשר לציין זיכרון רק במרווחים של 0.25GB. כדי לציין ערך זיכרון בהתאמה אישית להתחייבות, צריך להשתמש ב-CLI של gcloud או ב-REST.
3. מרחיבים את הקטע GPUs and local SSDs ומוודאים שהסוגים והמספרים תואמים בין ההתחייבות לבין ההזמנות המצורפות, באופן הבא:
  1. בשדה GPU type, מוודאים שסוג ה-GPU מולא מראש.
  2. בשדה Number of GPUs, מוודאים שמספר ה-GPU שמולא מראש נכון.
  3. בשדה Local SSDs, מוודאים שמספר הדיסקים שמולא מראש נכון.
  אם תציינו באופן ידני ערכים שונים מההזמנות המצורפות לאחד מהשדות האלה, רכישת ההתחייבות לא תתבצע. בכל המעבדים הגרפיים וברוב כונני ה-SSD המקומיים, המספרים הכוללים והסוגים צריכים להיות זהים בהתחייבות ובהזמנות המצורפות.
  
  הערה: הדרישה הזו לא חלה על כונני Titanium SSD מקומיים לשימוש עם סדרות המכונות C4,‏ C4A,‏ C4D,‏ C4N,‏ H4D,‏ Z3 או G4. רק בדיסקים האלה, אתם לא צריכים לצרף הקצאות, ואתם יכולים לבחור לציין מספרים שונים בין ההתחייבות לבין ההקצאות המצורפות.
בקטע Term:
1. כדי לציין את התוכנית להתחייבות, בוחרים באפשרות שנה או 3 שנים. התוכנית קובעת את שיעור ההנחה של ה-CUD ואת משך תקופת ההתחייבות שהוגדרה מראש.
2. בודקים את השדה Start date, שבו מוצגים התאריך והשעה שבהם ההתחייבות נכנסת לתוקף. השדה הזה מוגדר באופן אוטומטי לחצות לפי שעון החוף המערבי בארה"ב ובקנדה, ביום שאחרי התאריך הנוכחי.
3. זה שינוי אופציונלי. כדי להאריך את תקופת ההתחייבות מעבר לתקופה שמוגדרת בתוכנית ההתחייבות, בשדה End date מציינים תאריך סיום בהתאמה אישית. מידע נוסף זמין במאמר הארכת תקופת ההתחייבות.
4. זה שינוי אופציונלי. אם רוצים שההתחייבות תתחדש אוטומטית בסוף התקופה, מסמנים את התיבה Auto-renew commitment.
בחלונית Summary, בודקים את פרטי ההתחייבות ואת מגבלות המכסות האפשריות.
כדי לסיים את רכישת ההתחייבות:
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, שני דיסקים מסוג Local 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
  local_ssd:
  - 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 וכוללים את הדגל --reservations-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, לדיסקים מסוג 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 , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות 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
- במכונות מסוג Z4D, משתמשים ב-storage-optimized-z4d
- במכונות מסוג Z4M, משתמשים ב-storage-optimized-z4m
‫COMMITTED_VCPUS: מספר ה-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: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256MB, וצריך לציין אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדי vCPU וזיכרון של 5GB, שהם 5,120MB, משתמשים ב-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, זיכרון בנפח 624GB ו-4 יחידות GPU מסוג NVIDIA V100. אתם רוצים ליצור הזמנה חדשה reservation-01 באזור us-central1-a, שבה אתם מזמינים 2 מכונות וירטואליות מסוג n1-standard-32 (כל מכונה וירטואלית עם 32 יחידות vCPU, זיכרון בנפח 120GB ו-2 מעבדי NVIDIA V100 GPU) כדי לצרוך את המשאבים האלה שהתחייבתם להם. כדי לרכוש את ההתחייבות לדוגמה עם המקום השמור המצורף, מריצים את הפקודה הבאה. ב-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 vCPUs, זיכרון של 0GB ו-NVIDIA P4 GPU אחד. אתם גם רוצים ליצור שמירת מקום חדשה reservation-01 באזור us-west2-b, ששומרת מקום למכונה וירטואלית אחת (n1-standard-2) (עם 2 מעבדי vCPU, זיכרון בנפח 7.5GB ו-NVIDIA P4 GPU אחד) כדי לצרף אותה להתחייבות. כדי לרכוש את ההתחייבות שבדוגמה עם המקום השמור המצורף, מריצים את הפקודה הבאה: ב-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, זיכרון בנפח 624GB, מעבד גרפי אחד מסוג NVIDIA V100 ואחסון בנפח 750GB ב-SSD מקומי (שמתאים ל-2 דיסקים של SSD מקומי). אתם רוצים גם ליצור שתי הזמנות באזור us-central1-a ולצרף אותן. במאגר הראשון, res-01, אתם רוצים לשריין מכונה וירטואלית אחת מסוג n1-standard-2 (עם 2 מעבדי vCPU, זיכרון בנפח 7.5GB ו-GPU אחד מסוג NVIDIA V100). זהו מאגר מטורגט. בהזמנה השנייה, res-02, אתם רוצים להזמין מכונה וירטואלית אחת מסוג n1-standard-8 (עם 8 מעבדי vCPU וזיכרון בנפח 30GB) ולצרף 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 מקומי צריך לציין ב-GB (לדוגמה, 375GB). ב-CLI של gcloud, אפשר לציין את הזיכרון ב-MB או ב-GB. אם לא מציינים יחידה, 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 כדי להגדיר רשימה של כל ההזמנות החדשות שרוצים ליצור ולצרף. אתם יכולים לצרף להתחייבות כמה הזמנות קיימות שתרצו.

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

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

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": "INTERFACE_1"
          },
          {
            "diskSizeGb": "375",
            "interface": "INTERFACE_2"
          }
        ],
        "machineType": "RESERVED_MACHINE_TYPE",
        "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
      }
    },
    "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE",
    "zone": "RESERVATION_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": "RESERVATION_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, לדיסקים מסוג 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 , ערכי סוג ההתחייבות משתמשים בסדרת המכונות הנכונה: לשימוש כללי.
  חשוב לבחור את הערך הנכון של סוג ההתחייבות שתואם לממשק שבו אתם משתמשים.
- לסוגי מכונות 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
- במכונות מסוג Z4D, משתמשים ב-STORAGE_OPTIMIZED_Z4D
- במכונות מסוג Z4M, משתמשים ב-STORAGE_OPTIMIZED_Z4M
‫COMMITTED_VCPUS: מספר ה-vCPUs שרוצים בהתחייבות. המספר חייב להיות מספר שלם חיובי.
‫COMMITTED_MEMORY: כמות הזיכרון שרוצים בהתחייבות. ב-REST, יחידת ברירת המחדל של Compute Engine היא MB. עם זאת, שימו לב שכאשר משתמשים ב-CLI של gcloud, ‏Compute Engine משתמש ב-GB כיחידת ברירת המחדל.
‫COMMITTED_LOCAL_SSD: נפח האחסון ב-SSD מקומי, ב-GB, שאתם רוצים בהתחייבות.
‫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: הזיכרון הכולל של מכונה וירטואלית שמורה. הזיכרון צריך להיות כפולה של 256MB, וצריך לספק אותו ב-MB. לדוגמה, כדי ליצור מכונה וירטואלית מסוג N2 עם 4 מעבדי vCPU וזיכרון של 5GB, שהם 5,120MB, משתמשים ב-n2-custom-4-5120.
‫RESERVED_ACCELERATOR_COUNT: מספר יחידות ה-GPU שרוצים להוסיף לכל VM בהזמנה המצורפת.
‫RESERVED_ACCELERATOR_TYPE: סוג המאיץ שרוצים להוסיף למאגר המצורף.
‫INTERFACE_1 ו-INTERFACE_2: סוג הממשק שבו רוצים להשתמש בדיסקים של ה-SSD המקומי לכל VM שמור. האפשרויות התקינות הן: 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, זיכרון בנפח 30GB ו-2 מעבדי NVIDIA V100 GPU) כדי לצרף אותה להתחייבות הזו. כדי לרכוש את ההתחייבות הזו לדוגמה עם ההזמנה המצורפת, שולחים את בקשת ה-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, זיכרון של 0MB ו-4 יחידות GPU מסוג NVIDIA P4. אתם גם רוצים ליצור הזמנה חדשה reservation-01 באזור us-west2-b, שמזמינה מכונה וירטואלית אחת מסוג n1-standard-2 (עם 2 מעבדי vCPU, זיכרון בנפח 7.5GB ו-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.5GB ו-GPU אחד מסוג NVIDIA V100). זהו מאגר מטורגט. בבקשה השנייה, res-02, אתם רוצים לשמור מקום למכונה וירטואלית אחת מסוג n1-standard-8 (עם 8 מעבדי vCPU וזיכרון בנפח 30GB) ולצרף 2 דיסקים מקומיים מסוג 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

משך המינוי

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

דוגמאות

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

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

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