ניהול של מופעי Google Cloud Managed Lustre

אחרי יצירת מופע, אפשר להשתמש ב-Google Cloud Managed Lustre כדי להציג, לקבל, לעדכן ולמחוק מופעים.

מצבים של מכונות

מכונת Managed Lustre יכולה להיות באחד מהמצבים הבאים:

מדינה תיאור
CREATING המופע נוצר ועדיין לא מוכן לשימוש.
ACTIVE המופע זמין לשימוש.
REPAIRING המופע נמצא בתהליך תיקון.
MAINTENANCE או UPGRADING המכונה עוברת תחזוקה. מידע נוסף זמין במאמר בנושא אירועי תחזוקה ומדיניות.
SUSPENDED המופע מושעה, בדרך כלל בגלל בעיה במפתח הצפנה בניהול הלקוח (CMEK).
DELETING המכונה נמחקת.

הצגת רשימה של מכונות

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

מסוף Google Cloud

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

    מעבר אל Managed Lustre

    מוצגת רשימת המכונות של הפרויקט.

‫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

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

    מעבר אל Managed Lustre

  2. כדי לראות פרטים על מכונה ספציפית, לוחצים על שם המכונה.

‫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

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

    מעבר אל Managed Lustre

  2. לוחצים על Instance name (שם המכונה) של המכונה שרוצים לעדכן. מוצג דף הסקירה הכללית של המופע.

  3. לוחצים על Edit.

  4. מזינים את הערכים החדשים.

  5. לוחצים על שליחה.

‫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

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

    מעבר אל Managed Lustre

  2. לוחצים על סמל האפשרויות הנוספות (3 נקודות) לצד המופע שרוצים למחוק.

  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.