זהו הפקודה s3backer שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
s3backer - חנות גיבוי לקובץ בודד מבוסס FUSE דרך Amazon S3
תַקצִיר
s3backer [אפשרויות] דלי /mount/point
s3backer --מִבְחָן [אפשרויות] dir /mount/point
s3backer --לִמְחוֹק [אפשרויות] דלי
s3backer --reset-mounted-flag [אפשרויות] דלי
תיאור
s3backer היא מערכת קבצים המכילה קובץ בודד המגובה על ידי Amazon Simple Storage
שירות (אמזון S3). כמערכת קבצים, זה מאוד פשוט: הוא מספק קובץ רגיל יחיד
בעל גודל קבוע. מתחת, הקובץ מחולק לבלוקים, והתוכן של
כל בלוק מאוחסן באובייקט ייחודי של Amazon S3. במילים אחרות, מה s3backer מספק
הוא באמת יותר כמו התקן דיסק קשיח וירטואלי מגובה S3, ולא מערכת קבצים.
בשימוש טיפוסי, מערכת קבצים 'רגילה' מותקנת על גבי הקובץ המיוצא על ידי ה-
s3backer מערכת קבצים באמצעות הרכבת loopback (או הרכבה של תמונת דיסק ב-Mac OS X).
להסדר הזה יש כמה יתרונות בהשוואה למערכת קבצים שלמה יותר S3
יישומים:
o על ידי אי ניסיון ליישם מערכת קבצים שלמה, שהיא משימה מורכבת ו
קשה להגיע נכון, s3backer יכול להישאר קל משקל ופשוט. רק שלושה HTTP
נעשה שימוש בפעולות: GET, PUT ו-DELETE. כל הניסיון והידע בנושא
כיצד ליישם נכון מערכות קבצים שכבר קיימות ניתן לעשות שימוש חוזר.
o על ידי שימוש במערכות קבצים קיימות, אתה מקבל סמנטיקה מלאה של מערכת הקבצים של UNIX. באגים עדינים
או פונקציונליות חסרה הקשורה לקישורים קשיחים, תכונות מורחבות, נעילת POSIX,
וכו' נמנעים.
o הפער בין סמנטיקה רגילה של מערכת קבצים לאמזון S3 ``עקביות בסופו של דבר'' הוא
ניתן לפתור בקלות ובפשטות יותר כאשר ניתן לפרש אובייקטי S3 כחוקים פשוטים של התקן
במקום אובייקטים של מערכת קבצים (ראה להלן).
o בעת אחסון הנתונים שלך בשרתי Amazon S3, שאינם בשליטתך, ה
היכולת להצפין ולאמת נתונים הופכת לבעיה קריטית. s3backer תומך
הצפנה ואימות מאובטחים. לחילופין, יכולת ההצפנה המובנית ב
ניתן להשתמש במכשיר הלולאה של לינוקס.
o מכיוון שהגישה לנתוני S3 מתבצעת דרך הרשת, אחסון במטמון מקומי חשוב מאוד גם עבור
סיבות ביצועים. מאז s3backer מציג את המקבילה של דיסק קשיח וירטואלי
את הליבה, ניתן לבצע את רוב שמירה במטמון של מערכת הקבצים היכן שהוא צריך להיות: ב-
kernel, דרך מטמון הדפים של הקרנל. למרות זאת s3backer כולל גם פנימי משלו
לחסום מטמון להגברת הביצועים, תוך שימוש בפתילים אסינכרוניים של עובדים
יתרון ההקבלה הגלומה ברשת.
עֲקֵבִיוּת ערבויות
Amazon S3 מספקת ערבויות חלשות יחסית לגבי התזמון והעקביות של הקריאה
לעומת כותב (הידוע ביחד בשם `` עקביות בסופו של דבר''). s3backer כולל היגיון ו
פרמטרי תצורה כדי לעקוף מגבלות אלו, המאפשרות למשתמש להבטיח
עקביות לכל רמה רצויה, עד וכולל 100% זיהוי והימנעות
מידע לא נכון. אלו הם:
1. s3backer אוכפת עיכוב מינימלי בין פעולות PUT או DELETE עוקבות ב-
אותו בלוק. זה מבטיח שאמזון S3 לא יקבל את הפעולות הללו שלא בתקינות.
2. s3backer שומר על מטמון בדיקת סכום MD5 בלוק פנימי, המאפשר אוטומטית
זיהוי ודחייה של בלוקים 'מעופשים' שהוחזרו על ידי פעולות GET.
היגיון זה מוגדר על ידי אפשרויות שורת הפקודה הבאות: --md5CacheSize,
--md5CacheTime, ו --minWriteDelay.
מְאוּפָּס לחסום אופטימיזציה
כאופטימיזציה פשוטה, s3backer אינו מאחסן בלוקים המכילים את כל האפסים; במקום זאת,
הם פשוט נמחקים. לעומת זאת, קריאות של בלוקים שאינם קיימים יכילו את כל האפסים.
במילים אחרות, הקובץ המגובה הוא תמיד דל ביותר.
כתוצאה מכך, אין צורך ליצור בלוקים לפני השימוש ולא מיוחדים
אתחול הכרחי בעת יצירת מערכת קבצים חדשה.
כאשר --listBlocks ניתן דגל, s3backer יפרט את כל הבלוקים הקיימים באתחול כך שזה
יודע מראש בדיוק אילו בלוקים ריקים.
שלח ו לחסום מידה זיהוי אוטומטי
לנוחות, בכל פעם שהגוש הראשון של הקובץ המגובה נכתב, s3backer כולל
כמטא-נתונים (בכותרת ``x-amz-meta-s3backer-filesize'') הגודל הכולל של הקובץ.
יחד עם גודל הבלוק עצמו, ניתן לבדוק ו/או לזהות אוטומטית ערך זה
מאוחר יותר כאשר מערכת הקבצים מותקנת מחדש, ומבטלת את הצורך ב- --blockSize or --גודל
יש לספק דגלים במפורש ולהימנע מפירוש מוטעה מקרי של קיים
מערכת קבצים.
לחסום סליק
s3backer כולל תמיכה במטמון בלוקים פנימי להגברת הביצועים. הבלוק
מטמון המטמון נפרד לחלוטין מהמטמון MD5 המאחסן רק סכומי בדיקה של MD5
באופן חולף ושמטרתו היחידה היא למתן את ``עקביות בסופו של דבר''. מטמון הבלוק
הוא מטמון מסורתי המכיל בלוקי נתונים מאוחסנים. כשהם מלאים, בלוקים נקיים מפונים
לפי הצורך לפי סדר LRU.
קריאות של בלוקים מאוחסנים יחזרו מיד ללא תעבורת רשת. כותב למטמון
גם לחזור מיד ולהפעיל פעולת כתיבה אסינכרונית לרשת באמצעות a
חוט עובדים נפרד. מכיוון שהקרנל בדרך כלל כותב בלוקים דרך מערכות קבצים FUSE
אחד בכל פעם, ביצוע כתיבה אסינכרוני מאפשר s3backer לנצל את ה-
מקביליות הטבועה ברשת, משפרת מאוד את ביצועי הכתיבה.
ניתן להגדיר את מטמון הבלוק לאחסן את הנתונים המאוחסנים בקובץ מקומי במקום ב
זיכרון. זה מאפשר גדלי מטמון גדולים יותר ומאפשר s3backer כדי לטעון מחדש נתונים מאוחסנים לאחר א
אתחול. נתונים שנטענו מחדש מאומתים באמצעות בדיקת MD5 עם Amazon S3 לפני שימוש חוזר.
מטמון הבלוק מוגדר על ידי אפשרויות שורת הפקודה הבאות: --blockCacheFile,
--blockCacheMaxDirty, --blockCacheNoVerify, --blockCacheSize, --blockCacheSync,
--blockCacheThreads, --blockCacheTimeout, ו --blockCacheWriteDelay.
חומר עיוני קדימה
s3backer מיישמת אלגוריתם פשוט לקריאה קדימה במטמון הבלוק. כאשר ניתן להגדרה
מספר הבלוקים נקראים לפי הסדר, שרשורי עובד מטמון בלוק מתעוררים כדי להתחיל בקריאה
בלוקים הבאים לתוך מטמון הבלוק. הקריאה קדימה ממשיכה כל עוד הקרנל
ממשיך לקרוא בלוקים ברצף. הליבה בדרך כלל מבקשת בלוקים אחד בכל פעם,
כך שמספר שרשורי עובדים כבר קוראים את הבלוקים הבאים משפר את הקריאה
ביצועים על ידי ניצול ההקבלה הגלומה ברשת.
שימו לב שהקרנל מיישם גם אלגוריתם קריאה קדימה; יש לקחת את ההתנהגות שלו
בחשבון. כברירת מחדל, s3backer מעביר את -o max_readahead=0 אפשרות ל-FUSE.
קריאה קדימה מוגדרת על ידי --קרא קדימה ו --readAheadTrigger אפשרויות שורת הפקודה.
הצף ו אימות
s3backer תומך בהצפנה באמצעות --הצפין, --סיסמה, ו --passwordFile דגלים. מתי
ההצפנה מופעלת, אימות SHA1 HMAC מופעל גם באופן אוטומטי, ו s3backer
דוחה כל בלוקים שאינם מוצפנים וחתומים כהלכה.
הצפנה ב- s3backer שכבה עדיפה על הצפנה בשכבה עליונה (למשל, ב-
שכבת מכשיר loopback), כי אם הנתונים s3backer sees כבר מוצפן הוא לא יכול
בצע אופטימיזציה של בלוקים מאופסים או בצע דחיסה משמעותית.
דְחִיסָה
s3backer תומך בדחיסה ברמת הבלוק, מה שממזער את זמן ההעברה ועלויות האחסון.
הדחיסה מוגדרת באמצעות --לִדחוֹס דֶגֶל. הדחיסה מופעלת באופן אוטומטי
כאשר ההצפנה מופעלת.
לקריאה בלבד גִישָׁה
לא נדרש חשבון Amazon S3 על מנת להשתמש בו s3backer. מערכת הקבצים חייבת כבר
קיימים ויש להם אובייקטי S3 עם ACL's מוגדרים עבור גישת קריאה ציבורית (ראה --סוג גישה
לְהַלָן); על המשתמשים לבצע את הטעינת החזרה עם הדגל לקריאה בלבד (ראה הר(8)) ו
לספק את --לקריאה בלבד דגל ל s3backer. אופן פעולה זה מקל על יצירת
מערכות קבצים ציבוריות לקריאה בלבד.
סימולטני הרכבות
למרות שהוא פועל ברשת, ה s3backer מערכת הקבצים אינה מבוזרת
מערכת קבצים ואינה תומכת ברכיבי קריאה/כתיבה בו זמנית. (זה לא משהו שאתה
בדרך כלל יתאים גם למחיצת דיסק קשיח.) כאמצעי בטיחות, s3backer
מנסה לזהות מצב זה באמצעות דגל 'כבר מותקן' במאגר הנתונים, וכן
לא יצליח להתחיל אם כן.
זיהוי זה עשוי לייצר חיובי שגוי אם קודם s3backer התהליך לא הושבת
לְמִשׁעִי; אם כן, ה --reset-mounted-flag ניתן להשתמש בדגל כדי לאפס את 'כבר רכוב'
דֶגֶל. אבל ראה גם באגים למטה.
סטָטִיסטִיקָה שלח
s3backer מאכלס את מערכת הקבצים בקובץ סטטיסטיקה קריא אנושי. לִרְאוֹת
--stats שם קובץ לְהַלָן.
רישום
בפעולה רגילה s3backer יכנס דרך syslog(3). כאשר רצים עם ה -d or -f דגלים,
s3backer ייכנס לשגיאה רגילה.
אפשרויות
לכל דגל שורת פקודה יש שתי צורות, למשל --accessFile=קובץ ו -o accessFile=FILE.
רק הטופס הראשון מוצג להלן. יש להשתמש בכל אחת מהן; שניהם שוות ערך. ה
טופס שני מאפשר לציין אפשרויות הרכבה ישירות ב / etc / fstab וחלף
בצורה חלקה ל s3backer מאת FUSE.
--accessFile=קובץ
ציין קובץ המכיל צמדי 'accessID:accessKey', אחד לכל שורה. קווים ריקים ו
מתעלמים מהשורות המתחילות ב-'#'. אם לא --מפתח גישה צוין, הקובץ הזה
יחפשו את הערך התואם למזהה הגישה שצוין באמצעות --accessId; if
לא זה ולא זה --מפתח גישה ולא --accessId מוגדר, הערך הראשון בקובץ זה יעשה זאת
לשמש. ערך ברירת המחדל הוא $HOME/.s3backer_passwd.
--accessId=ID
ציין את מזהה הגישה של Amazon S3. ציין מחרוזת ריקה כדי לאלץ אי גישה לזהות. אם לא
לאחר מכן צוין מזהה גישה (ואף אחד לא נמצא בקובץ הגישה). s3backer יצטרך
עדיין פועל, אבל רק קריאות של מערכות קבצים זמינות לציבור יפעלו.
--accessKey=KEY
ציין מפתח גישה של Amazon S3. כדי להימנע מפרסום סוד זה באמצעות שורת הפקודה,
להשתמש --accessFile במקום הדגל הזה.
--accessType=TYPE
ציין את סוג הרשאת הגישה של Amazon S3 ACL עבור בלוקים שנכתבו לאחרונה. הערך
חייב להיות אחד מ'private', 'public-read', 'public-read-write', או 'authenticated-
לקרוא'. ברירת המחדל היא 'פרטי'.
--accessEC2IAM=ROLE
הורד אישורי גישה ואסימון אבטחה בטופס מסמך JSON מ
http://169.254.169.254/latest/meta-data/iam/security-credentials/ROLE כל חמש
דקות.
אפשרות זו מאפשרת לספק אישורי S3 באופן אוטומטי באמצעות IAM שצוין
תפקיד ל s3backer כאשר פועל על מופע של אמזון EC2.
--authVersion=TYPE
ציין כיצד לאמת בקשות. יש שני אימות נתמכים
שיטות: aws2 היא ערכת האימות המקורית של AWS. aws4 הוא החדש יותר,
ערכת אימות מומלצת.
aws4 היא הגדרת ברירת המחדל החל מגרסה 1.4, והיא נדרשת בוודאות
אזורים שאינם ארה"ב, בעוד aws2 ייתכן שעדיין יידרש על ידי חלק מהספקים שאינם של Amazon S3.
--baseURL=URL
ציין את כתובת האתר הבסיסית, שחייבת להסתיים בקו נטוי קדימה. ברירת המחדל היא
`http://s3.amazonaws.com/'.
--blockCacheFile=קובץ
ציין קובץ שבו יש לאחסן בלוקי נתונים מאוחסנים. בלי הדגל הזה, הבלוק
המטמון חי כולו בזיכרון התהליך והנתונים המאוחסנים במטמון נעלמים כאשר s3backer
מופסק. הקובץ ייווצר אם הוא לא קיים.
קבצי מטמון שנוצרו על ידי הפעלות קודמות של s3backer ניתנים לשימוש חוזר
כל עוד הם נוצרו עם אותו גודל בלוק מוגדר (אם לא, אתחול
ייכשל). זה נכון גם אם s3backer הופסק בפתאומיות, למשל, עקב א
קריסת מערכת; עם זאת, ערבות זו נשענת על ההנחה שמערכת הקבצים
המכיל את קובץ המטמון לא יסדר מחדש את הכתיבה בקריאות אל fsync(2).
אם נעשה שימוש במטמון קיים אך נוצר בגודל שונה, s3backer יצטרך
הרחב או כווץ את הקובץ באופן אוטומטי בעת ההפעלה. כאשר מתכווצים, חוסם את זה
אינם מתאימים למטמון החדש, מטמון קטן יותר נמחק. תהליך זה גם דוחס את
קובץ המטמון במידת האפשר.
בכל מקרה, רק בלוקי מטמון נקיים ניתנים לשחזור לאחר הפעלה מחדש. זה אומר א
קריסת מערכת תגרום לאיבוד בלוקים מלוכלכים במטמון (כמובן, זה
מקרה עם מטמון בזיכרון). להשתמש --blockCacheWriteDelay להגביל זאת
חלון.
כברירת מחדל, לאחר טעינת המטמון מחדש מקובץ מטמון, s3backer יאמת
בדיקת MD5 של כל בלוק שנטען מחדש עם Amazon S3 לפני השימוש הראשון בו. זֶה
פעולת אימות אינה דורשת קריאת הנתונים של הבלוק, ולכן
מהיר יחסית. זה שומר מפני שהנתונים המאוחסנים במטמון שהתקבלו שלא ביודעין
לא מסונכרן מאז השימוש האחרון בקובץ המטמון, מצב שונה
בלתי אפשרי עבור s3backer לזהות.
--blockCacheMaxDirty=NUM
ציין הגבלה על מספר הבלוקים המלוכלכים במטמון הבלוקים. כאשר הגבול הזה
הושגה, ניסיונות כתיבה עוקבים ייחסמו עד לחסום מלוכלך קיים
נכתב בהצלחה (ולכן אינו הופך יותר מלוכלך). דגל זה מגביל את
כמות חוסר העקביות יכולה להיות ביחס למאגר הנתונים הבסיסי של S3.
ערך ברירת המחדל הוא אפס, כלומר אין הגבלה.
--blockCacheNoVerify
השבת את אימות ה-MD5 של בלוקים שנטענו מקובץ מטמון שצוין באמצעות
--blockCacheFile. השימוש בדגל זה מסוכן; השתמש רק כאשר אתה בטוח
הקובץ השמור אינו פגום והנתונים שהוא מכיל עדכניים.
--blockCacheSize=SIZE
ציין את גודל מטמון הבלוק (במספר בלוקים). כל ערך במטמון יהיה
לצרוך גודל בלוק בקירוב פלוס 20 בתים. ערך אפס משבית את הבלוק
מטמון. ערך ברירת המחדל הוא 1000.
--blockCacheThreads=NUM
הגדר את גודל מאגר השרשורים המשויך למטמון הבלוק (אם מופעל). זֶה
מגביל את מספר הכתיבה בו-זמנית שיכולה להתרחש לרשת. בְּרִירַת מֶחדָל
הערך הוא 20.
--blockCacheTimeout=MILLIS
ציין את הזמן המקסימלי שרשומה נקייה יכולה להישאר במטמון החסימה לפני שהיא תישאר
יפונה בכוח והזיכרון הקשור בו ישוחרר. ערך של אפס אומר שיש
ללא פסק זמן; במקרה זה, מספר הערכים במטמון הבלוק לעולם לא יהיה
להקטין, ולבסוף להגיע לגודל המקסימלי שהוגדר על ידי --blockCacheSize ו
להישאר שם. הגדר ערך שאינו אפס אם השימוש בזיכרון של מטמון הבלוק הוא
דאגה. ערך ברירת המחדל הוא אפס (ללא פסק זמן).
--blockCacheWriteDelay=MILLIS
ציין את הזמן המקסימלי שבלוק מלוכלך יכול להישאר במטמון הבלוק לפני שהוא חייב
להיכתב לרשת. בלוקים עשויים להיכתב מוקדם יותר כאשר יש מטמון
לַחַץ. ערך אפס מגדיר מדיניות "כתיבה דרך"; ערכים גדולים יותר
להגדיר מדיניות ``כתיבה חזרה''. ערכים גדולים יותר מגבירים את הביצועים כאשר הם קטנים
מספר בלוקים ניגשים שוב ושוב, במחיר של חוסר עקביות גדול יותר עם
מאגר הנתונים הבסיסי של S3. ערך ברירת המחדל הוא 250 מילישניות.
--blockCacheSync
מאלץ כתיבה סינכרונית בשכבת המטמון של הבלוק. במקום לחזור
מיד ותזמון פעולת הכתיבה בפועל יקרה מאוחר יותר, כתוב
בקשות לא יחזרו עד לסיום הכתיבה. הדגל הזה מחמיר
דרישה מאשר --blockCacheWriteDelay=0, שרק גורם לכותבים להיות
יזום בהקדם האפשרי (אך עדיין לאחר שבקשת הכתיבה חוזרת).
הדגל הזה דורש --blockCacheWriteDelay להיות אפס. סביר להניח ששימוש בדגל זה
להפחית באופן דרסטי את ביצועי הכתיבה.
--blockSize=SIZE
ציין את גודל הבלוק. זה חייב להיות חזק של שתיים וצריך להיות כפולה של
גודל העמוד המקורי של הקרנל. לגודל עשויה להיות סיומת אופציונלית 'K' עבור קילובייט,
'M' עבור מגה בייט וכו'.
s3backer תומך בפעולות בלוק חלקי, אם כי זה מאלץ קריאה לפני כל אחת
לִכתוֹב; שימוש במטמון הבלוק ויישור נכון של s3backer גודל בלוק עם
השימוש המיועד (למשל, גודל הבלוק של מערכת הקבצים ה'עליון') יעזור למזער
הקריאה הנוספת. שימו לב שגם כאשר מערכות קבצים מוגדרות לבלוק גדול
בגדלים, הגרעין יכתוב לרוב בלוקים בגודל עמוד.
s3backer ינסה לזהות אוטומטית את גודל הבלוק על ידי קריאת הבלוק מספר אפס ב
סטארט - אפ. אם אפשרות זו לא צוינה, הערך שזוהה אוטומטית ישמש. אם
אפשרות זו צוינה אך אינה מסכימה עם הערך שזוהה אוטומטית, s3backer יצטרך
צא עם שגיאה אלא אם כן --כּוֹחַ ניתן גם. אם הזיהוי האוטומטי נכשל בגלל
בלוק מספר אפס לא קיים, ואפשרות זו לא צוינה, אז ברירת המחדל
נעשה שימוש בערך של 4K (4096).
--cacert=קובץ
ציין קובץ אישור SSL לשימוש בעת אימות זהות השרת המרוחק
כאשר פועלים באמצעות חיבורי SSL. שווה ערך ל --cacert דגל מתועד ב
תלתל(1).
--compress[=LEVEL]
דחוס בלוקים לפני שליחתם דרך הרשת. זה אמור להביא פחות
תעבורת רשת (בשני הכיוונים) ועלויות אחסון נמוכות יותר.
רמת הדחיסה היא אופציונלית; אם ניתן, זה חייב להיות בין 1 (דחיסה מהירה)
ו-9 (רוב הדחיסה), כולל. אם מושמט, רמת הדחיסה המוגדרת כברירת מחדל היא
מְשׁוּמָשׁ.
דגל זה מאפשר רק דחיסה של בלוקים שנכתבו לאחרונה; דקומפרסיה היא תמיד
מופעל ומוחל כאשר מתאים. לכן, בטוח להפעיל את הדגל הזה
או כבוי בין קריאות שונות של s3backer על אותה מערכת קבצים.
דגל זה מופעל אוטומטית כאשר --הצפין משמש, אם כי אתה יכול גם
לפרט --compress=LEVEL כדי להגדיר רמת דחיסה שאינה ברירת מחדל.
בעת שימוש במערכת קבצים מוצפנת בשכבה עליונה, דגל זה אינו מוסיף ערך מכיוון ש-
הנתונים לא יהיו ניתנים לדחיסה.
--directIO
השבת את שמירה במטמון ליבה של הקובץ המגובה. זה יאלץ את הליבה לתמיד
להעביר קריאות וכותבות ישירות ל s3backer. זה מפחית את הביצועים אבל גם
מבטל מקור אחד של חוסר עקביות.
--לנפות
אפשר רישום של הודעות ניפוי באגים. שימו לב שהדגל הזה שונה מ -d, אשר
הוא דגל ל-FUSE; אולם, ה -d דגל FUSE מרמז על דגל זה.
--debug-http
אפשר הדפסה של כותרות HTTP לפלט סטנדרטי.
--הצפין[=CIPHER]
אפשר הצפנה ואימות של נתוני בלוק. עיין בתיעוד ה-OpenSSL שלך
עבור רשימה של צפנים נתמכים; ברירת המחדל אם לא צוין צופן היא AES-128
CBC.
סיסמת ההצפנה עשויה להיות מסופקת דרך אחת מהן --סיסמה or --passwordFile. אם
אף דגל לא ניתן, s3backer יבקש את הסיסמה בעת ההפעלה.
הערה: המפתח בפועל בשימוש נגזר על ידי hashing הסיסמה, שם הדלי, ה-
שם הקידומת (אם יש), ומספר הבלוק. לכן, נתונים מוצפנים לא יכולים להיות
מועבר לדליים או קידומות שונות.
דגל זה מרמז --לִדחוֹס.
--לִמְחוֹק
מחק לחלוטין את מערכת הקבצים על ידי מחיקת כל הבלוקים שאינם אפס, נקה את ה'כבר
דגל רכוב, ולאחר מכן צא. נדרש אישור משתמש אלא אם כן --כּוֹחַ דגל
ניתן גם. שימו לב, במקרה זה לא מתבצע זיהוי הרכבה בו-זמנית.
מרמז על אפשרות זו --listBlocks.
--שם קובץ=שם
ציין את שם הקובץ המגובה המופיע ב- s3backer מערכת קבצים.
ברירת המחדל היא 'קובץ'.
--fileMode=MODE
ציין את סיביות ההרשאה של UNIX עבור הקובץ המגובה המופיע ב- s3backer
מערכת קבצים. ברירת המחדל היא 0600, אלא אם כן --לקריאה בלבד מצוין, ובמקרה זה ה
ברירת המחדל היא 0400.
--כּוֹחַ
המשך גם אם הערך שצוין על ידי --blockSize or --גודל לא מסכים עם
ערך שזוהה אוטומטית, או s3backer מזהה כי אחר s3backer דוגמה עדיין
מותקן על גבי אותו דלי S3 (והקידומת). בכל אחד מהמקרים הללו,
ההליך יוביל לנתונים פגומים, ולכן --כּוֹחַ יש להימנע מדגל עבור
שימוש רגיל.
זיהוי הרכבה בו-זמני יכול לייצר חיובי שגוי כאשר קוד
s3backer המופע לא נסגר בצורה נקייה. במקרה זה, אל תשתמש --כּוֹחַ אבל
אלא לרוץ s3backer פעם אחת עם --reset-mounted-flag דגל.
If --לִמְחוֹק נתון, --כּוֹחַ גורמים s3backer להמשיך ללא אישור משתמש.
-h - עזרה
הדפס הודעת עזרה וצא.
--initialRetryPause=MILLIS
ציין את זמן ההשהיה הראשוני באלפיות שניות לפני ניסיון הניסיון הראשון לאחר מכן
פעולות HTTP שנכשלו. כשלים כוללים תקלות רשת ופסקי זמן, HTTP
שגיאות וקריאות של נתונים מיושנים (כלומר, אי התאמה של MD5); s3backer יעשה מרובה
נסה שוב ניסיונות באמצעות אלגוריתם גיבוי אקספוננציאלי, החל באותיתית זו
נסה שוב את זמן ההשהיה. ערך ברירת המחדל הוא 200ms. ראה גם --maxRetryPause.
--לֹא בָּטוּחַ
אל תאמת את זהות השרת המרוחק בעת פעולה באמצעות חיבורי SSL.
שווה ערך ל --לֹא בָּטוּחַ דגל מתועד ב תלתל(1).
--keyLength
החלף את אורך מפתח ההצפנה של הבלוק שנוצר.
גרסאות של s3backer לפני 1.3.6 הכיל באג שבו אורך ה-
מפתח ההצפנה שנוצר היה קבוע אך תלוי במערכת, מה שגרם לו להיות אולי
לא תואם במערכות שונות עבור כמה צופנים. בגרסה 1.3.6, הבאג הזה היה
מְתוּקָן; עם זאת, במקרים מסוימים זה שינה את אורך המפתח שנוצר, והפך את
ההצפנה אינה תואמת עוד לנתונים שנכתבו בעבר. ניתן להשתמש בדגל זה
לאלץ את אורך המפתח הישן והקבוע. הערך שאתה רוצה להשתמש בו הוא מה שהוא
מוגדר עבור EVP_MAX_KEY_LENGTH במערכת שלך, בדרך כלל 64.
זו שגיאה לציין ערך הקטן מאורך המפתח הטבעי של הצופן;
עם זאת, ערך של אפס מותר והוא שווה ערך לאי ציון דבר.
--listBlocks
בצע שאילתה בעת ההפעלה כדי לקבוע אילו בלוקים כבר קיימים. זה מאפשר
אופטימיזציות לפיהן, עבור כל בלוק שעדיין לא קיים, קורא אפסים חוזרים
וכתיבה מאופסת מושמטת, ובכך מבטלת כל גישה לרשת. הדגל הזה הוא
שימושי בעת יצירת קובץ מגובה חדש, או בכל עת שצפוי להיות גדול
מספר בלוקים מאופסים ייקרא או ייכתב, כגון בעת אתחול חדש
מערכת קבצים.
הדגל הזה יאט את ההפעלה ביחס ישר למספר החסימות
כבר קיים.
--maxUploadSpeed=BITSPERSEC
--maxDownloadSpeed=BITSPERSEC
דגלים אלו מגדירים מגבלה על רוחב הפס המשמש להעלאות בלוק בודד ו
הורדות (כלומר, ההגדרה חלה על בסיס לכל שרשור). המגבלות חלות בלבד
לנתוני מטען HTTP ואינם כוללים תקורה נוספת מ-HTTP או TCP
כותרות וכו'.
הערך נמדד בסיביות לשנייה, וקיצורים כמו `256k', `1m' וכו'.
עשוי להיות בשימוש. כברירת מחדל, אין מגבלה קבועה.
שימוש בדגלים אלה עשוי לדרוש גם הגדרת --פסק זמן דגל לערך גבוה יותר.
--maxRetryPause=MILLIS
ציין את משך הזמן הכולל באלפיות שניות s3backer צריך להשהות בעת ניסיון חוזר
פעולות HTTP נכשלו לפני הוויתור. כשלים כוללים כשלים ברשת ו
פסקי זמן, שגיאות HTTP וקריאות של נתונים מיושנים (כלומר, אי התאמה של MD5); s3backer יצטרך
בצע נסיונות חוזרים מרובים באמצעות אלגוריתם גיבוי אקספוננציאלי, עד זה
זמן הפסקה כולל של ניסיון חוזר. ערך זה אינו כולל את הזמן שנדרש עד
לבצע את פעולות ה-HTTP בעצמן (השתמש --פסק זמן בשביל זה). ערך ברירת המחדל הוא
30000 (30 שניות). ראה גם --initialRetryPause.
--minWriteDelay=MILLIS
ציין פרק זמן מינימלי באלפיות שניות בין השלמת כתיבה מוצלחת
והתחלת כתיבה נוספת לאותו בלוק. עיכוב זה מבטיח ש-S3
לא מקבל את הכתובות שלא בתקינות. ערך זה חייב להיות מוגדר לאפס כאשר
--md5CacheSize מוגדר לאפס (מטמון MD5 מושבת). ערך ברירת המחדל הוא 500ms.
--md5CacheSize=SIZE
ציין את גודל מטמון ה-checksum MD5 (במספר בלוקים). אם המטמון הוא
מלא כאשר נכתב בלוק חדש, הכתיבה תיחסם עד שיהיה מקום.
לכן, חשוב להגדיר --md5CacheTime ו --md5CacheSize פי
לתדירות הכתיבה למערכת הקבצים הכוללת ולאותו בלוק
שוב ושוב. לחילופין, ערך השווה למספר הבלוקים במערכת הקבצים
מבטל בעיה זו אך גוזל את מירב הזיכרון כאשר הוא מלא (כל ערך ב-
המטמון הוא בערך 40 בתים). ערך אפס משבית את המטמון MD5. בְּרִירַת מֶחדָל
הערך הוא 1000.
--md5CacheTime=MILLIS
ציין באלפיות שניות את הזמן שאחרי הבלוק נכתב בהצלחה
אשר יש לאחסן במטמון את בדיקת MD5 של תוכן הבלוק, לצורך העניין
זיהוי נתונים מעופשים במהלך הקריאות הבאות. ערך של אפס פירושו 'אינסופי' ו
מספק ערבות מפני קריאת נתונים מיושנים; עם זאת, עליך לעשות זאת רק
מתי --md5CacheSize מוגדר להיות שווה למספר הבלוקים; אחרת
מבוי סתום יתרחש (בסופו של דבר). ערך זה חייב להיות גדול לפחות כמו
--minWriteDelay. ערך זה חייב להיות מוגדר לאפס כאשר --md5CacheSize מוגדר לאפס
(מטמון MD5 מושבת). ערך ברירת המחדל הוא 10 שניות.
מטמון הבדיקה של MD5 אינו נמשך במהלך אתחול מחדש. לכן, כדי להבטיח את
אותה הגנת עקביות בסופו של דבר בעוד s3backer אינו פועל, עליך לעכב
לפחות --md5CacheTime אלפיות שניות בין עצירה להפעלה מחדש s3backer.
--אין זיהוי אוטומטי
השבת את הזיהוי האוטומטי של בלוק וגודל קובץ בעת ההפעלה. אם הדגל הזה ניתן, אז
ברירת המחדל של גודל הבלוק הוא 4096 וה- --גודל נדרש דגל.
--סיסמה=PASSWORD
ספק את הסיסמה להצפנה ואימות כפרמטר שורת פקודה.
--passwordFile=קובץ
קרא את הסיסמה להצפנה ואימות מהשורה הראשונה של
קובץ שצוין.
--prefix=STRING
ציין קידומת לשמות המשאבים בתוך הדלי שמזהים כל אחד מהם
לַחסוֹם. על ידי שימוש בקידומות שונות, עצמאיות מרובות s3backer דיסקים יכולים לחיות בהם
אותו דלי S3.
קידומת ברירת המחדל היא המחרוזת הריקה.
--שֶׁקֶט
דיכוי פלט התקדמות במהלך האתחול הראשוני.
--readAhead=NUM
הגדר את מספר בלוקים של קריאה קדימה. זה קובע כמה בלוקים יהיו
להיקרא לתוך מטמון הבלוק לפני הבלוק האחרון שנקרא על ידי הקרנל בעת הקריאה
קדימה פעיל. לאפשרות זו אין השפעה אם מטמון החסימה מושבת. בְּרִירַת מֶחדָל
הערך הוא 4.
--readAheadTrigger=NUM
הגדר את מספר הבלוקים שיש לקרוא ברציפות לפני הקריאה קדימה
האלגוריתם מופעל. לאחר ההפעלה, הקריאה קדימה תימשך כל עוד
הקרנל ממשיך לקרוא בלוקים ברצף. לאפשרות זו אין השפעה אם
מטמון החסימה מושבת. ערך ברירת המחדל הוא 2.
--לקריאה בלבד
נניח שמערכת הקבצים תותקן לקריאה בלבד, ותחזיר EROFS בתגובה
לכל ניסיון לכתוב. דגל זה משנה גם את מצב ברירת המחדל של הקובץ המגובה
מ-0600 עד 0400 ומשבית את מטמון הבדיקה של MD5.
--region=REGION
ציין אזור AWS. דגל זה משנה את ברירת המחדל של כתובת האתר הבסיסית כך שתכלול את האזור
שם ומגדיר אוטומטית את --vhost דגל.
--reset-mounted-flag
אפס את הדגל 'כבר מותקן' במאגר הנתונים הבסיסי של S3.
s3backer מזהה עליות בו-זמנית על ידי בדיקת דגל מיוחד. אם קודם
הקריאה של s3backer לא נסגר בצורה נקייה, ייתכן שהדגל לא היה
מְבוּעָר. רץ s3backer --לִמְחוֹק ינקה את זה ידנית. אבל ראה גם באגים למטה.
--rrs בעת כתיבת בלוקים, ציין אחסון יתירות מופחתת.
--size=SIZE
ציין את הגודל (בבתים) של הקובץ המגובה שייצא על ידי מערכת הקבצים.
לגודל עשויה להיות סיומת אופציונלית 'K' עבור קילובייט, 'M' עבור מגה-בייט, 'G' עבור
גיגה-בייט, 'T' עבור טרה-בייט, 'E' עבור אקס-בייט, 'Z' עבור זטה-בייט, או 'Y' עבור
yottabytes. s3backer ינסה לזהות אוטומטית את גודל הבלוק על ידי קריאת בלוק
מספר אפס. אם אפשרות זו לא צוינה, הערך שזוהה אוטומטית ישמש.
אם אפשרות זו צוינה אך אינה מסכימה עם הערך שזוהה אוטומטית, s3backer
ייצא עם שגיאה אלא אם כן --כּוֹחַ ניתן גם.
--ssl שווה ערך ל --baseURL https://s3.amazonaws.com/
--statsFilename=NAME
ציין את השם של קובץ הסטטיסטיקה הניתן לקריאה על ידי אדם המופיע ב- s3backer
מערכת קבצים. ערך של מחרוזת ריקה משבית את המראה של קובץ זה. בְּרִירַת מֶחדָל
זה 'סטטיסטיקה'.
--מִבְחָן פעל במצב בדיקה מקומי. בלוקים של מערכת הקבצים מאוחסנים כקבצים רגילים ב-
בספרייה dir. לא מתרחשת תעבורת רשת.
שימו לב אם dir הוא שם נתיב יחסי (ו -f לא ניתן) זה ייפתר
יחסית לספריית השורש.
--timeout=SECONDS
ציין מגבלת זמן בשניות עבור ניסיון פעולת HTTP אחד. זה מגביל את
כל הפעולה כולל זמן חיבור (אם עדיין לא מחובר) ונתונים
זמן העברה. ברירת המחדל היא 30 שניות; ייתכן שיהיה צורך להתאים ערך זה
כלפי מעלה כדי למנוע פסקי זמן מוקדמים בקישורים איטיים יותר ו/או בעת שימוש במספר גדול
של שרשורי עובדי מטמון בלוק.
ראה גם --maxRetryPause.
--גִרְסָה
גרסת פלט ויציאה.
--vhost
כפה בקשות בסגנון מתארח וירטואלי. לדוגמה, זה יגרום s3backer כדי להשתמש
כתובת האתר http://mybucket.s3.amazonaws.com/path/uri במקום
http://s3.amazonaws.com/mybucket/path/uri.
דגל זה נדרש כאשר דלי S3 נוצרו עם אילוצי מיקום
(לדוגמה `דליים של האיחוד האירופי'). במילים אחרות, הדגל הזה נדרש לדליים
מוגדר מחוץ לאזור ארה"ב. דגל זה מוגדר אוטומטית כאשר --אזור
נעשה שימוש בדגל.
בנוסף, s3backer מקבל גם את כל אפשרויות ה-FUSE הגנריות. הנה חלק
רשימה:
-o uid=UID
תעקוף את מזהה המשתמש של הקובץ המגובה, שברירת המחדל הוא מזהה המשתמש הנוכחי.
-o gid=GID
תעקוף את מזהה הקבוצה של הקובץ המגובה, אשר ברירת המחדל הוא מזהה הקבוצה הנוכחי.
-o sync_read
בצע קריאה סינכרונית.
-o max_readahead=NUM
הגדר קריאה מקסימלית קדימה (בבתים).
-f לרוץ בחזית (לא להתפצל). גורם לרישום רישום להישלח לשגיאה סטנדרטית.
-d הפעל את מצב ניפוי באגים FUSE. מרמז -f.
-s הפעל במצב חוט יחיד.
בנוסף, s3backer מעביר את הדגלים הבאים אשר מותאמים עבורם s3backer להתיך
(אלא אם כן נדחק על ידי המשתמש בשורת הפקודה):
-o kernel_cache
-o fsname= /
-o subtype=s3backer
-o use_ino
-o entry_timeout=31536000
-o negative_timeout=31536000
-o max_readahead=0
-o attr_timeout=0
-o default_permissions
-o לאפשר_אחר
-o נודב
-o נוזיד
השתמש ב-s3backer באינטרנט באמצעות שירותי onworks.net