הזמנת ציוד ואביזרים

בדף הזה מוסבר איך להזמין חומרה של Google Distributed Cloud במודל מחובר. ‫Google Distributed Cloud במודל מחובר זמין במדינות הבאות:

  • אוסטרליה
  • אוסטריה
  • בלגיה
  • ברזיל
  • קנדה
  • צ'ילה
  • דנמרק
  • פינלנד
  • צרפת
  • גרמניה
  • הונג קונג
  • יפן
  • הודו
  • אינדונזיה
  • איטליה
  • מלזיה
  • Mexico
  • הולנד
  • נורווגיה
  • פולין
  • ערב הסעודית
  • סינגפור
  • קוריאה הדרומית
  • ספרד
  • שוודיה
  • שוויץ
  • בריטניה
  • ארצות הברית
  • אורוגוואי

לפני שמזמינים את הציוד, צריך לעמוד בדרישות להתקנה של Distributed Cloud connected.

מודלים של רכש מחובר של Distributed Cloud

אפשר להזמין את הציוד המחובר ל-Distributed Cloud באחת מהדרכים הבאות, בהתאם לדרישות העסקיות שלכם:

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

  • חומרה שמגיעה מהלקוח. אחרי שתתייעצו עם Google לגבי הגדרת פריסה שתתאים לדרישות העסקיות שלכם, תוכלו להזמין את Distributed Cloud Connected מספק שירותי אינטגרציה (SI) שמוסמך על ידי Google. בתרחיש הזה, אתם הבעלים של החומרה של Distributed Cloud במודל מחובר. ה-SI עובד איתכם ועם Google כדי לפרוס, לתקן ולהוציא משימוש את החומרה. בסיום החוזה, ספק ה-SI מוחק את כל תוכנות Google והנתונים שלכם מהחומרה שמחוברת ל-Distributed Cloud. אחרי כן, אפשר להשתמש שוב בציוד או להיפטר ממנו. סוג הרכש הזה זמין רק לשרתים מחוברים של Distributed Cloud.

גרסאות חומרה מחוברות של Distributed Cloud

ציוד השרתים של Google Distributed Cloud במודל מחובר זמין בגורמי הצורה הבאים:

רשימת המק"טים של שרתים שמחוברים ל-Distributed Cloud מופיעה במאמר תמחור של Distributed Cloud Connected.

דרישות מוקדמות

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

הגדרתGoogle Cloud

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

  • Google Cloud project: צריך להיות לכם Google Cloud פרויקט עם אדמין שמורשה להפעיל את Distributed Cloud Hardware Management API. מידע נוסף על יצירת פרויקט Google Cloudזמין במאמר יצירת פרויקט. הפרויקט שבו אתם משתמשים כדי לנהל את האשכולות צריך להיות אותו פרויקט שבו אתם משתמשים כשאתם מזמינים את הציוד.

  • Distributed Cloud Hardware Management API: צריך להפעיל את Distributed Cloud Hardware Management API. במסוףGoogle Cloud , נכנסים לדף GDC Hardware Management API. במידת הצורך, לוחצים על הפעלה כדי להפעיל את ה-API.

    מעבר אל GDC Hardware Management API

  • תפקידים ב-IAM: כדי להזמין חומרה, צריך לקבל את התפקיד GDC Hardware Management Admin (gdchardwaremanagement.admin) ב-IAM. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

אנשי קשר

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

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

  • איש קשר באתר: אדם שאחראי על אתר הפריסה שנבחר. ‫Google תיצור קשר עם האדם הזה כדי לתאם את המסירה של הציוד שלכם ל-Distributed Cloud במודל מחובר ולהשלים אותה. האדם הזה גם מתאם תיקוני חומרה והוצאה משירות עם Google או עם שותף SI מוסמך של Google.

  • איש קשר בנושא אזור ורשת: אדם שאחראי לשילוב של הציוד המחובר של Distributed Cloud בתשתית הקיימת של הרשת והחשמל באתר הפריסה. האדם הזה גם עוזר בפתרון בעיות משותף, אם נדרש.

פרטי האתר

לפני שמבצעים הזמנה, צריך לאסוף את הפרטים הבאים:

  • מזהה הזמנה: מזהה משמעותי להזמנה הזו של חומרה מחוברת ל-Distributed Cloud.

  • מזהה האתר: מזהה משמעותי לאתר הפריסה של הזמנת החומרה המחוברת הזו של Distributed Cloud.

  • מזהה אזור: מזהה משמעותי של אזור היעד המחובר של Distributed Cloud. אם אתם פורסים רק אזור אחד לכל אתר, אתם יכולים להשתמש במזהה האתר כמזהה האזור.

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

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

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

מידע על הגדרת הרשת

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

סוג הרשת שם הגדרת ה-IP תיאור
רשת לניהול מכונות כתובות לניהול מכונות בפורמט CIDR לכל שרת יש כתובת IP לתנועת ניהול של Distributed Cloud. הבלוק הזה מגדיר כתובות IP מרשת המשנה לניהול המכונה שמשמשות למשימה הזו.
תת-רשת לניהול מכונות IPv4 בפורמט בלוקים של CIDR רשת המשנה שהוקצתה לתעבורת הניהול של Distributed Cloud. התנועה כוללת עדכוני תוכנה של תשתית ענן מבוזר ויומנים ומדדים של התשתית. רשת המשנה הזו צריכה להיות גדולה מספיק כדי להכיל את בלוק כתובות ה-IPv4 לניהול המחשב, וגם את שער ברירת המחדל של רשת המשנה לניהול המחשב.
שער ברירת המחדל של רשת המשנה לניהול המכונה כתובת ה-IP של השער בתת-הרשת של ניהול המכונה
תעבורה בצומת Kubernetes כתובות של צומתי Kubernetes בפורמט CIDR לכל שרת יש כתובת IP לתנועה שקשורה ל-Kubernetes. הבלוק הזה מגדיר את כתובות ה-IP מרשת המשנה של Kubernetes שמשמשות לתעבורה שקשורה ל-Kubernetes.
בלוק כתובות IPv4 לכתובות VIP של מישור הבקרה ב-Kubernetes בסימון CIDR לכל אשכול Kubernetes שנוצר באזור הקצה מוקצה VIP של מישור בקרה אחד מתוך בלוק הכתובות הזה. אם אתם מתכננים ליצור רק אשכול אחד באזור הקצה, אתם יכולים להשתמש בבלוק כתובות /32. אחרת, בלוק הכתובת צריך להיות גדול יותר.
תת-רשת של Kubernetes ב-IPv4 בסימון CIDR רשת המשנה שהוקצתה לתנועה ב-Kubernetes. התעבורה כוללת הורדות של קונטיינרים, רשת ראשית של Kubernetes, יומנים ומדדים של Kubernetes ותעבורה של מישור הבקרה של Kubernetes. אם לא מציינים ערך, ברירת המחדל של תת-הרשת היא תת-רשת לניהול מכונות IPv4. אפשר גם לציין בשדה הזה רשת משנה נפרדת. תת-הרשת הזו צריכה להיות גדולה מספיק כדי להכיל את בלוק כתובות ה-IPv4 לתנועת נתונים של צומתי Kubernetes, את בלוק כתובות ה-IPv4 של כתובות ה-IP הווירטואליות (VIP) של מישור הבקרה של Kubernetes, את שער ברירת המחדל של תת-הרשת של Kubernetes וכל כתובת IP וירטואלית של מאזן עומסים ראשי ברשת שמתוכננת. אם לא מציינים ערך, הערך הזה זהה לערך של רשת הניהול.
שער ברירת המחדל של רשת המשנה של Kubernetes כתובת ה-IP של השער בתת-הרשת של Kubernetes. אם השדה הזה ריק, ברירת המחדל היא שער ברירת המחדל של רשת המשנה לניהול המכונה.
מזהה ה-VLAN הראשי של Kubernetes כברירת מחדל, צומת Kubernetes, כולל רשת Kubernetes הראשית, נמצאים באותו VLAN כמו רשת ניהול המכונה. לצורך פילוח הרשת, אפשר להפריד בין הרשתות האלה.
שרתי שמות של DNS שרת שמות DNS‏ 1 כתובות ה-IP של שרתי השמות של ה-DNS. תשתית הענן המבוזר פותרת שאילתות DNS באמצעות כתובות ה-IP האלה. אם לא צוין שרת DNS, ייעשה שימוש ב-DNS של Google.
שרת שמות DNS‏ 2 כתובות ה-IP של שרתי השמות של ה-DNS. תשתית הענן המבוזר פותרת שאילתות DNS באמצעות כתובות ה-IP האלה. אם לא צוין שרת DNS, ייעשה שימוש ב-DNS של Google.

הזמנת ציוד ל-Distributed Cloud במודל מחובר באמצעות מסוף Google Cloud

  1. נכנסים לדף Orders במסוף Google Cloud .

    לדף ההזמנות

  2. בוחרים את פרויקט היעד Google Cloud .

  3. לוחצים על יצירת הזמנה יחידה.

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

  5. בטופס Select hardware, בוחרים את תצורת השרת, את מספר הצמתים ואת מספר חודשי המינוי.

    • במערכות סטנדרטיות, ערך ברירת המחדל של Number of nodes הוא 3. אפשרויות של צומת יחיד זמינות רק ללקוחות שנכללים ברשימת ההיתרים.

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

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

  6. בטופס הוספת פרטי האתר, מוסיפים את הפרטים של האתר שאליו יישלח ובו יותקן הציוד שמחובר ל-Distributed Cloud. אפשר להוסיף אתר חדש או לבחור אתר קיים. בסיום, לוחצים על המשך.

  7. בטופס Add zone info (הוספת פרטי אזור), מוסיפים אזור חדש או בוחרים אזור קיים.

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

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

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

      • בקטע Select the preferred template for IP addresses (בחירת התבנית המועדפת לכתובות IP), בוחרים תבנית שתואמת לדרישות שלכם. התבניות עוזרות לוודא שפרטי ה-IP הנכונים מסופקים. כדי להזין כתובות IP באופן ידני, בוחרים באפשרות Custom IP.

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

  8. בטופס Installation requirements (דרישות התקנה), מזינים את הדרישות של האתר הפיזי ולוחצים על Continue (המשך).

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

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

תאריך ההתקנה שביקשתם מוגדר אוטומטית לתאריך הזמין הראשון, בדרך כלל 45 ימים אחרי ש-Google מאשרת את ההזמנה.

הזמנת ציוד מחובר ל-Distributed Cloud באמצעות GDC Hardware Management API

‫GDC Hardware Management API מאפשר לכם להזמין באופן פרוגרמטי ציוד ל-Distributed Cloud. הזמנה מייצגת את הכוונה שלכם לפרוס את Distributed Cloud במודל מחובר. ההזמנה צריכה לכלול את הפרטים הבאים, שמשמשים לאורך כל מחזור החיים של הפריסה המחוברת של Distributed Cloud:

  • איש קשר לניהול הזמנות ולמשלוח
  • כתובת אתר המשלוח וכל מידע שרלוונטי למשלוח
  • הגדרת החומרה
  • הגדרת רשת

כדי להשלים את שאלון פרטי הלקוח (CIQ) ולסכם את ההיקף וההגדרה של הפריסה המחוברת של Distributed Cloud, צריך לעבוד עם נציג המכירות של Google.

הפעלת GDC Hardware Management API

כדי להשתמש ב-GDC Hardware Management API, צריך להפעיל אותו בGoogle Cloud פרויקט היעד. כדי לעשות זאת, צריך לבצע את השלבים שבקטע הזה.

המסוף

  1. במסוף Google Cloud , נכנסים לדף GDC Hardware Management API.

    להפעלת ה-API

  2. לוחצים על Enable.

gcloud

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

gcloud services enable gdchardwaremanagement.googleapis.com

המבנה של הזמנה

כדי לבצע הזמנה באמצעות GDC Hardware Management API, צריך ליצור משאב Order, וגם את המשאבים הנלווים Site, Zone ו-Hardware שהמשאב Order מפנה אליהם. אחר כך שולחים את משאב Order ל-Google. המשאבים האלה תומכים בפעולות CRUD רגילות. השם של כל משאב הוא נתיב שכולל את מזהה הפרויקט של היעד Google Cloud ואת האזור Google Cloud .

אלה הפונקציות של המקורות האלה. מידע נוסף על השימוש ב-GDC Hardware Management API זמין במאמר Google Distributed Cloud CLI and API reference.

  • Order. המשאב הזה מבקש ליצור תחום אחד או יותר של Distributed Cloud. כשיוצרים את המשאב הזה, הוא מקבל שם שאפשר לגשת אליו בשדה create_order_response.name. הפורמט של שם המשאב Order הוא:

    `projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID

    where:

    • PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
    • REGION: האזור שבו רוצים לפרוס את האזורים של Distributed Cloud. Google Cloud
    • ORDER_ID: מזהה ייחודי שמזהה את ההזמנה הזו. מומלץ לספק ערך ייחודי של מזהה הזמנה שמורכב מאותיות קטנות, מספרים ומקפים. אחרת, קריאות ליצירת הזמנה שנכשלו עלולות ליצור הזמנות כפולות.
  • Site. המשאב הזה מייצג את המיקום הפיזי שבו רוצים לפרוס את חומרת Distributed Cloud. המשאב הזה כולל את פרטי הקשר של גורם אחראי שמתאם את הגישה לצורך מסירה ראשונית ותחזוקה עתידית. יכול להיות שאיש הקשר הזה שונה מאיש הקשר שציינתם בהזמנה.

  • Hardware. המשאב הזה יוצר מופע של מק"ט של Distributed Cloud במודל מחובר ומייצג שרת או מתלה של Distributed Cloud. כל משאב Hardware מפנה למשאבים המשויכים Order,Site ו-Zone. כדי לראות את המק"טים הזמינים, משתמשים בקריאה ל-API‏ ListSkus.

  • Zone. המשאב הזה מציין את הגדרת הרשת של המכונות המחוברות ושל האשכולות המשויכים ב-Distributed Cloud. אזור Distributed Cloud מכסה מתלה אחד או יותר של Distributed Cloud במודל מחובר, או את כל מכונות השרת של Distributed Cloud במודל מחובר שנפרסו במיקום שלכם.

כששולחים ל-Google Order משאב והסטטוס שלו משתנה מ-DRAFT ל-SUBMITTED או ל-INFO_COMPLETE, רוב ערכי השדות הופכים לקריאה בלבד.

מחזור החיים של הזמנה

למשאב Order יכול להיות אחד מהסטטוסים שמפורטים ב-State. הצדדים המעורבים יכולים להוסיף הערות להזמנה, וההערות נשמרות כמשאבי Comment שמוטמעים מתחת למשאב Order המתאים. אפשר לקרוא תגובות ולשלוח תגובות גם דרך GDC Hardware Management API וגם דרך מסוף Google Cloud .

‫GDC Hardware Management API תומך בפעולות הבאות במחזור החיים של ההזמנה:

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

  • בדיקת סטטוס ההזמנה אם ההזמנה נשלחת עם typeINFO_COMPLETE ויש לכם חוזה עם Google, ההזמנה עוברת את רצף המצבים הבא: ACCEPTED, BUILDING, SHIPPING, INSTALLING ו-COMPLETED.. המצבים של משאבי Zone ו-Hardware המשויכים מתעדכנים באופן סינכרוני עם משאב Order.

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

  • מחיקת הזמנה שלא נשלחה אפשר למחוק הזמנה שלא נשלחה באמצעות קריאה ל-DELETE.

  • שינוי הזמנה שנשלחה אפשר לשנות את ההזמנה, האתר והאזור שנשלחו באמצעות הקריאה המתאימה ל-PATCH. אפשר לערוך את השדות הבאים אחרי השליחה:

    • כל המשאבים: display_name, labels
    • הזמנה: organization_contact
    • אתר: access_times, רוב השדות של organization_contact אבל לא כתובת האתר
    • חומרה: requested_installation_date אם לפחות אחד מהתנאים הבאים מתקיים:
      • התאריך החדש הוא בעוד יותר מ-45 ימים
      • התאריך החדש requested_installation_date מאוחר יותר מהתאריך הנוכחי requested_installation_date וגם השדה estimated_installation_date ריק
      • התאריך החדש של requested_installation_date מאוחר יותר מהתאריך הנוכחי של requested_installation_date וגם התאריך של estimated_installation_date הוא לפחות 7 ימים מהיום

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

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

בוחרים את פרויקט היעד Google Cloud .

פרויקט ב- Google Cloud הוא מבנה שמכיל קבוצה של משאבים ב- Google Cloud , מאפשר לכם להשתמש בהם ומגדיר כללים לבקרת גישה ולחיוב של המשאבים האלה.

מומלץ ליצור פרויקט נפרד לכל דומיין אדמיניסטרטיבי, כמו מדינה או מחלקה בחברה, ולכל תרחיש שימוש ברמה גבוהה, כמו קצה לעומת ליבה, ולנהל את הפריסה המחוברת של Distributed Cloud לדומיין דרך הפרויקט הזה. Google Cloud Google Cloud

Google Cloud הפרויקט מאפשר לכם לבצע את משימות הניהול הבאות:

  • להזמין ציוד ל-Distributed Cloud במודל מחובר.
  • מגדירים אשכולות מחוברים של Distributed Cloud ורושמים אותם ב-Fleet.
  • ניהול השקות של תוכנות.
  • ניהול נתונים מחוברים ב-Distributed Cloud ב-Cloud Storage.
  • ניהול פרטי הכניסה של Google Distributed Cloud במודל מחובר ב-Secret Manager.
  • ניהול יומנים ומדדים של Google Distributed Cloud במודל מחובר ב-Cloud Monitoring.

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

חומרה שהוזמנה בפרויקט מסוים ב- Google Cloud תמיד מנוהלת בפרויקט הזה ב- Google Cloud .

בחירת אזור היעד Google Cloud

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

אם אתם משלבים את הפריסה המחוברת של Distributed Cloud עם טביעת רגל קיימת שלGoogle Cloud מספר אזורים, מומלץ למפות כל אזור מחובר של Distributed Cloud לאזור שמארח את התלות של אותו אזור. Google Cloud

אם אתם לא משלבים פריסה מקושרת של Distributed Cloud עם טביעת רגל קיימת, מומלץ לבחור מגוון אזורים כדי לשפר את המהימנות. Google CloudGoogle Cloud לדוגמה:

  • ממפים כל אזור מחובר של Distributed Cloud לאזור הנתמך Google Cloud הקרוב ביותר. כך מצמצמים את ההשפעה של תקלה במישור הניהול לאזור גיאוגרפי אחד.
  • ‫Stripe your Distributed Cloud connected across several Google Cloud regions. הדבר מגביל את מספר האזורים המחוברים ל-Distributed Cloud שיכולים להיות מושפעים מתקלה במישור הניהול, אבל האזורים המושפעים פרוסים על פני אזור גיאוגרפי גדול יותר.

    ‫Google Distributed Cloud במודל מחובר תומך באזורים הבאים Google Cloud :

  • אסיה: asia-east1, asia-east2, asia-northeast1, asia-northeast3, asia-south1, asia-south2, asia-southeast1, asia-southeast2

  • אירופה: europe-central2, europe-north1, europe-west1, europe-west2, europe-west3, europe-west4, europe-west6, europe-west8, europe-west9

  • המזרח התיכון: me-central1, me-west1

  • אוקיאניה: australia-southeast1

  • צפון אמריקה: northamerica-northeast1, northamerica-northeast2, us-central1, us-central2, us-east1, us-east4, us-east5, us-east7, us-south1, us-west1, us-west2, us-west3, us-west4, us-west8

  • דרום אמריקה: southamerica-east1, southamerica-west1

מגדירים את הסביבה

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

  1. הגדרת סביבת פיתוח בשפת Python

  2. כדי להתקין את ספריית הלקוח של GDC Hardware Management API, מריצים את הפקודה הבאה:

    python3 -m pip install google-cloud-gdchardwaremanagement
    
  3. מפעילים את GDC Hardware Management API בפרויקט היעד Google Cloud .

יצירה ושליחה של הזמנת חומרה שמחוברת ל-Distributed Cloud באמצעות GDC Hardware Management API

השלבים בקטע הזה הם דוגמאות שממחישות איך ליצור משאב Order ולשלוח אותו ל-Google באמצעות GDC Hardware Management API. כדי לבצע את השלבים בקטע הזה, צריך להיות לכם תפקיד אדמין לניהול חומרה ב-GDC (roles/gdchardwaremanagement.admin) בפרויקט ב- Google Cloud . פרטים על הסוגים והשיטות הזמינים מופיעים בהפניה לספריית הלקוח של Python.

  1. יוצרים משאב Order. לדוגמה:

    import datetime
    from google.cloud import gdchardwaremanagement_v1alpha
    from google.protobuf.timestamp_pb2 import Timestamp
    from google.type import postal_address_pb2
    
    client = gdchardwaremanagement_v1alpha.GDCHardwareManagementClient()
    
    contact = gdchardwaremanagement_v1alpha.Contact(
        given_name="John",
        family_name="Customer",
        email="jcustomer@example.com",
        phone="+1 123 456 7890",
    )
    
    organization_contact = gdchardwaremanagement_v1alpha.OrganizationContact(
        address=postal_address_pb2.PostalAddress(
            organization="Example Organization",
            address_lines=["1800 Amphibious Blvd."],
            locality="Mountain View",
            administrative_area="CA",
            postal_code="94045",
            region_code="US",
        ),
        contacts=[contact],
    )
    
    order = gdchardwaremanagement_v1alpha.Order(
        organization_contact=organization_contact,
        customer_motivation="I like Google Distributed Cloud!",
        fulfillment_time=Timestamp(
            seconds=int(datetime.datetime(2024, 11, 22, 9, 0).timestamp()),
        ),
        region_code="US",
    )
    
    create_order_response = client.create_order(
        request=gdchardwaremanagement_v1alpha.CreateOrderRequest(
            parent="projects/myProject/locations/us-east1",
            order_id="myOrderID",
            order=order,
        ),
    ).result()

    ההזמנה שלך נמצאת עכשיו במצב DRAFT והוקצה לה שם משאב שמאוחסן בשדה create_order_response.name. אפשר להשתמש בשם המשאב הזה כדי לשנות את ההזמנה או לעקוב אחרי הסטטוס שלה.

  2. יוצרים משאב Site. לדוגמה:

    site = gdchardwaremanagement_v1alpha.Site(
        organization_contact=organization_contact,
        google_maps_pin_uri="https://maps.app.goo.gl/z7bE8z8fffg6Sri46",
    )
    
    create_site_response = client.create_site(
        request=gdchardwaremanagement_v1alpha.CreateSiteRequest(
            parent="projects/myProject/locations/us-east1",
            site_id="mySite",
            site=site,
        ),
    ).result()
  3. יוצרים משאב Zone. לדוגמה:

    zone = gdchardwaremanagement_v1alpha.Zone(
        contacts=[contact],
        network_config=gdchardwaremanagement_v1alpha.ZoneNetworkConfig(
            management_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
                address_range="192.0.2.0/24",
                default_gateway_ip_address="192.0.2.1",
            ),
            machine_mgmt_ipv4_range="192.0.2.8/29",
            kubernetes_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
                address_range="203.0.113.0/24",
                default_gateway_ip_address="203.0.113.1",
            ),
            kubernetes_node_ipv4_range="203.0.113.8/29",
            kubernetes_control_plane_ipv4_range="203.0.113.16/29",
        ),
    )
    
    create_zone_response = client.create_zone(
        request=gdchardwaremanagement_v1alpha.CreateZoneRequest(
            parent="projects/myProject/locations/us-east1",
            zone_id="myZone",
            zone=zone,
        ),
    ).result()
  4. יוצרים את משאבי Hardware. צריך לציין hardware_idערך ייחודי לכל מכונה בפריסה המחוברת ל-Distributed Cloud. לדוגמה:

    from google.type import date_pb2
    
    hardware = gdchardwaremanagement_v1alpha.Hardware(
        order=create_order_response.name,
        site=create_site_response.name,
        zone=create_zone_response.name,
        config=gdchardwaremanagement_v1alpha.HardwareConfig(
            sku="projects/myProject/locations/us-east1/skus/gdce-server-l",
            power_supply=gdchardwaremanagement_v1alpha.types.PowerSupply.POWER_SUPPLY_AC,
        ),
        physical_info=gdchardwaremanagement_v1alpha.HardwarePhysicalInfo(
            power_receptacle=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.PowerReceptacleType.NEMA_5_15,
            network_uplink=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.NetworkUplinkType.RJ_45,
            voltage=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Voltage.VOLTAGE_110,
            amperes=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Amperes.AMPERES_15,
        ),
        installation_info=gdchardwaremanagement_v1alpha.HardwareInstallationInfo(
            rack_location="Floor 2, Room 201, Row 7, Rack 3",
            power_distance_meters=2,
            switch_distance_meters=2,
            rack_unit_dimensions=gdchardwaremanagement_v1alpha.Dimensions(
                width_inches=19,
                height_inches=1.75,
                depth_inches=30,
            ),
            rack_space=gdchardwaremanagement_v1alpha.RackSpace(
                start_rack_unit=12,
                end_rack_unit=12,
            ),
            rack_type=gdchardwaremanagement_v1alpha.types.HardwareInstallationInfo.RackType.FOUR_POST,
        ),
        requested_installation_date=date_pb2.Date(year=2024, month=11, day=22),
    )
    
    create_hardware_response = client.create_hardware(
        request=gdchardwaremanagement_v1alpha.CreateHardwareRequest(
            parent="projects/myProject/locations/us-east1",
            hardware_id="machineHardwareID",
            hardware=hardware,
        ),
    ).result()
  5. שליחת המשאב Order אל Google:

    submit_order_response = client.submit_order(
        request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
            name=create_order_response.name,
            type_=gdchardwaremanagement_v1alpha.types.SubmitOrderRequest.Type.INFO_COMPLETE,
        ),
    ).result()

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

בדיקה

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

פתרון בעיות

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

שגיאה: 400 FAILED_PRECONDITION

אם מתקבל קוד השגיאה 400 עם הסטטוס FAILED_PRECONDITION בתגובה לקריאה ל-API, צריך לוודא שהבקשה תקפה לפעולה שמנסים להשלים. דוגמאות לבקשות לא תקינות כוללות שליחה של Order משאב עם שדות או ערכים חסרים, או ניסיון למחוק Hardware משאב שמשויך לOrder משאב שנשלח בעבר.

שגיאה: 400 INVALID_ARGUMENT

אם מקבלים קוד שגיאה 400 עם סטטוס INVALID_ARGUMENT בתגובה לקריאה ל-API, צריך לבדוק אם יש שמות שדות לא נכונים או ערכים שלא תואמים לסוגים הצפויים שלהם, או ערכים חסרים. יכול להיות שתקבלו את השגיאה הזו גם אם תשתמשו ב-updateMask בבקשת PATCH ואחד או יותר מהשדות שצוינו ב-updateMask לא תקינים.

כדי לפתור את הבעיה הזו, צריך לעיין במאמר בנושא GDC Hardware Management API ולוודא שכל שמות השדות והערכים נכונים, כולל הפורמט. אם משתמשים במטען ייעודי (payload) של JSON, צריך לוודא שכל המידע הנדרש כלול במטען הייעודי.

שגיאה: 401 UNAUTHENTICATED

אם מתקבל קוד השגיאה 401 עם הסטטוס UNAUTHENTICATED בתגובה לקריאה ל-API, צריך לבדוק את הגדרות האימות. מידע נוסף זמין במאמר בנושא הגדרה של Application Default Credentials.

שגיאה: 403 PERMISSION_DENIED

אם מקבלים קוד שגיאה 403 עם סטטוס PERMISSION_DENIED בתגובה לקריאה ל-API, צריך לבדוק אם לחשבון השירות ששימש לשליחת הקריאה ל-API יש הרשאות מספיקות לגשת לאובייקטים ולמשאבים של היעד. כדאי גם לוודא שפרטי הכניסה נכונים ולא פג תוקפם.

שגיאה: 404 NOT_FOUND

אם מתקבל קוד השגיאה 404 עם הסטטוס NOT_FOUND בתגובה לקריאה ל-API, צריך לוודא ששמות המשאבים והנתיב שצוינו בקריאה ל-API הם תקינים. כדי לוודא שכתובת ה-URL של הבקשה בנויה בצורה נכונה וכל השדות שכלולים בכתובת ה-URL תקינים, אפשר לעיין במאמר בנושא GDC Hardware Management API.

מעקב אחרי סטטוס ההזמנה

אפשר לעקוב אחרי סטטוס ההזמנה במסוף Google Cloud בדף Orders. בטבלה הבאה מפורטים הסטטוסים האפשריים והמשמעות שלהם.

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

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