如需了解版本信息，请参阅 Distributed Cloud Connected 版本说明。

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

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

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

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

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

רכש מחובר של Distributed Cloud

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

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

‫Google אישרה את פלטפורמות החומרה הבאות של Distributed Cloud במודל מחובר:

שרתים מחוברים של Distributed Cloud‏ G1. קבוצה של שלושה מחשבי Dell XR11 1U להתקנה במארז. מידע נוסף זמין במאמר בנושא חומרת G1 של שרתים מקושרים של Distributed Cloud.
שרתים מחוברים של Distributed Cloud מדור שני. מארז Dell XR8000r עם שלושה מגשי מכונות XR8610t. מידע נוסף זמין במאמר בנושא חומרה של שרתי G2 שמחוברים ל-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זמין במאמר יצירת פרויקט. הפרויקט שבו אתם משתמשים כדי לנהל את האשכולות צריך להיות אותו פרויקט שבו אתם משתמשים כשאתם מזמינים את הציוד.
‫GDC Hardware Management API: צריך להפעיל את GDC Hardware Management API. במסוףGoogle Cloud , נכנסים לדף GDC Hardware Management API. במידת הצורך, לוחצים על הפעלה כדי להפעיל את ה-API.

כניסה ל-GDC Hardware Management API
תפקידי IAM: כדי להזמין חומרה, צריך לקבל את תפקיד ה-IAM‏ GDC Hardware Management Admin (gdchardwaremanagement.admin). כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
דרישה חוזית: כדי ש-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 של כתובות ה-VIP של מישור הבקרה של Kubernetes, את שער ברירת המחדל של תת-רשת Kubernetes וכל כתובת VIP של מאזן עומסים ראשי ברשת שמתוכננת. אם לא מציינים ערך, הערך הזה זהה לערך של רשת הניהול.
	שער ברירת המחדל של רשת המשנה של Kubernetes	כתובת ה-IP של השער בתת-הרשת של Kubernetes. אם השדה הזה ריק, ברירת המחדל היא שער ברירת המחדל של רשת המשנה לניהול המכונה.
	מזהה ה-VLAN הראשי של Kubernetes	כברירת מחדל, צומת Kubernetes, כולל רשת Kubernetes הראשית, נמצאים באותו VLAN כמו רשת ניהול המכונה. לצורך פילוח הרשת, אפשר להפריד בין הרשתות האלה.
שרתי שמות של DNS	שרת שמות DNS‏ 1	כתובות ה-IP של שרתי השמות של ה-DNS. תשתית הענן המבוזר פותרת שאילתות DNS באמצעות כתובות ה-IP האלה. אם לא צוין שרת DNS, ייעשה שימוש ב-DNS של Google.
שרתי שמות של DNS	שרת שמות DNS‏ 2	כתובות ה-IP של שרתי השמות של ה-DNS. תשתית הענן המבוזר פותרת שאילתות DNS באמצעות כתובות ה-IP האלה. אם לא צוין שרת DNS, ייעשה שימוש ב-DNS של Google.

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

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

הערה: אחרי שמזינים את הפרטים בדף פרטי ההזמנה, אפשר לשמור טיוטה של ההזמנה בלחיצה על שמירה כטיוטה. האפשרות הזו זמינה לכל שלב בתהליך ההזמנה.
בטופס Select hardware, בוחרים את תצורת השרת, את מספר הצמתים ואת מספר חודשי המינוי.
- במערכות סטנדרטיות, ערך ברירת המחדל של Number of nodes הוא 3. אפשרויות של צומת יחיד זמינות רק ללקוחות שנכללים ברשימת ההיתרים.
- כדי למנוע דחייה של הזמנות או עיכובים באספקת המוצרים, הפרטים שאתם מספקים צריכים להיות זהים לפרטים שמופיעים בחוזה שלכם עם Google.
- כשמסיימים למלא את הטופס, לוחצים על המשך.
בטופס הוספת פרטי האתר, מוסיפים את הפרטים של האתר שאליו יישלח ובו יותקן הציוד שמחובר ל-Distributed Cloud. אפשר להוסיף אתר חדש או לבחור אתר קיים. בסיום, לוחצים על המשך.
בטופס Add zone info (הוספת פרטי אזור), מוסיפים אזור חדש או בוחרים אזור קיים.
- בקטע הקצאת משאבים לאשכול, אם אתם מתכננים להגדיר אשכולות בעצמכם, בוחרים באפשרות אגדיר אשכולות באתר שלי. אם אתם רוצים ש-Google תגדיר בשבילכם אשכולות, אתם צריכים לספק את הכוונה שלכם לגבי האשכול, כדי ש-Google תוכל לספק את ההזמנה עם אשכול שהוגדר מראש.
- כדי לחבר את הציוד באזור שלכם לרשת Google Cloud , צריך את המידע שבקטע Network configuration. מידע נוסף על האפשרויות מופיע בקטע מידע על הגדרת הרשת במסמך הזה.
  - אפשר לשמור את ההזמנה כטיוטה ולתת לנציג האזור והרשת להזין את המידע. אחרת, צריך לספק את פרטי רשת ה-IP הנדרשים.
  - בקטע Select the preferred template for IP addresses (בחירת התבנית המועדפת לכתובות IP), בוחרים תבנית שתואמת לדרישות שלכם. התבניות עוזרות לוודא שפרטי ה-IP הנכונים מסופקים. כדי להזין כתובות IP באופן ידני, בוחרים באפשרות Custom IP.
- כשמסיימים למלא את הטופס, לוחצים על המשך.
בטופס Installation requirements (דרישות התקנה), מזינים את הדרישות לגבי האתר הפיזי ולוחצים על Continue (המשך).
בקטע בדיקת הפרטים ושליחה, מוודאים שפרטי ההזמנה נכונים ולוחצים על יצירה. אחרי שלוחצים על יצירה, ההזמנה עוברת לבדיקה. Google Cloud נציג מכירות בודק את הבקשה שלך ויוצר איתך קשר כדי להשלים את ההזמנה. הנציג מבצע את הפעולות הבאות:
- בודקים את הדרישות העסקיות כדי לעזור לכם להשלים את הגדרת החומרה.
- איסוף מידע נוסף על הרשת המקומית, Google Cloud הפרויקט, אתר ההתקנה ודרישות אחרות שמפורטות בדרישות ההתקנה.
- המידע הזה משמש להגדרת החומרה של Distributed Cloud לפני המסירה.

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

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

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

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

הפעלת GDC Hardware Management API

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

המסוף

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

להפעלת ה-API
לוחצים על 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: האזור Google Cloud שבו רוצים לפרוס את האזורים של Distributed 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 עד שתהיו מוכנים לשלוח אותה. התהליך הזה מפורט בהמשך המדריך.
בדיקת סטטוס ההזמנה אם ההזמנה נשלחת עם type‏ INFO_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 , מאפשר לכם להשתמש בהם ומגדיר כללים לבקרת גישה ולחיוב של המשאבים האלה.

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

משאבי הזמנה, אזור וחומרה ב-GDC Hardware Management API
משאבי אשכול ב-Distributed Cloud Edge Container API
יומנים ומדדים ב-Cloud Monitoring
פרטי כניסה ומשאבים אחרים

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

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

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

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

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

ממפים כל אזור מחובר של Distributed Cloud לאזור הנתמך Google Cloud הקרוב ביותר. כך מצמצמים את ההשפעה של תקלה במישור הניהול לאזור גיאוגרפי אחד.
‫Stripe Distributed Cloud מחובר לכמה אזורים של Google Cloud . הדבר מגביל את מספר האזורים המחוברים ל-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

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

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

הגדרת סביבת פיתוח בשפת Python
כדי להתקין את ספריית הלקוח של GDC Hardware Management API, מריצים את הפקודה הבאה:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
מפעילים את 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.

יוצרים משאב 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. אפשר להשתמש בשם המשאב הזה כדי לשנות את ההזמנה או לעקוב אחרי הסטטוס שלה.

יוצרים משאב 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()

יוצרים משאב 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()

יוצרים את משאבי 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()

שליחת המשאב 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 כדי שיטפל בה.
חומרה של מבנים	החומרה נבנית ומסופקת על ידי שותף SI שאושר על ידי Google.
משלוח חומרה	החומרה נשלחת לכתובת האתר שצוינה.
התקנה	הציוד מותקן בכתובת האתר שצוינה.
בתהליך	ההזמנה הושלמה באופן חלקי. לדוגמה, יכול להיות שחלק מהחומרה כבר נמסר והותקן.
הושלמה	ההזמנה הושלמה.
מידע חסר	אנחנו צריכים ממך פרטים נוספים.
נדרשת פעולה	נדרשת התייחסות מיידית בגלל בעיה קריטית בבסיס.
בוטלה	ההזמנה נדחתה.

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

פריסת עומסי עבודה ב-Google Distributed Cloud במודל מחובר