קבלת מידע על מכונה

בדף הזה מוסבר איך לקבל מידע על מופעי Filestore.

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

כדי להשתמש בדוגמאות של שורת הפקודה בדף הזה, צריך להפעיל את כלי שורת הפקודה gcloud על ידי התקנת ה-CLI של gcloud.

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

מסוף Google Cloud

כדי לקבל מידע על מופעי Filestore ולראות את כל המופעים בפרויקט, אפשר לעבור לדף Filestore instances (מופעי Filestore):

כניסה לדף Filestore instances

gcloud

כדי לקבל מידע על מופעי Filestore ולראות את כל המופעים בפרויקט, מריצים את הפקודה instances list:

  gcloud filestore instances list --project=project-id --zone=zone

where:

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

      gcloud config set project project-id

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

התגובה לפקודה instances list תהיה דומה לזו:

INSTANCE_NAME  ZONE            TIER       CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS  STATE   CREATE_TIME
nfs-loc        europe-west1-b  BASIC_HDD  1024         nfs1             10.0.5.2    READY   2017-10-09T22:11:28
nfs3           us-central1-c   BASIC_HDD  1024         acme             10.0.6.2    READY   2017-11-06T09:37:18

דוגמה

הפקודה הבאה מציגה רשימה של מופעי Filestore בפרויקט myproject:

  gcloud filestore instances list --project=myproject

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

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

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

    curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

    כאשר:

    • ‫PROJECT הוא שם הפרויקט שבו נמצא המופע. לדוגמה, my-genomics-project.
    • ‫LOCATION הוא המיקום שרוצים לחפש. כדי לחפש את כל המקרים בכל מיקום בפרויקט, משתמשים ב--.

קבלת מידע על מופע ספציפי

אפשר להשתמש באחת מהפרוצדורות הבאות כדי לקבל מידע על מכונת Filestore ספציפית.

מסוף Google Cloud

  1. עוברים לדף של מופעי Filestore.

    כניסה לדף Filestore instances

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

gcloud

כדי לקבל מידע על מופע Filestore, מריצים את הפקודה instances describe:

    gcloud filestore instances describe instance-id --project=project-id --location=location

התגובה לפקודה instances describe תהיה דומה לזו:

createTime: '2021-10-11T17:28:23.340943077Z'
customPerformanceSupported: true
fileShares:
- capacityGb: '1024'
 name: vol1
kmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key
labels:
 key:val
name: projects/yourproject/locations/us-central1/instances/nfs-server
networks:
- ipAddresses:
 - 10.0.0.2
 network: default
 reservedIpRange: 10.0.0.0/26
performanceConfig:
  iopsPerTb:
    maxIopsPerTb: '17000'
performanceLimits:
  maxIops: '17000'
  maxReadIops: '17000'
  maxReadThroughputBps: '417792000'
  maxWriteIops: '5100'
  maxWriteThroughputBps: '139264000'
state: READY
tier: REGIONAL

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

  • ‫createTime: השעה שבה נוצר המופע, בפורמט RFC 3339.
  • fileShares:
  • ‫capacityGb: הגודל של שיתוף הקבצים ב-Filestore בגיגה-בייט בינארי (GB), כאשר 1 GB = 1,0243 בייטים.
  • ‫name: השם של שיתוף הקבצים ב-Filestore. משתמשים בשם של שיתוף הקבצים עם כתובת ה-IP שזוהתה על ידי הערך ipAddresses כדי לטעון את שיתוף הקבצים בלקוח.
  • ‫name: השם המוגדר במלואו של המכונה.
  • ‫ipAddresses: כתובת ה-IP של המכונה. כדי לטעון את שיתוף הקבצים של Filestore בלקוח, צריך להשתמש בערך הזה יחד עם שם שיתוף הקבצים.
  • ‫network: השם של רשת ה-VPC שבה המכונה משתמשת.
  • ‫customPerformanceSupported: מציין אם המופע תומך בביצועים בהתאמה אישית. אם לא מופיע ברשימה, אין תמיכה בביצועים בהתאמה אישית.
  • ‫performanceConfig: ההגדרה המותאמת אישית לביצועים מותאמים אישית.
  • ‫performanceLimits: מגבלות הביצועים שנאכפות, שמחושבות לפי הביצועים של המופע.
  • ‫reservedIpRange: בלוק כתובות ה-IP ששמור לשימוש במופע.
  • ‫state: הסטטוס של המכונה.
  • ‫tier: רמת השירות של Filestore של המכונה.

דוגמה

הפקודה הבאה מספקת מידע על מופע test-nfs בפרויקט myproject, באזור us-central1.

gcloud filestore instances describe test-nfs --project=myproject --region=us-central1

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

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

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

    curl -s \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header "Content-Type: application/json" \
  GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    כאשר:

    • ‫PROJECT הוא שם הפרויקט שבו נמצא המופע. לדוגמה, my-genomics-project.
    • ‫LOCATION הוא המיקום שבו נמצא המופע. לדוגמה, us-west1-a.
    • ‫INSTANCE_NAME הוא שם המופע שרוצים להציג. לדוגמה, my-genomics-instance.

קבלת מידע על נקודות העיגון של מופע Filestore

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

הצגת נקודות הטעינה של מופע

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

    sudo showmount -a INSTANCE_IP

דוגמה

הפקודה הבאה מציגה רשימה של כל נקודות הטעינה של מופע Filestore עם כתובת ה-IP‏ 10.77.67.226:

    sudo showmount -a 10.77.67.226

התגובה אמורה להיראות כך:

All mount points on 10.77.67.226:
10.128.0.1:/fileshare
10.128.0.2:/fileshare
10.128.0.3:/fileshare

קבלת מספר נקודות הטעינה של מכונה

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

    sudo showmount -a INSTANCE_IP --no-headers | wc -l

דוגמה

הפקודה הבאה מציגה את מספר נקודות הגישה למופע עם כתובת ה-IP‏ 10.77.67.226:

    sudo showmount -a 10.77.67.226 --no-headers | wc -l

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