הוספת דיסק אחסון מתמיד למכונה הווירטואלית

במאמר הזה מוסבר איך לצרף דיסק של מכונה וירטואלית (VM) לאחסון מתמיד למכונה ב-Google Distributed Cloud (GDC) עם air gap.

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

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

לפני שמתחילים

כדי להשתמש בפקודות של ממשק שורת הפקודה (CLI) של gdcloud, צריך לוודא שהורדתם, התקנתם והגדרתם את ה-CLI של gdcloud. כל הפקודות של Distributed Cloud משתמשות ב-CLI של gdcloud או kubectl, ודורשות סביבה של מערכת הפעלה (OS).

קבלת נתיב הקובץ של kubeconfig

כדי להריץ פקודות בשרת Management API, ודאו שיש לכם את המשאבים הבאים:

  1. אם אין לכם קובץ kubeconfig לשרת Management API, נכנסים לחשבון ויוצרים אותו.

  2. בהוראות הבאות, מחליפים את MANAGEMENT_API_SERVER בנתיב לקובץ kubeconfig של שרת Management API.

בקשת תפקידים ב-IAM

כדי לבקש את התפקידים הבאים בפרויקט, פנו לאדמין של הפרויקט ב-IAM:

  • אדמין של פרויקט מכונות וירטואליות (project-vm-admin): יצירה, שינוי, הצגה ומחיקה של מכונות וירטואליות במרחב השמות של הפרויקט.

  • צפייה בפרויקט(project-viewer): צפייה בכל המשאבים במרחבי השמות של הפרויקט.

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

חיבור דיסק ל-VM

ליצור דיסקים שהם לא דיסקי אתחול ולצרף אותם ל-VM. בכל דיסק נוסף אפשר לציין תמונה בהתאמה אישית או דיסק ריק. אפשר להוסיף כמה דיסקים בבת אחת למכונה וירטואלית.

המסוף

  1. בתפריט הניווט, לוחצים על Virtual Machines > Instances.

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

  3. לוחצים על Add new disk.

  4. בתיבת הדו-שיח לאישור, לוחצים על Stop כדי לעצור את ה-VM.

  5. מחכים כמה דקות עד שהמכונה הווירטואלית תפסיק לפעול.

  6. לוחצים על רענון.

  7. כשהמכונה הווירטואלית במצב עצירה, לוחצים שוב על Add new disk.

  8. בתיבת הדו-שיח Add disk, בוחרים דיסק חדש או דיסק קיים.

    • כדי להקצות דיסק חדש, לוחצים על הכרטיסייה New disk.

      1. בשדה Disk name, מזינים שם חדש לדיסק, שיהיה ייחודי לפרויקט.
      2. בשדה Size, מזינים גודל דיסק בין 10 ל-65,536 GiB. לדוגמה, 10 GiB.
      3. בקטע כלל מחיקה, לוחצים על Keep disk או על Delete disk.
    • כדי לבחור דיסק קיים, לוחצים על הכרטיסייה Existing disk.

      1. ברשימה Disk, בוחרים דיסק.
      2. בקטע כלל מחיקה, לוחצים על Keep disk או על Delete disk.
  9. לוחצים על Save. הדיסק מופיע ברשימת הדיסקים של ה-VM.

  10. מפעילים מחדש את ה-VM.

API

  1. יצירת VirtualMachineDisk:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      apply -f - <<EOF
    apiVersion: virtualmachine.gdc.goog/v1
    kind: VirtualMachineDisk
    metadata:
      name: NON_BOOT_BLANK_DISK
    spec:
      size: NON_BOOT_BLANK_DISK_SIZE
    EOF
    
  2. עוצרים את ה-VM.

  3. מוסיפים את VirtualMachineDisk ל-VirtualMachine הקיים spec.disks:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      edit virtualmachines.virtualmachine.gdc.goog VM_NAME
    

    עורכים את הפרטים הבאים בכלי לעריכת טקסט:

    # …
    disks:
    - virtualMachineDiskRef:
        name: VM_BOOT_DISK_NAME
      boot: true
    - virtualMachineDiskRef:
        name: NON_BOOT_BLANK_DISK
      autoDelete: false
    # …
    

    מחליפים את המשתנים לפי ההגדרות הבאות.

    משתנההגדרה
    MANAGEMENT_API_SERVER קובץ kubeconfig של שרת Management API.
    PROJECT הפרויקט ב-Google Distributed Cloud במודל Air-gapped ‏(GDC) שבו רוצים ליצור את ה-VM.
    VM_NAMEהשם של המכונה הווירטואלית החדשה.
    VM_BOOT_DISK_NAMEהשם של דיסק האתחול של המכונה הווירטואלית החדשה.
    NON_BOOT_BLANK_DISKהשם של הדיסק הנוסף.
    NON_BOOT_BLANK_DISK_SIZEגודל הדיסקים הנוספים, למשל 20G.
  4. מפעילים את ה-VM.

פרמוט וטעינה של דיסק שאינו דיסק אתחול

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

התחברות למכונה הווירטואלית

מתחברים למכונה הווירטואלית באמצעות SSH.

מפרמטים את הדיסק

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

    ls -l /dev/disk/by-id/
    

    בפלט לדוגמה הזה, שמות הדיסקים מוצגים כמספרים סידוריים:

       total 0
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 ata-QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda
       lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-1ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda
       lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb
    

    המידע שמופיע אחרי החץ, ->, בכל שורה מציין את שם מכשיר הדיסק. לדוגמה, ב-scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb, המספר הסידורי הוא scsi-SQEMU_QEMU_HARDDISK_vm-disk-data ושם המכשיר הוא sdb.

  2. מזהים את המספר הסידורי של הדיסק ברשימה הזו.

    התנהגות חשובה של תכונות במצבים מסוימים שיכולה להשפיע על רשימת המספרים הסידוריים:

    • אם הערך של virtualMachineDiskRef.name ארוך מ-20 תווים, רק 20 התווים הראשונים משמשים כמספר הסידורי.
    • אם יש שני דיסקים עם אותם 20 תווים ראשונים, רק לדיסק הראשון יש מספר סידורי.
  3. מפרמטים את הדיסק:

   sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/disk/by-id/DISK_ID
  • מחליפים את DISK_ID במספר הסידורי של הדיסק שרוצים לפרמט.
  • בדוגמה הזו, מציינים את scsi-SQEMU_QEMU_HARDDISK_vm-disk-data כדי לפרמט את כל הדיסק בלי טבלת מחיצות.

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

טעינת הדיסק

  1. יוצרים ספרייה שתשמש כנקודת הטעינה של הדיסק החדש. אפשר להשתמש בכל ספרייה. בדוגמה הבאה נוצרת ספרייה ב-/mnt/disks/:

    sudo mkdir -p /mnt/disks/MOUNT_DIR
    

    מחליפים את MOUNT_DIR בספרייה שבה רוצים לטעון את הדיסק.

  2. מחברים את הדיסק למכונה ומפעילים את האפשרות discard:

    sudo mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫DISK_ID עם המספר הסידורי של הדיסק שרוצים לטעון.
    • ‫MOUNT_DIR בספרייה שבה רוצים לטעון את הדיסק.
  3. אופציונלי: מגדירים הרשאות קריאה וכתיבה בדיסק. הפקודה הבאה מעניקה לכל המשתמשים גישת כתיבה, a+w, לדיסק.

    sudo chmod a+w /mnt/disks/MOUNT_DIR
    
  4. אופציונלי: הגדרת טעינה אוטומטית בהפעלה מחדש של המכונה הווירטואלית – באמצעות המזהה הייחודי האוניברסלי (UUID) או סקריפט לטעינה בזמן ההפעלה.

הגדרת טעינה אוטומטית בהפעלה מחדש של המכונה הווירטואלית – UUID של הדיסק

מוסיפים את הדיסק לקובץ /etc/fstab כדי שהדיסק יותקן באופן אוטומטי כשהמכונה הווירטואלית תופעל מחדש. במערכת הפעלה (OS), שם המכשיר משתנה בכל הפעלה מחדש, אבל ה-UUID של המכשיר תמיד מצביע על אותו נפח, גם כשמעבירים דיסקים בין מערכות. לכן, תמיד צריך להשתמש ב-UUID של המכשיר כדי להגדיר טעינה אוטומטית בהפעלה מחדש של המכונה הווירטואלית.

  1. יוצרים גיבוי של קובץ /etc/fstab הנוכחי:

      sudo cp /etc/fstab /etc/fstab.backup
    
  2. מציגים את ה-UUID של הדיסק:

      sudo blkid /dev/DEVICE_NAME
    

    בפלט לדוגמה מוצג ה-UUID של accc19c5-d0d6-4157-9672-37d4e1d48eb5 לדיסק

      /dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"
    

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

  3. פותחים את הקובץ /etc/fstab בכלי לעריכת טקסט ויוצרים רשומה שכוללת את ה-UUID:

      UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫UUID_VALUE עם הדיסק UUID, שמופיע כפלט של הפקודה הצגת ה-UUID.
    • ‫MOUNT_DIR בספרייה שבה טענתם את הדיסק.
    • MOUNT_OPTION עם הערך MOUNT_OPTION של מערכת ההפעלה, שמציין מה מערכת ההפעלה עושה אם היא לא יכולה לטעון את הדיסק בזמן ההפעלה.
  4. מוודאים שרשומות ה-/etc/fstab נכונות:

    הפקודה הבאה מאמתת את הרשומות של /etc/fstab מול הדיסקים והמחיצות הקיימים שמחוברים ל-VM:

      findmnt --verify
    

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

      [W] your fstab has been modified, but systemd still uses the old version;
      use 'systemctl daemon-reload' to reload
    
      0 parse errors, 0 errors, 1 warning
    

    אם יש שגיאות, צריך לבדוק אם הרשומות של fstab תקינות. בעיה נפוצה היא הוספה של תווים לא חוקיים שלא מיועדים להדפסה. כדי להציג את כל התווים המיוחדים בקובץ /etc/fstab, אפשר להריץ את הפקודה הבאה:

      cat --show-nonprinting /etc/fstab
    

    כך נראה פלט תקין לדוגמה:

      LABEL=cloudimg-rootfs /    ext4   defaults    0 1
      LABEL=UEFI    /boot/efi   vfat    umask=0077  0 1
      UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2
    

    מוודאים שאין תווים לא צפויים, כמו תווים שלא מודפסים שמתחילים ב-M- או ב-^.

אם מנתקים את הדיסק הזה או יוצרים קובץ snapshot מדיסק האתחול של ה-VM הזה, צריך לערוך את הקובץ /etc/fstab ולהסיר את הרשומה של הדיסק הזה. גם אם הגדרתם את MOUNT_OPTION ל-nofail או ל-nobootwait, הקפידו לסנכרן את הקובץ /etc/fstab עם המכשירים שמחוברים ל-VM. צריך להסיר את הרשומות האלה לפני שיוצרים קובץ snapshot של דיסק האתחול או מנתקים את הדיסק.

הגדרת טעינה אוטומטית בהפעלה מחדש של ה-VM – סקריפט לטעינה בזמן ההפעלה של ה-VM

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

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

    cat <<EOF >>mount-disk-script
    #!/bin/bash
    mkdir -p /mnt/disks/MOUNT_DIR
    mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR
    EOF
    
    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      create secret generic VM_NAME-mount-script \
      --from-file=script=mount-disk-script
    
    rm mount-disk-script
    
  2. מוסיפים את הסקריפט לטעינה בזמן ההפעלה ל-VM.

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      edit virtualmachines.virtualmachine.gdc.goog VM_NAME
    

    עורכים את spec.startupScripts כך שיכלול את שם ה-Secret.

    apiVersion: virtualmachine.gdc.goog/v1
    kind: VirtualMachine
    metadata:
     name: VM_NAME
     namespace: PROJECT
    spec:
    # …
    startupScripts:
    - name: mount-script
      scriptSecretRef:
        name: VM_NAME-mount-script
    

מידע נוסף על הגדרת סקריפטים לטעינה בזמן ההפעלה