העברת קטגוריות

המסוף

1. במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
   

   כניסה לדף Buckets

2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים להעביר.
3. בדף Bucket details, לוחצים על הכרטיסייה Configuration.
4. בקטע סקירה כללית, לוחצים על edit עריכה לצד השדה מיקום.
5. בדף Relocate bucket, מזינים את המיקום החדש של הקטגוריה. אחרי כל אחד מהשלבים הבאים, לוחצים על המשך כדי לעבור לשלב הבא:
   1. בקטע Confirm the bucket you plan to relocate, בודקים את הקטגוריה ואת המיקום שלה.
   2. בקטע לפני שממשיכים, בודקים את ההגדרות שחוסמות את ההעברה. אם יש הגבלה על הקטגוריה, אפשר להשתמש ב-Storage Transfer Service כפתרון חלופי.

   3. בקטע Choose where to relocate your bucket:

      1. בוחרים סוג מיקום.

      2. בוחרים מיקום שבו יישמרו נתוני האובייקטים בקטגוריה.

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

   4. בקטע בחירת אופן הפעולה, לוחצים על התחלה בהרצה יבשה (מומלץ). הרצה לניסיון מדמה את הרילוקיישן כדי לזהות בעיות פוטנציאליות בלי להעביר נתונים.
   5. לוחצים על Continue.
6. לוחצים על התחלה.
7. בתיבת הדו-שיח לאישור Start with a dry run, קוראים את ההודעה שמופיעה ולוחצים על Start dry run.

אחרי שמפעילים הרצת בדיקה, מתחילה פעולה ממושכת. אפשר לעקוב אחרי ההתקדמות בכרטיסייה Operations בדף bucket details.

שורת הפקודה

כדי להפעיל הרצת בדיקה, מריצים את הפקודה gcloud storage buckets relocate עם הדגל --dry-run:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION --dry-run

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.

• ‫LOCATION הוא מיקום היעד של הקטגוריה.

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

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

‫API בפורמט JSON

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

2. יוצרים קובץ JSON שבו מופיעות ההגדרות של הקטגוריה. הקובץ חייב להכיל את הפרמטרים destinationLocation ו-validateOnly. לרשימה מלאה של ההגדרות קראו את מסמכי העזרה של Buckets: relocate. ההגדרות הנפוצות שצריך לכלול בקובץ:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
       "dataLocations": [
         LOCATIONS,
           ...
           ]
       },
     "validateOnly": "true"
     }

   כאשר:

   • ‫DESTINATION_LOCATION הוא מיקום היעד של הקטגוריה.
   • ‫LOCATIONS היא רשימה של קודי מיקום שמשמשים להגדרה בשני אזורים.
   • הערך של validateOnly מוגדר כ-true כדי לבצע הרצת בדיקה.

3. משתמשים ב-cURL כדי לשלוח קריאה ל-API בפורמט JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/relocate"

   כאשר:

   • ‫JSON_FILE_NAME הוא השם של קובץ ה-JSON שיצרתם.
   • ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.

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

   • ההרצה לבדיקה לא מדווחת על שגיאות.

   • המשאב operations מחזיר ערך של true בשדה done.

     {
     "kind": "storage#operation",
     "name": "projects/_/buckets/bucket/operations/operation_id",
     "metadata": {
       "@type": OperationMetadataType*,
       metadata OperationMetadata*
     },
     "done": "true",
     "response": {
           "@type": ResponseResourceType*,
           response ResponseResource*
         }
       }

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

המסוף

1. במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
   

   כניסה לדף Buckets

2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים להעביר.
3. בדף Bucket details, לוחצים על הכרטיסייה Configuration.
4. בקטע סקירה כללית, לוחצים על edit עריכה לצד השדה מיקום.
5. בדף Relocate bucket, מזינים את המיקום החדש של הקטגוריה. אחרי כל אחד מהשלבים הבאים, לוחצים על המשך כדי לעבור לשלב הבא:
   1. בקטע Confirm the bucket you plan to relocate, בודקים את הקטגוריה ואת המיקום שלה.
   2. בקטע לפני שממשיכים, בודקים את ההגדרות שחוסמות את ההעברה. אם יש הגבלה על הקטגוריה, אפשר להשתמש ב-Storage Transfer Service כפתרון חלופי.

   3. בקטע Choose where to relocate your bucket:

      1. בוחרים סוג מיקום.

      2. בוחרים מיקום שבו יישמרו נתוני האובייקטים בקטגוריה.

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

   4. בקטע איך היית רוצה להמשיך?, לוחצים על העברה עכשיו.
   5. לוחצים על Continue.
6. כדי להתחיל בתהליך ההעברה, לוחצים על התחלה.
7. בתיבת הדו-שיח לאישור Relocate now, קוראים את ההודעה שמופיעה ולוחצים על Start relocate.

אחרי שמתחילים את תהליך ההעברה, מתחילה פעולה ממושכת. אפשר לעקוב אחרי ההתקדמות בכרטיסייה Operations בדף bucket details.

שורת הפקודה

כדי להתחיל את העברת קטגוריות למיקום גיאוגרפי אחר, מריצים את הפקודה gcloud storage buckets relocate:

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.

• ‫LOCATION הוא מיקום היעד של הקטגוריה.

‫API בפורמט JSON

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

2. יוצרים קובץ JSON עם ההגדרות של הקטגוריה. לרשימה מלאה של ההגדרות קראו את מסמכי העזרה של Buckets: relocate. ההגדרות הנפוצות שצריך לכלול בקובץ:

   {
     "destinationLocation": "DESTINATION_LOCATION",
     "destinationCustomPlacementConfig": {
     "dataLocations": [
       LOCATIONS,
       ...
       ]
       },
     "validateOnly": "false"
     }

   כאשר:

   • ‫DESTINATION_LOCATION הוא מיקום היעד של הקטגוריה.
   • ‫LOCATIONS היא רשימה של קודי מיקום שמשמשים להגדרה בשני אזורים.
   • הערך של validateOnly מוגדר כ-false כדי להתחיל את העברת הקטגוריה למיקום גיאוגרפי אחר.

3. משתמשים ב-cURL כדי לשלוח קריאה ל-API בפורמט JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/relocate"

   כאשר:

   • ‫JSON_FILE_NAME הוא השם של קובץ ה-JSON שיצרתם.
   • ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.

המסוף

כדי לעקוב אחרי ההתקדמות של ההרצה היבשה או של תהליך הרילוקיישן:

1. במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
   

   כניסה לדף Buckets

2. ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שרוצים להעביר.

3. בדף Bucket details, לוחצים על הכרטיסייה Operations.

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

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

שורת הפקודה

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

‫API בפורמט JSON

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

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

  done: false
  kind: storage#operation
  metadata:
  '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketMetadata
  commonMetadata:
    createTime: '2024-10-21T04:26:59.666Z
    endTime: '2024-12-29T23:39:53.340Z'
    progressPercent: 99
    requestedCancellation: false
    type: relocate-bucket
    updateTime: '2024-10-21T04:27:03.2892'
  destinationLocation: US-CENTRAL1
  finalizationState: 'READY'
  progress:
    byteProgressPercent: 100
    discoveredBytes: 200
    remainingBytes: 0
    discoveredObjectCount: 10
    remainingObjectCount: 8
    objectProgressPercent: 100
    discoveredSyncCount: 8
    remainingSyncCount: 0
    syncProgressPercent: 100
  relocationState: SYNCING
  sourceLocation: US
  validateOnly: false
  estimatedWriteDowntimeDuration: '7200s'
  writeDowntimeExpireTime: '2024-12-30T10:34:01.786Z'
  name: projects//buckets/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
  response:
    '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketResponse
      selfLink: https://storage.googleusercontent.com/storage/v1_ds/b/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w

בטבלה הבאה מפורט מידע על שדות המפתח בפלט שנוצר על ידי פעולת ההעברה:

אם נתקלתם בבעיות באינטראקציה עם תכונות אחרות של Cloud Storage, תוכלו להיעזר בקטע מגבלות.

המסוף

כדי להתחיל את שלב הסנכרון הסופי:

1. במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
   

   כניסה לדף Buckets

2. ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שרוצים להעביר.

3. בדף Bucket details, לוחצים על הכרטיסייה Operations.

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

5. אופציונלי: כדי להגדיר את זמן ההשבתה המקסימלי המותר לכתיבה, לוחצים על Set maximum allowed downtime (TTL) ומציינים את משך זמן ההשבתה המקסימלי.

6. לוחצים על התחלת הסנכרון הסופי.

7. בתיבת הדו-שיח שמופיעה, לוחצים על Start כדי להתחיל את הסנכרון הסופי.

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

שורת הפקודה

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

כשהערך של finalizationState הוא READY, מריצים את הפקודה gcloud storage buckets relocate כדי להתחיל את הסנכרון הסופי:

gcloud storage buckets relocate --finalize --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

כאשר:

• ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.
• ‫OPERATION_ID הוא המזהה של הפעולה הממושכת להעברת הקטגוריה למיקום גיאוגרפי אחר, שמוחזר בתגובה לשיטות שאתם מפעילים. לדוגמה, התגובה הבאה מוחזרת מקריאה ל-gcloud storage operations list ומזהה הפעולה הממושכת הוא AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74.

 `name: projects/_/buckets/my-bucket/operations/AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74` 

מגדירים את הדגל ttl כדי לקבל שליטה טובה יותר בתהליך ההעברה. לדוגמה:

gcloud storage buckets relocate --finalize --ttl TTL_DURATION --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

כאשר:

‫TTL_DURATION הוא אורך החיים (TTL) של שלב זמן ההשבתה של הכתיבה במהלך תהליך ההעברה. הוא מבוטא כמחרוזת, למשל 12h ל-12 שעות. הערך של TTL_DURATION קובע את משך הזמן המקסימלי המותר לשלב זמן ההשבתה של הכתיבה. אם זמן ההשבתה של פעולות הכתיבה חורג מהמגבלה הזו, תהליך ההעברה חוזר באופן אוטומטי לשלב של העברת קטגוריות למיקום גיאוגרפי אחר, ופעולות הכתיבה בקטגוריה מופעלות מחדש. הערך חייב להיות בטווח שבין 6h (6 שעות) ל-48h (48 שעות). אם לא מציינים ערך, ערך ברירת המחדל הוא 12h (12 שעות).

‫API בפורמט JSON

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

אם תפעילו את שלב הסנכרון הסופי מוקדם מדי, הפקודה תחזיר הודעת שגיאה The relocate bucket operation isn't ready to advance to finalization running state אבל תהליך ההעברה יימשך.

מומלץ להמתין עד שהערך של progressPercent יהיה 99 לפני שמתחילים את שלב הסנכרון הסופי.

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

2. יוצרים קובץ JSON שבו מופיעות ההגדרות להעברת הקטגוריה למיקום גיאוגרפי אחר. לרשימה מלאה של ההגדרות קראו את מסמכי העזרה של Buckets: advanceRelocateBucket. ההגדרות הנפוצות שצריך לכלול בקובץ:

   {
   "expireTime": "EXPIRE_TIME",
   "ttl": "TTL_DURATION"
   }

   כאשר:

   • ‫EXPIRE_TIME הוא הזמן שבו מסתיים זמן ההשבתה של הכתיבה.
   • ‫TTL_DURATION הוא אורך החיים (TTL) של שלב זמן ההשבתה של הכתיבה במהלך תהליך ההעברה. הוא מבוטא כמחרוזת, למשל 12h ל-12 שעות. הערך של TTL_DURATION קובע את משך הזמן המקסימלי המותר לשלב זמן ההשבתה של הכתיבה. אם זמן ההשבתה של פעולות הכתיבה חורג מהמגבלה הזו, תהליך ההעברה חוזר באופן אוטומטי לשלב של העברת קטגוריות למיקום גיאוגרפי אחר, ופעולות הכתיבה בקטגוריה מופעלות מחדש. הערך חייב להיות בטווח שבין 6h (6 שעות) ל-48h (48 שעות). אם לא מציינים ערך, ערך ברירת המחדל הוא 12h (12 שעות).

3. משתמשים ב-cURL כדי לשלוח קריאה ל-API בפורמט JSON:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
    "https://storage.s3nsapis.fr/storage/v1/b/bucket/BUCKET_NAME/operations/OPERATION_ID/advanceRelocateBucket"

   כאשר:

   • ‫JSON_FILE_NAME הוא השם של קובץ ה-JSON שיצרתם.
   • ‫BUCKET_NAME הוא שם הקטגוריה שרוצים להעביר.
   • ‫OPERATION_ID הוא המזהה של הפעולה הממושכת שהתחילה את העברת הקטגוריה למיקום גיאוגרפי אחר. כדי לקבל את רשימת המזהים של פעולות ממושכות בקטגוריה, ראו פעולות: רשימה.