עריכת מופעים

בדף הזה מוסבר איך לערוך מופע Filestore באמצעותGoogle Cloud המסוף או ה-CLI של gcloud.

אחרי שיוצרים את מופע Filestore, אפשר לשנות אותו בדרכים הבאות:

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

חלק מהמפרטים, כמו כתובת ה-IP של המופע, הם קבועים.

הוראות לעריכת מופע

מסוף Google Cloud

כדי לערוך מופעי Filestore באמצעות Google Cloud המסוף, עוברים לדף Edit instance (עריכת מופע), שבו אפשר לערוך את תיאור המופע, לנהל כללי בקרת גישה מבוססי-IP ולשנות את הביצועים של שיתוף הקבצים:

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

    כניסה לדף Filestore instances

  2. לוחצים על מספר המכונה של המופע שרוצים לערוך.

  3. בדף פרטי המופע, לוחצים על עריכה כדי לעבור לדף עריכת המופע.

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

  5. לוחצים על Save.

gcloud

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

כדי להשתמש ב-CLI של gcloud, צריך להתקין את gcloud CLI או להשתמש ב-Cloud Shell שמוטמע במסוף Google Cloud :

כניסה ל Google Cloud מסוף

פקודת gcloud לעריכת מופע

כדי לערוך מופע Filestore, מריצים את הפקודה instances update. אם אתם צריכים לעדכן את כללי ההגדרה של בקרת גישה מבוססת-IP, אתם צריכים להשתמש בדגל --flags-file ולציין קובץ הגדרה בפורמט JSON. אם בוחרים בשיטה הזו, לא צריך להשתמש בדגל --file-share כי הוא כבר כלול בקובץ התצורה בפורמט JSON.

gcloud filestore instances update INSTANCE_ID
    --[project="PROJECT_ID"]
    --[location=LOCATION]
    --[performance=PERFORMANCE] \
    --[file-share=name="FILE_SHARE_NAME",CAPACITY=FILE_SHARE_SIZE]
    --[description="DESCRIPTION"]
    --[flags-file=FILE_NAME.json]

where:

  • ‫INSTANCE_ID הוא מזהה המכונה של מכונת Filestore שרוצים לערוך.

  • ‫PROJECT_ID הוא מזהה הפרויקט של הפרויקט Google Cloud שמכיל את מופע Filestore. אפשר לדלג על ההגדרה הזו אם מופעלת ברירת המחדל של gcloud הפרויקט במופע Filestore. כדי להגדיר את פרויקט ברירת המחדל, מריצים את הפקודה:

    gcloud config set project project-id

  • ‫LOCATION הוא המיקום שבו נמצא מופע Filestore. במקרים של מופעים אזוריים ומופעים של Enterprise, צריך לציין אזור. בכל שאר המקרים, צריך לציין אזור. מריצים את הפקודה gcloud filestore zones list כדי לקבל רשימה של אזורים נתמכים. אפשר לדלג על הדגל הזה אם מופע Filestore נמצא באזור ברירת המחדל gcloud. כדי להגדיר את אזור ברירת המחדל, מריצים את הפקודה:

    gcloud config set filestore/zone zone

  • ‫PERFORMANCE הוא הגדרת הביצועים שמשמשת לציון הגדרות ביצועים מותאמות אישית בנפרד מהקיבולת שנבחרה.

    אפשר להשתמש רק באחת מהאפשרויות הבאות:

    • ‫max-iops-per-tb מציין קצב IOPS לכל TiB שניתן להרחבה באופן לינארי עם קיבולת המופע.

    • ‫max-iops מציין קצב קבוע של פעולות קלט/פלט בשנייה שלא משתנה בהתאם לקיבולת המופע.

      הפורמט נראה כך:

      --performance=max-iops-per-tb=17000

  • ‫FILE_SHARE_NAME הוא שם שיתוף הקבצים שמוגש ממופע Filestore. אי אפשר לשנות את השמות של שיתופי הקבצים אחרי שיוצרים את המופע.

  • ‫FILE_SHARE_SIZE הוא הגודל החדש שרוצים להקצות לשיתוף הקבצים. אפשר לציין את גודל שיתוף הקבצים במספרים שלמים באמצעות GiB (ברירת מחדל) או TiB.

    כדי לראות את המכסה הזמינה, נכנסים לדף Quotas במסוף Google Cloud :

    לדף Quotas

  • ‫DESCRIPTION הוא תיאור אופציונלי של מופע Filestore.

  • ‫FILE_NAME הוא השם של קובץ התצורה בפורמט JSON לבקרת גישה מבוססת-IP.

    קובץ תצורה בפורמט JSON לדוגמה:

     {
"--file-share":
  {
    "capacity": "4096",
    "name": "my_vol",
    "nfs-export-options": [
      {
        "access-mode": "READ_WRITE",
        "ip-ranges": [
          "10.0.0.0",
          "10.2.0.0"
        ],
        "squash-mode": "ROOT_SQUASH",
        "anon_uid": 1003,
        "anon_gid": 1003
      },
       {
        "access-mode": "READ_ONLY",
        "ip-ranges": [
          "10.0.1.0/28"
        ],
        "squash-mode": "NO_ROOT_SQUASH"
      }
    ],
  }
}

    where:

    • ‫ip-ranges היא כתובת ה-IP או טווח כתובות ה-IP שרוצים להעניק להם גישה. אפשר לציין כמה כתובות IP או טווחים של כתובות IP, ולהפריד ביניהם באמצעות פסיקים. רק מהדורות הבאות של שירותים אפשר להגדיר את ההגדרות של טווחי כתובות IP חופפים:
      • אזורי
      • אזורי
      • Enterprise
    • ‫access-mode היא רמת הגישה שמוענקת ללקוחות שכתובת ה-IP שלהם נמצאת בטווח ip-range. הערך יכול להיות READ_WRITE או READ_ONLY. ערך ברירת המחדל הוא READ_WRITE.
    • הערכים האפשריים של squash-mode הם ROOT_SQUASH או NO_ROOT_SQUASH. ‫ROOT_SQUASH מסיר גישת שורש ללקוחות שכתובת ה-IP שלהם נמצאת בטווח ip-range, בעוד ש-NO_ROOT_SQUASH מאפשר גישת שורש. ערך ברירת המחדל הוא NO_ROOT_SQUASH.
    • ‫anon_uid הוא ערך מזהה המשתמש שרוצים למפות ל-anon_uid. ערך ברירת המחדל הוא 65534.
    • ‫anon_gid הוא ערך מזהה הקבוצה שרוצים למפות אל anon_gid. ערך ברירת המחדל הוא 65534.
דוגמה

בדוגמה הבאה מתבצע עדכון של מופע nfs-server על ידי הגדלת גודל שיתוף הקבצים ל-3 TiB.

    gcloud filestore instances update nfs-server --zone=us-central1-c --file-share=name="vol1",capacity=3TiB
  ```

‫API בארכיטקטורת REST

  1. התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים ב- cURL כדי להפעיל את Filestore API:

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME?updateMask=performanceConfig%2CdeletionProtectionReason%2CdeletionProtectionEnabled&key=YOUR_API_KEY' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
            "tier":"TIER",
            "networks":[
                {
                "network":"NETWORK"
                }
              ],
            "performanceConfig": {"PERFORMANCE"}
            "fileShares":[
              {"capacityGb":CAPACITY,"name":"SHARE_NAME"}
              ],
            "deletionProtectionEnabled": true,
            "deletionProtectionReason": "PROTECTION_REASON"}' \
    --compressed

    כאשר:

    • ‫PROJECT הוא שם הפרויקט שבו ימוקם המופע. לדוגמה, my-genomics-project.
    • ‫LOCATION הוא המיקום שבו המופע יתארח. לדוגמה, us-east1 או us-central1-a.
    • ‫NAME הוא שם המופע שרוצים ליצור. לדוגמה, my-genomics-instance.

    • ‫PERFORMANCE הוא הגדרת הביצועים שמשמשת לציון הגדרות ביצועים בהתאמה אישית.

      אפשר להשתמש רק באחת מהאפשרויות שמופיעות.

      • iopsPerTB מאפשרת ביצועים מותאמים אישית עם שיעור IOPS בהגדרת המשתמש שניתן להתאמה בהתאם לקיבולת המופע. כדי להגדיר IOPS לכל TiB, משתמשים בשדה maxIopsPerTb.

      • fixedIops מאפשרת עלות וביצועים בהתאם לקצב קבוע של פעולות קלט/פלט בשנייה (IOPS) שלא משתנה בהתאם לקיבולת המופע. כדי להגדיר ערך קבוע של IOPS, משתמשים בשדה maxIops.

        הפורמט הוא כזה:

        "performanceConfig": {
    "iopsPerTb" : {
        "maxIopsPerTb":17000
    }
  }

    • ‫CAPACITY הוא הגודל ב-GiB שרוצים להקצות למופע. לדוגמה, 1024.

    • ‫SHARE_NAME הוא שם שיתוף הקבצים. לדוגמה, vol1.

    • PROTECTION_REASON אם בוחרים להשתמש בדגל deletionProtectionEnabled, אפשר להוסיף הערה לגבי ההגדרה. כדי להוסיף את ההערה, משתמשים בדגל האופציונלי deletionProtectionReason וכוללים תיאור של ההצדקה להגדרה שבחרתם. לדוגמה, "All genomics data must adhere to current organization policies." מידע נוסף זמין במאמר בנושא הגנה מפני מחיקה.

    דוגמה

    בדוגמה הבאה אנחנו מעדכנים את מכונת nfs-server על ידי הקטנת היחס בין IOPS ל-TiB ל-12000.

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/my-project/locations/us-central1/instances?instanceId=nfs-server?updateMask=performanceConfig%2CdeletionProtectionReason&key=12334fr232' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
              "performanceConfig":
                {
                  "iopsPerTb":
                    {
                      "maxIopsPerTb":12000
                    }
                },
              "deletionProtectionReason":"Deletion+not+allowed"}' \
    --compressed

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