אחרי יצירת מופע, אפשר להשתמש ב-Google Cloud Managed Lustre כדי להציג, לקבל, לעדכן ולמחוק מופעים.
מצבים של מכונות
מכונת Managed Lustre יכולה להיות באחד מהמצבים הבאים:
| מדינה | תיאור |
|---|---|
CREATING |
המופע נוצר ועדיין לא מוכן לשימוש. |
ACTIVE |
המופע זמין לשימוש. |
REPAIRING |
המופע נמצא בתהליך תיקון. |
MAINTENANCE או UPGRADING
|
המכונה עוברת תחזוקה. מידע נוסף זמין במאמר בנושא אירועי תחזוקה ומדיניות. |
SUSPENDED
|
המופע מושעה, בדרך כלל בגלל בעיה במפתח הצפנה בניהול הלקוח (CMEK). |
DELETING |
המכונה נמחקת. |
הצגת רשימה של מכונות
כדי להציג ברשימה את כל המופעים בפרויקט:
מסוף Google Cloud
נכנסים לדף Managed Lustre במסוף Google Cloud .
מוצגת רשימת המכונות של הפרויקט.
CLI של gcloud
משתמשים בפקודה gcloud lustre instances list:
gcloud lustre instances list --location=LOCATION
מחליפים את הערך LOCATION באזור ספציפי כדי להציג רשימה של כל המכונות במיקום הזה. כדי להציג פרויקטים בכל המיקומים, מזינים את הערך -. לדוגמה:
gcloud lustre instances list --location=-
REST
כדי להציג רשימה של מכונות באמצעות API בארכיטקטורת REST, שולחים בקשה לנקודת הקצה הבאה:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]
צריך לציין את הערכים הבאים:
PROJECT_ID הוא מזהה הפרויקט. Google Cloud
ZONE הוא האזור שרוצים לראות את כל המכונות שבו. כדי להציג רשימה של מופעים מכל האזורים, משתמשים בערך
-.
פרטים נוספים זמינים במאמר בנושא הפניית API instances.list.
קבלת מופע
כדי לראות את פרטי המופע:
מסוף Google Cloud
נכנסים לדף Managed Lustre במסוף Google Cloud .
כדי לראות פרטים על מכונה ספציפית, לוחצים על שם המכונה.
CLI של gcloud
משתמשים בפקודה gcloud lustre instances describe:
gcloud lustre instances describe INSTANCE_NAME --location=LOCATION
REST
כדי לקבל פרטים על מופע מסוים באמצעות API בארכיטקטורת REST, שולחים בקשה לנקודת הקצה הבאה:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
צריך לציין את הערכים הבאים:
PROJECT_ID הוא מזהה הפרויקט. Google Cloud
הערך ZONE חייב להיות אזור תקין Google Cloud שנתמך על ידי Managed Lustre. כאן מופיעה רשימה מלאה של המיקומים הנתמכים.
INSTANCE_NAME הוא השם של מופע Managed Lustre שרוצים להחזיר.
פרטים נוספים זמינים במאמר בנושא הפניית API instances.get.
עדכון מכונה
אפשר לעדכן את המאפיינים הבאים של מופע קיים:
- תיאור
- תוויות
- נפח אחסון
- מדיניות תחזוקה
מידע על הגדלת קיבולת האחסון של מופע זמין במאמר הגדלת הקיבולת של מופע.
מידע על הגדרת מדיניות תחזוקה זמין במאמר אירועי תחזוקה ומדיניות תחזוקה.
כדי לעדכן מופע:
מסוף Google Cloud
נכנסים לדף Managed Lustre במסוף Google Cloud .
לוחצים על Instance name (שם המכונה) של המכונה שרוצים לעדכן. מוצג דף הסקירה הכללית של המופע.
לוחצים על Edit.
מזינים את הערכים החדשים.
לוחצים על שליחה.
CLI של gcloud
משתמשים בפקודה gcloud lustre instances update:
gcloud lustre instances update INSTANCE_NAME \
--location=LOCATION \
--capacity-gib=NEW_CAPACITY \
--description=NEW_DESCRIPTION \
--maintenance-policy-weekly-windows=dayOfWeek=DAY,startTime={START_TIME}
כאשר:
- INSTANCE_NAME הוא המופע שרוצים לעדכן.
- LOCATION הוא התחום (zone) שבו נמצאת המכונה.
- NEW_CAPACITY הוא נפח האחסון החדש של המכונה הזו בגיביבייט (GiB). הערך לא יכול להיות גבוה מהקיבולת המקסימלית המותרת, והוא חייב להיות כפולה של גודל הצעד. פרטים נוספים זמינים במאמר בנושא הגדלת הקיבולת של מופע.
NEW_DESCRIPTION הוא ערך חדש לשדה התיאור, שמחליף את התיאור הקיים.
DAY: היום בשבוע שבו מתבצע חלון זמן לתחזוקה (לדוגמה,
TUESDAY).START_TIME: שעת ההתחלה של חלון התחזוקה לפי שעון UTC בפורמט מילון (לדוגמה,
{hours=1,minutes=0}).
כדי לעדכן תוויות, אפשר לעיין בפקודות שזמינות במאמר gcloud lustre instances update.
REST
כדי לעדכן מופע באמצעות API בארכיטקטורת REST, שולחים בקשת PATCH לנקודת הקצה הספציפית שלו:
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]
{
"capacityGib": 72000,
"description": "updated description",
"labels": {
"key1": "value1"
},
"maintenancePolicy": {
"weeklyMaintenanceWindows": [
{
"dayOfWeek": "DAY",
"startTime": {
"hours": HOURS,
"minutes": MINUTES
}
}
]
}
}
צריך לציין את הערכים הבאים:
- PROJECT_ID הוא מזהה הפרויקט. Google Cloud
- ZONE הוא האזור של המכונה Google Cloud .
- INSTANCE_NAME הוא השם של מופע Managed Lustre שרוצים לעדכן.
- UPDATE_MASK היא רשימה מופרדת בפסיקים של שדות לעדכון. שדה יידרס רק אם הוא נמצא במסכה.
גוף הבקשה צריך להכיל שדה אחד לפחות מהשדות הבאים:
-
capacityGiBהוא נפח האחסון החדש של המכונה הזו בגיביבייט (GiB). הערך לא יכול להיות גבוה מהקיבולת המקסימלית המותרת, והוא חייב להיות כפולה של גודל הצעד. פרטים נוספים זמינים במאמר בנושא הגדלת הקיבולת של מופע. -
descriptionהוא התיאור החדש של המופע הזה. -
labelsהיא קבוצת התוויות החדשה של המופע הזה. הערך שלlabelsהוא אובייקט JSON שמכיל צמד אחד או יותר של מפתח:ערך. -
maintenancePolicyהיא מדיניות התחזוקה של המכונה. פרטים נוספים זמינים במאמר בנושא אירועי תחזוקה ומדיניות.
פרטים נוספים זמינים במאמר בנושא הפניית API instances.patch.
אי אפשר להוסיף את הפעולה לתור
אם מופיעה שגיאה דומה לשגיאה הבאה כשמנסים לעדכן מופע:
ERROR: (gcloud.lustre.instances.update) ABORTED: unable to queue the operation
השגיאה הזו מתרחשת כשמנסים להתחיל פעולה בזמן שפעולה אחרת מאותו סוג כבר מתבצעת באותו מופע. ב-Managed Lustre אפשר להפעיל עדכון אחד בכל מכונה בכל פעם, ואפשר להוסיף עוד פעולת עדכון לתור.
כדי לפתור את הבעיה, צריך לחכות שהפעולה הנוכחית תושלם לפני שמתחילים פעולה חדשה.
מחיקת מכונה
כדי למחוק מכונה:
מסוף Google Cloud
נכנסים לדף Managed Lustre במסוף Google Cloud .
לוחצים על סמל האפשרויות הנוספות (3 נקודות) לצד המופע שרוצים למחוק.
בוחרים באפשרות מחיקת מכונה. לוחצים שוב על מחיקה כדי לאשר את המחיקה.
CLI של gcloud
משתמשים בפקודה gcloud lustre instances delete:
gcloud lustre instances delete INSTANCE_NAME --location=LOCATION
תתבקשו לאשר את המחיקה. מקלידים Y או מקישים על Enter כדי להמשיך.
REST
כדי למחוק מופע באמצעות API בארכיטקטורת REST, שולחים בקשה לנקודת הקצה הבאה:
DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
צריך לציין את הערכים הבאים:
PROJECT_ID הוא מזהה הפרויקט. Google Cloud
ZONE הוא האזור שבו המופע נמצא. Google Cloud
INSTANCE_NAME הוא השם של מכונת Managed Lustre שרוצים למחוק.
פרטים נוספים זמינים במאמר בנושא הפניית API instances.delete.
בקשות מחיקה הן בקשות ממושכות, ומוחזר מזהה פעולה שאפשר לשלוח לגביו שאילתה כדי לברר את סטטוס הפעולה. פרטים נוספים זמינים במאמר בנושא operations.get.