העלאה והורדה של אובייקטים באחסון

בדף הזה מוסבר איך להעלות אובייקטים לקטגוריות אחסון במכשיר Google Distributed Cloud (GDC) עם בידוד פיזי ואיך להוריד אובייקטים מהקטגוריות האלה.

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

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

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

כדי להריץ פקודות בשרת של Management API, צריך להיכנס וליצור את קובץ ה-kubeconfig של שרת Management API, אם אין לכם כזה.

הנחיות למתן שמות לאובייקטים

כדי לתת שמות לאובייקטים, פועלים לפי ההנחיות הבאות:

• כשנותנים שמות לאובייקטים, משתמשים בתווים בקידוד UTF-8.
• אל תכללו פרטים אישיים מזהים (PII).

העלאת אובייקטים לקטגוריות אחסון

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

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

הפקודה הבאה מעלה את כל קובצי הטקסט מהספרייה המקומית לקטגוריה:

gdcloud storage cp *.txt s3://BUCKET

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

gdcloud storage cp abc1.txt abc2.txt s3://BUCKET

כדי להעלות תיקייה לקטגוריית אחסון, משתמשים באפשרות ‎--recursive כדי להעתיק את כל עץ התיקיות. הפקודה הבאה מעלה את עץ הספרייה dir:

gdcloud storage cp dir s3://BUCKET --recursive

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

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

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

• ‫--disable-multipart: משבית את העלאות החלקיות לכל הקבצים.
• ‫--multipart-chunk-size-mb=SIZE: מגדיר את הגודל של כל נתח בהעלאה מרובת חלקים.

קבצים שגדולים מ-SIZE מועלים אוטומטית כקבצים מרובי-חלקים עם ריבוי שרשורים. קבצים קטנים יותר מועלים באמצעות השיטה הרגילה. SIZE במגה-בייט. גודל ברירת המחדל של החלק הוא 15MB. גודל החלק המינימלי המותר הוא 5MB, והגודל המקסימלי הוא 5GB.

הורדת אובייקטים מקטגוריות אחסון

כדי לאחזר אובייקטים מהקטגוריה:

gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE

כדי להוריד את כל קובצי הטקסט מקטגוריה לספרייה הנוכחית:

gdcloud storage cp s3://BUCKET/*.txt .

כדי להוריד את קובץ הטקסט abc.txt מקטגוריה לספרייה הנוכחית:

gdcloud storage cp s3://BUCKET/abc.txt .

כדי להוריד גרסה ישנה יותר של הקובץ, צריך קודם לרשום את כל הגרסאות של הקובץ:

gdcloud storage ls s3://BUCKET/abc.txt --all-versions

פלט לדוגמה:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

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

gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .