במדריך הזה מוסבר איך להשתמש בשכפול של מופע Filestore.
לפני שמתחילים
כדי להשתמש ב-Filestore, צריך להשלים את שלבי ההגדרה. המיכסה של מופעים משתנה בהתאם לפרויקט, לאזור ולרמת המינוי. חשוב לוודא שיש לכם מספיק זמן כדי להשלים את המשימות האלה. מידע נוסף זמין במאמרים בנושא מכסות או שליחת בקשה להגדלת מכסה.
אם עדיין לא עשיתם זאת, יוצרים מופע Filestore. בהקשר של המדריך הזה, זהו מופע המקור.
יצירת עותק משוכפל של מופע
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
לוחצים על מספר המכונה של המכונה שרוצים לשכפל.
לוחצים על הכרטיסייה שכפולים.
לוחצים על יצירת העתק.
לוחצים על הקישור לתיעוד כדי לעיין ביעד להתאוששות מאסון (RPO) שנתמך, ואז לוחצים על הבא.
מזינים את כל שדות החובה ואת השדות האופציונליים לפי הצורך.
- הקיבולת שצוינה חייבת להיות גדולה מהקיבולת של המקור או שווה לה.
- המפרטים הבאים צריכים להיות זהים למופע המקור:
- רמת שירות, כולל טווח הקיבולת
- פרוטוקול Filestore
- כדי להקטין את הסיכון לאובדן נתונים, מומלץ לבחור אזור ותחום שייחודיים למקור.
לוחצים על הבא.
בודקים את הפרטים ולוחצים על הבא.
לוחצים על יצירה.
ממתינים לסיום הפעולה. כשהפעולה תסתיים, העותק המשוכפל יופיע מתחת למכונת המקור בדף Instances (מכונות).
לוחצים על מזהה המופע של העותק כדי לראות את הפרטים שלו.
gcloud
כדי ליצור מכונת העתקה, מריצים את הפקודה
filestore instances create.gcloud filestore instances create INSTANCE_ID \ --source-instance=projects/PROJECT_ID/locations/LOCATION/instances/SOURCE_INSTANCE \ --project=PROJECT_ID \ --location=LOCATION \ --network=name="NETWORK" \ --tier=TIER \ --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
כאשר:
- INSTANCE_ID בשם המכונה שרוצים ליצור, למשל
my-replica. - SOURCE_INSTANCE בשם ובמיקום של מופע המקור שרוצים ליצור לו העתק. לדוגמה,
projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance. - PROJECT_ID עם מזהה הפרויקט של הפרויקט Google Cloud שבו נמצא מופע המקור.
- LOCATION במיקום שבו רוצים שהעתק של מופע הנתונים ישכון, כמו
us-central1-a. אם המקור נמצא ברמת שירות אזורית, צריך לציין גם אזור וגם אזור משנה בשביל העותק. - NETWORK בשם הרשת שרוצים להשתמש בה, למשל
default. - TIER עם רמת השירות שאתם צריכים, כמו
ZONAL. הדרגה וטווח הקיבולת חייבים להיות זהים לאלה שבמקור. - FILE_SHARE_NAME עם השם שציינתם לשיתוף קבצים ב-NFS שמוגש מהמופע, כמו
vol1. - FILE_SHARE_SIZE עם הגודל הרצוי לשיתוף הקובץ, כמו
1.25TiB.
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי להפעיל את Filestore API:curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{"tier": "TIER", "networks": { "network": "NETWORK" }, "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"}, "replication": {"replicas":[{"peer_instance": "projects/PROJECT/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"}, "description": "DESCRIPTION" }' \ "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"כאשר:
-
TIERהוא שם רמת השירות שרוצים להשתמש בה בשביל העותק. לדוגמה,REGIONAL. -
NETWORKהוא שם הרשת שרוצים להשתמש בה בשביל העותק. לדוגמה,default. חובה להשתמש באותה רשת כמו המקור. -
SHARE_NAMEהוא שם שיתוף הקבצים. לדוגמה,vol1. -
CAPACITYהוא הגודל ב-GiB שרוצים להקצות לשכפול. לדוגמה,1024. הקיבולת חייבת להיות גדולה יותר או שווה לקיבולת של מופע המקור. -
PROJECTהוא שם הפרויקט שבו נמצאת הרפליקה. לדוגמה,my-genomics-project. המקור וההעתק צריכים להיות באותו פרויקט. -
ACTIVE_LOCATIONהוא המיקום שבו נמצא המקור. לדוגמה,us-east1. -
ACTIVE_NAMEהוא שם המופע שרוצים לשכפל. לדוגמה,my-genomics-instance. -
DESCRIPTIONהוא תיאור של מופע הרפליקה שרוצים ליצור. לדוגמה,My genomics replica. -
REPLICA_LOCATIONהוא המיקום שבו רוצים שהעותק יהיה. לדוגמה,us-central1. -
REPLICA_INSTANCE_NAMEהוא השם של מופע הרפליקה שרוצים ליצור. לדוגמה,my-genomics-replica.
-
צפייה בסטטוס של העותק
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
לוחצים על מספר המכונה של העותק המשוכפל שרוצים לראות.
בקטע תיאור, לוחצים על הכרטיסייה שכפולים.
כאן אפשר לראות את סטטוס הרפליקה ואת נקודת הסנכרון האחרונה, חותמת זמן של הפעם האחרונה שבה עותק מלא של הנתונים הועתק לרפליקה.
gcloud
כדי לראות מידע על מופע ספציפי, מריצים את הפקודה
instances describe:gcloud filestore instances describe INSTANCE_ID \ --project=PROJECT_ID \ --location=LOCATION \
כאשר:
- INSTANCE_ID עם מספר המכונה של מכונת Filestore שרוצים להציג, למשל
genomics-instance. - PROJECT_ID במזהה הפרויקט של הפרויקט Google Cloud שמכיל את מופע Filestore.
LOCATION עם המיקום שבו המכונה נמצאת, למשל
us-east1-b.התשובה לפקודה
instances describeדומה לאחת מהדוגמאות הבאות.בדוגמה הזו לתגובה מוצג מופע של מקור עם שכפול מופעים מופעל. שימו לב שהתפקיד שצוין הוא
ACTIVE:createTime: '2024-06-17T22:17:26.475900265Z' fileShares: - capacityGb: '1024' name: vol1 name: projects/genomics-project/locations/us-east1-b/instances/genomics-instance-source networks: - connectMode: DIRECT_PEERING ipAddresses: - 172.27.220.2 modes: - MODE_IPV4 network: default reservedIpRange: 172.27.220.0/26 replication: replicas: - peerInstance: projects/genomics-project/locations/us-central1-a/instances/genomics-instance-replica state: READY role: ACTIVE state: READY tier: ZONALבדוגמה הזו לתגובה מוצג מופע משוכפל שקודם לדרגת מופע רגיל. שימו לב שהרפליקציה לא מצוינת כי היא עדיין לא הופעלה:
createTime: '2024-06-20T17:11:56.048062134Z' fileShares: - capacityGb: '1024' name: vol1 name: projects/genomics-project/locations/us-west2-a/instances/genomics-instance-replica networks: - connectMode: DIRECT_PEERING ipAddresses: - 10.155.90.194 network: default reservedIpRange: 10.155.90.192/26 satisfiesPzi: true state: READY tier: ZONALבדוגמה הזו לתגובה מוצגת רפליקה ששויכה למופע פעיל. שימו לב שהתפקיד מופיע בתור
STANDBY:createTime: '2024-06-21T04:15:21.721579074Z' fileShares: - capacityGb: '1280' name: vol1 name: projects/genomics-project/locations/us-west1-a/instances/genomics-replica networks: - connectMode: DIRECT_PEERING ipAddresses: - 10.153.44.194 network: default reservedIpRange: 10.153.44.192/26 replication: replicas: - peerInstance: projects/genomics-project/locations/us-west2-a/instances/genomics-instance state: READY role: STANDBY satisfiesPzi: true state: READY tier: ZONAL
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
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.
-
הצגת רשימה של כל העותקים המשוכפלים בפרויקט
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
העותקים מופיעים מתחת למופעי המקור המשויכים.
gcloud
כדי לראות רשימה של כל המופעים בפרויקט, מריצים את הפקודה
instances list:gcloud filestore instances list --project=PROJECT-ID \כאשר:
- PROJECT-ID עם מזהה הפרויקט שרוצים להציג.
בתגובה מוחזרת רשימה של מופעים ועותקים משוכפלים, בדומה לדוגמה הבאה:
INSTANCE_NAME LOCATION TIER CAPACITY_GB FILE_SHARE_NAME IP_ADDRESS STATE CREATE_TIME genomics-source-1 us-east1-b ZONAL 1024 vol1 172.27.220.2 READY 2024-06-17T22:17:26 genomics-source-1-replica us-west1-a ZONAL 1024 vol1 10.142.57.194 READY 2024-06-17T23:47:19
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
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הוא המיקום שרוצים לחפש. כדי לחפש את כל המקרים בכל מיקום בפרויקט, משתמשים ב--.
-
השהיית השכפול
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
לוחצים על מספר המכונה של העותק שבו רוצים להשתמש.
בקטע תיאור, לוחצים על הכרטיסייה שכפולים.
בקטע פרטים של מופע פעיל, לוחצים על השהיית השכפול.
קוראים את ההתראה לפני שממשיכים ומאשרים בלחיצה על השהיית השכפול.
סטטוס השכפול ישתנה לבהשהיה. אחרי שהפעולה מסתיימת, סטטוס השכפול משתנה למושהה ומוצג התאריך שבו ההעתק הושהה.
gcloud
כדי להשהות מופע משוכפל, מריצים את הפקודה gcloud filestore instances pause-replica.
gcloud filestore instances pause-replica INSTANCE_ID \
--project=PROJECT_ID \
--location=LOCATION \
כאשר:
- INSTANCE_ID עם מזהה המופע של מופע Filestore שרוצים להשהות, למשל
my-replica. - PROJECT_ID עם מזהה הפרויקט של הפרויקט Google Cloud שמכיל את מופע Filestore.
- LOCATION עם המיקום שבו נמצא העותק, למשל
us-central1.
אם הפעולה בוצעה ללא שגיאות, התגובה הבאה או תגובה דומה מוחזרת:
createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-east1-b
fileShares:
- capacityGb: '1024'
name: share
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.229.150.130
modes:
- MODE_IPV4
network: default
reservedIpRange: 10.229.150.128/26
performanceLimits:
maxIops: '12000'
maxReadIops: '12000'
maxReadThroughputBps: '125829120'
maxWriteIops: '4000'
maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
replicas:
- peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
state: PAUSED
stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
role: STANDBY
state: READY
tier: REGIONAL
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי להפעיל את Filestore API:curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:pauseReplica"כאשר:
-
PROJECTהוא שם הפרויקט שבו נמצא העותק המשוכפל. לדוגמה,my-genomics-project. -
LOCATIONהוא המיקום שבו נמצא העותק. לדוגמה,us-west1-a. -
REPLICA_NAMEהוא שם המופע שרוצים להשהות. לדוגמה,my-genomics-replica.
-
המשך השכפול
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
לוחצים על מספר המכונה של העותק שבו רוצים להשתמש.
בקטע תיאור, לוחצים על הכרטיסייה שכפולים.
בקטע פרטים של מופע פעיל, לוחצים על המשך השכפול.
קוראים את ההתראה לפני שממשיכים ומאשרים על ידי הזנת
resumeבשדה שמופיע.
סטטוס השכפול משתנה להמשך. אחרי שהפעולה מסתיימת, סטטוס השכפול משתנה למוכן.
gcloud
כדי להפעיל מחדש מכונת העתקה, מריצים את הפקודה gcloud filestore instances resume-replica.
gcloud filestore instances resume-replica INSTANCE_ID \
--project=PROJECT_ID \
--location=LOCATION \
כאשר:
- INSTANCE_ID עם מספר המכונה של מכונת העותק המשוכפל של Filestore שרוצים להפעיל מחדש, למשל
my-replica. - PROJECT_ID במזהה הפרויקט של הפרויקט Google Cloud שמכיל את מופע השכפול של Filestore.
- LOCATION עם המיקום שבו נמצא העותק, למשל
us-central1.
אם הפעולה בוצעה ללא שגיאות, התגובה הבאה או תגובה דומה מוחזרת:
createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-central1
fileShares:
- capacityGb: '1024'
name: share
name: projects/genomics-project/locations/us-central1/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.229.150.130
modes:
- MODE_IPV4
network: default
reservedIpRange: 10.229.150.128/26
performanceLimits:
maxIops: '12000'
maxReadIops: '12000'
maxReadThroughputBps: '125829120'
maxWriteIops: '4000'
maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
replicas:
- peerInstance: projects/genomics-project/locations/us-central1/instances/my-source
state: READY
stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
role: STANDBY
state: READY
tier: REGIONAL
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי להפעיל את Filestore API:curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"כאשר:
-
PROJECTהוא שם הפרויקט שבו נמצא העותק המשוכפל. לדוגמה,my-genomics-project. -
LOCATIONהוא המיקום שבו נמצא העותק. לדוגמה,us-west1-a. -
REPLICA_NAMEהוא שם המופע שרוצים להפעיל מחדש. לדוגמה,my-genomics-replica.
-
הפסקת הרפליקציה והעלאת העותק המשוכפל לרמה של עותק ראשי
בקטע הזה נסביר איך להפסיק את השכפול בין המופעים הפעילים לבין מופעי ההמתנה. הפעולה הזו מקדמת את העותק למכונה רגילה.
אי אפשר לבטל את הפעולה הזו, ולכן חשוב להשתמש בה בזהירות.
אחרי שהמשאב מקודם למופע רגיל, אפשר לשייך אותו לשכפול חדש.
מעבר לגיבוי לא מתבצע באופן אוטומטי. אחרי שהפעולה להפסקת השכפול תושלם, האדמינים יצטרכו לחבר מחדש את האפליקציות שלהם למופע המקור החדש. מידע נוסף זמין במאמר בנושא קידום רפליקה.
מסוף Google Cloud
נכנסים לדף Instances של Filestore במסוף Google Cloud .
לוחצים על מספר המכונה של העותק שבו רוצים להשתמש.
לוחצים על הפסקת השכפול.
לפני שממשיכים, חשוב לקרוא את ההתראה.
הפסקת הרפליקציה תגרום להפסקת סנכרון הנתונים באופן סופי, ותמיר את המופעים הפעילים ואת מופעי ההמתנה למופעים רגילים. שינויים שבוצעו אחרי נקודת הסנכרון האחרונה שתועדה לא ישוכפלו. אי אפשר לבטל את הפעולה הזו.
מזינים את מזהה המכונה של העותק ולוחצים על הפסקת השכפול.
ממתינים לסיום הפעולה בהצלחה.
gcloud
אפשר לקדם מופע משוכפל על ידי הרצת הפקודה gcloud filestore instances promote-replica.
gcloud filestore instances promote-replica INSTANCE-ID \
--project=PROJECT-ID \
--location=LOCATION \
כאשר:
- INSTANCE_ID עם מספר המכונה של מכונת Filestore שרוצים לקדם, למשל
my-replica. - PROJECT_ID עם מזהה הפרויקט של הפרויקט Google Cloud שמכיל את מופע Filestore.
- LOCATION עם המיקום שבו נמצא העותק, למשל
us-central1.
אם הפעולה בוצעה ללא שגיאות, התגובה הבאה או תגובה דומה מוחזרת:
capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
name: vol1
maxCapacityGb: '9984'
maxShareCount: '1'
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
ipAddresses:
- 10.155.90.194
network: default
reservedIpRange: 10.155.90.192/26
protocol: NFS_V3
replication:
replicas:
- lastActiveSyncTime: '2024-06-21T00:13:23Z'
peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
role: STANDBY
satisfiesPzi: true
state: PROMOTING
tier: ZONAL
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי להפעיל את Filestore API:curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"כאשר:
-
PROJECTהוא שם הפרויקט שבו נמצא העותק המשוכפל. לדוגמה,my-genomics-project. -
LOCATIONהוא המיקום שבו נמצא העותק. לדוגמה,us-west1-a. -
REPLICA_NAMEהוא שם המופע שרוצים להעביר לסטטוס של מופע ראשי. לדוגמה,my-genomics-replica.
-
מחיקת מכונת העתקה
מסוף Google Cloud
נכנסים לדף Filestore instances במסוף Google Cloud .
העותקים מופיעים מתחת למופעי המקור המשויכים. אם לא רואים העתק, אפשר לעיין בפקודות של
gcloudשרלוונטיות למשימה הזו.לוחצים על מספר המכונה של המכונה שרוצים למחוק.
לוחצים על Delete.
gcloud
כדי לראות רשימה של כל המופעים, כולל העתקים, בפרויקט, מריצים את הפקודה
instances list:gcloud filestore instances list --project=PROJECT_ID \כאשר:
- PROJECT_ID עם מזהה הפרויקט שרוצים לראות.
מעתיקים את הפרטים של המופע שרוצים למחוק.
כדי למחוק מופע, מריצים את הפקודה
filestore instances delete.gcloud filestore instances delete INSTANCE_ID \ --location=LOCATION \
כאשר:
- INSTANCE_ID עם מזהה המכונה של מכונת Filestore שרוצים למחוק, כמו
my-replica. - LOCATION עם המיקום שבו נמצא העותק, למשל
us-central1-a.
API בארכיטקטורת REST
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי להפעיל את Filestore API:curl -s \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json" \ --request DELETE "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.
-
מעקב אחר שכפול מופעים
מסוף Google Cloud
כדי לראות את מדדי השכפול של מופע Filestore בלוח בקרה של Cloud Monitoring:
לפני שמתחילים, חשוב לוודא שיש לכם גישה לתפקידים הבאים:
- כלי לצפייה בניטור
- עורך/ת מעקב
במאמר מתן גישה ל-Cloud Monitoring מוסבר איך נותנים גישה לתפקידים האלה.
-
נכנסים לדף leaderboard Metrics explorer במסוף Google Cloud :
אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
לוחצים על הקטע בחירת מדד כדי להרחיב אותו.
בשדה Filter by resource or metric name (סינון לפי שם המשאב או המדד), מקלידים
filestoreובוחרים בקטע הניתן להרחבה Filestore Instance (מופע Filestore).בוחרים בקטע Instance (מופע) שניתן להרחבה ולוחצים על RPO (יעד זמן ההתאוששות).
מוצג מדד ה-RPO
times_since_last_replication. המדד הזה יהיה זמין כמה דקות אחרי שהסנכרון הראשוני של הנתונים המשוכפלים יסתיים.
המאמרים הבאים
- מידע נוסף על שכפול מופעים
- קריאת מאמרי העזרה בנושא שכפול מופעים