#אחסון קבצים: S3 (Pro)

#מבוא

בהתבסס על תוסף ניהול הקבצים, גרסה זו מוסיפה תמיכה בסוגי אחסון קבצים התואמים לפרוטוקול S3. כל שירות אחסון אובייקטים התומך בפרוטוקול S3 יכול להשתלב בקלות, כמו Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 ועוד, מה שמשפר עוד יותר את התאימות והגמישות של שירותי האחסון.

#תכונות עיקריות

1. העלאה מצד הלקוח: קבצים מועלים ישירות לשירות האחסון, ללא צורך לעבור דרך שרת NocoBase. זה מאפשר חווית העלאה יעילה ומהירה יותר.

2. גישה פרטית: כל כתובות ה-URL של הקבצים הן כתובות מורשות זמניות חתומות, מה שמבטיח גישה מאובטחת ומוגבלת בזמן לקבצים.

#תרחישי שימוש

1. ניהול טבלאות קבצים: ניהול ואחסון מרכזי של כל הקבצים שהועלו, עם תמיכה בסוגי קבצים ושיטות אחסון מגוונות, לנוחות סיווג ואחזור קבצים.

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

#הגדרות תוסף

1. הפעילו את התוסף plugin-file-storage-s3-pro.

2. עברו אל "Setting -> FileManager" כדי לגשת להגדרות ניהול הקבצים.

3. לחצו על כפתור "Add new" ובחרו "S3 Pro".

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

#הגדרות ספק שירות

#Amazon S3

#יצירת Bucket

1. היכנסו ל-Amazon S3 Console.

2. לחצו על כפתור "Create bucket" בצד ימין.

3. מלאו את Bucket Name (שם ה-Bucket), השאירו שדות אחרים כברירת מחדל, גללו לתחתית העמוד ולחצו על כפתור "Create" כדי להשלים את היצירה.

#הגדרות CORS

1. ברשימת ה-Buckets, מצאו ולחצו על ה-Bucket שיצרתם זה עתה כדי לגשת לדף הפרטים שלו.

2. עברו ללשונית "Permission" וגללו למטה עד שתמצאו את קטע הגדרות CORS.

3. הזינו את ההגדרות הבאות (ניתן להתאים אישית לפי הצורך) ושמרו.

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

#אחזור AccessKey ו-SecretAccessKey

1. לחצו על כפתור "Security credentials" בפינה הימנית העליונה של העמוד.

2. גללו למטה, מצאו את קטע "Access Keys" ולחצו על כפתור "Create Access Key".

3. הסכימו לתנאים (מומלץ להשתמש ב-IAM בסביבות ייצור).

4. שמרו את ה-Access Key וה-Secret Access Key המוצגים בעמוד.

#אחזור והגדרת פרמטרים

1. השתמשו ב-AccessKey ID וב-AccessKey Secret שאוחזרו בפעולה הקודמת. אנא מלאו אותם במדויק.

2. עברו ללשונית Properties בדף פרטי ה-Bucket. שם תוכלו למצוא את שם ה-Bucket ואת פרטי ה-Region (אזור).

#גישה ציבורית (אופציונלי)

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

1. בלוח Permissions, גללו אל "Object Ownership", לחצו על "Edit" והפעילו ACLs.

2. גללו אל "Block public access", לחצו על "Edit" והגדירו לאפשר שליטת ACL.

3. סמנו "Public access" ב-NocoBase.

#הגדרות תמונות ממוזערות (אופציונלי)

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

1. בקרו ב-Dynamic Image Transformation for Amazon CloudFront.

2. לחצו על כפתור Launch in the AWS Console בתחתית העמוד כדי להתחיל את הפריסה.

3. עקבו אחר ההנחיות כדי להשלים את ההגדרות. יש לשים לב במיוחד לאפשרויות הבאות:
   1. בעת יצירת ה-Stack, עליכם לציין את שם ה-Bucket של Amazon S3 המכיל את תמונות המקור. אנא הזינו את שם ה-Bucket שיצרתם קודם לכן.
   2. אם בחרתם לפרוס את ממשק המשתמש לדוגמה (Demo UI), לאחר הפריסה תוכלו להשתמש בו כדי לבדוק את פונקציונליות עיבוד התמונה. במסוף AWS CloudFormation, בחרו את ה-Stack שלכם, עברו ללשונית "Outputs", מצאו את הערך המתאים למפתח DemoUrl ולחצו על הקישור כדי לפתוח את ממשק הדוגמה.
   3. פתרון זה משתמש בספריית sharp של Node.js לעיבוד תמונה יעיל. ניתן להוריד את קוד המקור ממאגר GitHub ולהתאים אותו אישית לפי הצורך.

4. לאחר השלמת ההגדרות, המתינו שמצב הפריסה ישתנה ל-CREATE_COMPLETE.

5. בהגדרות NocoBase, שימו לב לנקודות הבאות:

   1. Thumbnail rule: מלאו את הפרמטרים הקשורים לעיבוד תמונה, לדוגמה ?width=100. לפרטים נוספים, עיינו ב-תיעוד AWS.
   2. Access endpoint: הזינו את הערך מ-Outputs -> ApiEndpoint לאחר הפריסה.
   3. Full access URL style: יש לסמן Ignore (מכיוון ששם ה-Bucket כבר הוזן בהגדרות, הוא אינו נדרש לגישה).

#דוגמת הגדרה

#Alibaba Cloud OSS

#יצירת Bucket

1. פתחו את OSS Console.

2. בחרו "Buckets" מהתפריט השמאלי ולחצו על כפתור "Create Bucket" כדי להתחיל ביצירת Bucket.

3. מלאו את פרטי ה-Bucket הרלוונטיים ולבסוף לחצו על כפתור Create.

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

#הגדרות CORS

1. עברו לדף פרטי ה-Bucket שיצרתם בשלב הקודם.

2. לחצו על "Content Security -> CORS" בתפריט האמצעי.

3. לחצו על כפתור "Create Rule", מלאו את השדות הרלוונטיים, גללו למטה ולחצו על "OK". תוכלו להיעזר בצילום המסך למטה, או לבצע הגדרות מפורטות יותר.

#אחזור AccessKey ו-SecretAccessKey

1. לחצו על "AccessKey" מתחת לאווטאר החשבון שלכם בפינה הימנית העליונה.

2. לצורך הדגמה, ניצור AccessKey באמצעות החשבון הראשי. בסביבת ייצור, מומלץ להשתמש ב-RAM ליצירת AccessKey. להנחיות, אנא עיינו ב-תיעוד של Alibaba Cloud.

3. לחצו על כפתור "Create AccessKey".

4. השלימו את אימות החשבון.

5. שמרו את ה-Access Key וה-Secret Access Key המוצגים בעמוד.

#אחזור והגדרת פרמטרים

1. השתמשו ב-AccessKey ID וב-AccessKey Secret שהושגו בשלב הקודם.

2. עברו לדף פרטי ה-Bucket כדי לקבל את שם ה-Bucket.

3. גללו למטה כדי לקבל את ה-Region (הסיומת ".aliyuncs.com" אינה נחוצה).

4. קבלו את כתובת ה-Endpoint וודאו שאתם מוסיפים את הקידומת https:// בעת הזנתה ל-NocoBase.

#הגדרות תמונות ממוזערות (אופציונלי)

הגדרה זו היא אופציונלית ונועדה לשימוש רק כאשר יש צורך לייעל את גודל או אפקט תצוגה מקדימה של תמונות.

1. מלאו את הפרמטרים הרלוונטיים עבור Thumbnail rule. להגדרות פרמטרים ספציפיות, עיינו בתיעוד של Alibaba Cloud בנושא עיבוד תמונה.

2. שמרו את ההגדרות של Full upload URL style ו-Full access URL style זהות.

#דוגמת הגדרה

#MinIO

#יצירת Bucket

1. לחצו על תפריט Buckets בצד שמאל -> לחצו על Create Bucket כדי לפתוח את דף היצירה.
2. לאחר הזנת שם ה-Bucket, לחצו על כפתור Save.

#אחזור AccessKey ו-SecretAccessKey

1. עברו אל Access Keys -> לחצו על כפתור Create access key כדי לפתוח את דף היצירה.

2. לחצו על כפתור Save.

3. שמרו את ה-Access Key וה-Secret Key מהחלון הקופץ לשימוש בהגדרות עתידיות.

#הגדרת פרמטרים

1. עברו לדף File manager ב-NocoBase.

2. לחצו על כפתור Add new ובחרו S3 Pro.

3. מלאו את הטופס:

   • AccessKey ID ו-AccessKey Secret: השתמשו בערכים שנשמרו מהשלב הקודם.
   • Region: לפריסת MinIO פרטית אין מושג של Region; ניתן להגדיר אותו כ-"auto".
   • Endpoint: הזינו את שם הדומיין או כתובת ה-IP של השירות הפרוס שלכם.
   • יש להגדיר את Full access URL style ל-Path-Style.

#דוגמת הגדרה

#Tencent COS

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

#דוגמת הגדרה

#Cloudflare R2

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

#דוגמת הגדרה

#מדריך למשתמש

עיינו בתיעוד של תוסף file-manager.