#स्टोरेज इंजन: S3 (प्रो)

#परिचय

फ़ाइल मैनेजर प्लगइन के आधार पर, यह S3 प्रोटोकॉल-संगत फ़ाइल स्टोरेज प्रकारों के लिए समर्थन जोड़ता है। S3 प्रोटोकॉल का समर्थन करने वाली कोई भी ऑब्जेक्ट स्टोरेज सेवा आसानी से एकीकृत की जा सकती है, जैसे कि अमेज़न S3, अलीबाबा क्लाउड OSS, टेनसेंट क्लाउड COS, MinIO, Cloudflare R2, आदि, जिससे स्टोरेज सेवाओं की संगतता और लचीलापन और बढ़ता है।

#विशेषताएँ

1. क्लाइंट-साइड अपलोड: फ़ाइल अपलोड प्रक्रिया NocoBase सर्वर से होकर नहीं गुजरती है, बल्कि सीधे फ़ाइल स्टोरेज सेवा से जुड़ती है, जिससे अधिक कुशल और तेज़ अपलोड अनुभव मिलता है।

2. निजी एक्सेस: फ़ाइलों को एक्सेस करते समय, सभी URL हस्ताक्षरित अस्थायी अधिकृत पते होते हैं, जो फ़ाइल एक्सेस की सुरक्षा और समयबद्धता सुनिश्चित करते हैं।

#उपयोग के मामले

1. फ़ाइल संग्रह प्रबंधन: सभी अपलोड की गई फ़ाइलों को केंद्रीय रूप से प्रबंधित और स्टोर करें, विभिन्न फ़ाइल प्रकारों और स्टोरेज विधियों का समर्थन करते हुए, फ़ाइलों के आसान वर्गीकरण और पुनर्प्राप्ति के लिए।

2. अटैचमेंट फ़ील्ड स्टोरेज: फ़ॉर्म या रिकॉर्ड में अपलोड किए गए अटैचमेंट के डेटा स्टोरेज के लिए उपयोग किया जाता है, जो विशिष्ट डेटा रिकॉर्ड के साथ जुड़ाव का समर्थन करता है।

#प्लगइन कॉन्फ़िगरेशन

1. plugin-file-storage-s3-pro प्लगइन को सक्षम करें।

2. फ़ाइल मैनेजर सेटिंग्स में जाने के लिए "सेटिंग्स -> फ़ाइल मैनेजर" पर क्लिक करें।

3. "नया जोड़ें" बटन पर क्लिक करें और "S3 प्रो" चुनें।

4. पॉप-अप खुलने के बाद, आपको भरने के लिए कई फ़ील्ड वाला एक फ़ॉर्म दिखाई देगा। आप संबंधित फ़ाइल सेवा के लिए आवश्यक पैरामीटर जानकारी प्राप्त करने और उसे फ़ॉर्म में सही ढंग से भरने के लिए बाद के दस्तावेज़ों का संदर्भ ले सकते हैं।

#सेवा प्रदाता कॉन्फ़िगरेशन

#अमेज़न S3

#बकेट बनाना

1. S3 कंसोल में जाने के लिए https://ap-southeast-1.console.aws.amazon.com/s3/home खोलें।

2. दाईं ओर "Create bucket" बटन पर क्लिक करें।

2. बकेट नाम (स्टोरेज बकेट नाम) भरें। अन्य फ़ील्ड को डिफ़ॉल्ट सेटिंग्स पर छोड़ा जा सकता है। पेज के नीचे तक स्क्रॉल करें और बनाने की प्रक्रिया पूरी करने के लिए "Create" बटन पर क्लिक करें।

#CORS कॉन्फ़िगरेशन

1. बकेट सूची में जाएँ, और उसके विवरण पेज में जाने के लिए अभी बनाए गए बकेट को ढूंढें और उस पर क्लिक करें।

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. बकेट विवरण पेज के प्रॉपर्टीज़ पैनल पर जाएँ, जहाँ आप बकेट नाम और रीजन (क्षेत्र) की जानकारी प्राप्त कर सकते हैं।

#सार्वजनिक एक्सेस (वैकल्पिक)

यह एक वैकल्पिक कॉन्फ़िगरेशन है। इसे तब कॉन्फ़िगर करें जब आपको अपलोड की गई फ़ाइलों को पूरी तरह से सार्वजनिक करने की आवश्यकता हो।

1. परमिशन पैनल पर जाएँ, ऑब्जेक्ट ओनरशिप तक नीचे स्क्रॉल करें, एडिट पर क्लिक करें, और ACLs सक्षम करें।

2. ब्लॉक पब्लिक एक्सेस तक स्क्रॉल करें, एडिट पर क्लिक करें, और इसे ACLs नियंत्रण की अनुमति देने के लिए सेट करें।

3. NocoBase में पब्लिक एक्सेस को चेक करें।

#थंबनेल कॉन्फ़िगरेशन (वैकल्पिक)

यह कॉन्फ़िगरेशन वैकल्पिक है और इसका उपयोग इमेज प्रीव्यू के आकार या प्रभावों को अनुकूलित करने के लिए किया जाता है। कृपया ध्यान दें कि इस परिनियोजन समाधान से अतिरिक्त लागतें लग सकती हैं। विशिष्ट शुल्कों के लिए, कृपया AWS के संबंधित नियमों और शर्तों का संदर्भ लें।

1. Dynamic Image Transformation for Amazon CloudFront पर जाएँ।

2. समाधान को परिनियोजित करना शुरू करने के लिए पेज के नीचे Launch in the AWS Console बटन पर क्लिक करें।

3. कॉन्फ़िगरेशन पूरा करने के लिए संकेतों का पालन करें। निम्नलिखित विकल्पों पर विशेष ध्यान दें:

   1. स्टैक बनाते समय, आपको एक अमेज़न S3 स्टोरेज बकेट का नाम निर्दिष्ट करना होगा जिसमें स्रोत इमेज हों। कृपया उस बकेट का नाम दर्ज करें जिसे आपने पहले बनाया था।
   2. यदि आप डेमो UI को परिनियोजित करना चुनते हैं, तो परिनियोजन के बाद आप इस इंटरफ़ेस के माध्यम से इमेज प्रोसेसिंग सुविधाओं का परीक्षण कर सकते हैं। AWS CloudFormation कंसोल में, अपने स्टैक का चयन करें, "आउटपुट" टैब पर जाएँ, DemoUrl कुंजी के अनुरूप मान ढूंढें, और डेमो इंटरफ़ेस खोलने के लिए लिंक पर क्लिक करें।
   3. यह समाधान कुशल इमेज प्रोसेसिंग के लिए sharp Node.js लाइब्रेरी का उपयोग करता है। आप GitHub रिपॉजिटरी से स्रोत कोड डाउनलोड कर सकते हैं और आवश्यकतानुसार इसे अनुकूलित कर सकते हैं।

   

4. कॉन्फ़िगरेशन पूरा होने के बाद, परिनियोजन स्थिति के CREATE_COMPLETE में बदलने की प्रतीक्षा करें।

5. NocoBase कॉन्फ़िगरेशन में, ध्यान देने योग्य कुछ बातें हैं:

   1. थंबनेल नियम: इमेज प्रोसेसिंग से संबंधित पैरामीटर भरें, उदाहरण के लिए, ?width=100। विवरण के लिए, AWS दस्तावेज़ का संदर्भ लें।
   2. एक्सेस एंडपॉइंट: परिनियोजन के बाद आउटपुट -> ApiEndpoint का मान भरें।
   3. पूर्ण एक्सेस URL स्टाइल: आपको अनदेखा करें (Ignore) को चेक करना होगा (क्योंकि कॉन्फ़िगरेशन के दौरान बकेट का नाम पहले ही भर दिया गया था, एक्सेस के लिए इसकी अब आवश्यकता नहीं है)।

   

#कॉन्फ़िगरेशन उदाहरण

#अलीबाबा क्लाउड OSS

#बकेट बनाना

1. OSS कंसोल https://oss.console.aliyun.com/overview खोलें।

2. बाईं ओर के मेनू में "Buckets" पर क्लिक करें, फिर बकेट बनाना शुरू करने के लिए "Create Bucket" बटन पर क्लिक करें।

3. बकेट से संबंधित जानकारी भरें और अंत में Create बटन पर क्लिक करें।

   1. बकेट नाम आपकी व्यावसायिक आवश्यकताओं के अनुरूप होना चाहिए; नाम मनमाना हो सकता है।

   2. अपने उपयोगकर्ताओं के सबसे नज़दीकी रीजन का चयन करें।

   3. अन्य सेटिंग्स को डिफ़ॉल्ट पर छोड़ा जा सकता है या आपकी आवश्यकताओं के आधार पर कॉन्फ़िगर किया जा सकता है।

#CORS कॉन्फ़िगरेशन

1. पिछले चरण में बनाए गए बकेट के विवरण पेज पर जाएँ।

2. बीच के मेनू में "Content Security -> CORS" पर क्लिक करें।

3. "Create Rule" बटन पर क्लिक करें, संबंधित सामग्री भरें, नीचे स्क्रॉल करें, और "OK" पर क्लिक करें। आप नीचे दिए गए स्क्रीनशॉट का संदर्भ ले सकते हैं या अधिक विस्तृत सेटिंग्स कॉन्फ़िगर कर सकते हैं।

#AccessKey और SecretAccessKey प्राप्त करना

1. ऊपरी दाएं कोने में अपनी प्रोफ़ाइल तस्वीर के नीचे "AccessKey" पर क्लिक करें।

2. प्रदर्शन उद्देश्यों के लिए, हम मुख्य खाते का उपयोग करके एक AccessKey बना रहे हैं। उत्पादन वातावरण में, इसे बनाने के लिए RAM का उपयोग करने की सलाह दी जाती है। आप https://www.alibabacloud.com/help/en/ram/user-guide/create-an-accesskey-pair का संदर्भ ले सकते हैं।

3. "Create AccessKey" बटन पर क्लिक करें।

4. खाता सत्यापन करें।

5. पेज पर प्रदर्शित Access key और Secret access key को सहेजें।

#पैरामीटर प्राप्त करना और कॉन्फ़िगर करना

1. AccessKey ID और AccessKey Secret पिछले चरण में प्राप्त किए गए मान हैं।

2. बकेट नाम प्राप्त करने के लिए बकेट विवरण पेज पर जाएँ।

3. रीजन प्राप्त करने के लिए नीचे स्क्रॉल करें (पीछे का ".aliyuncs.com" आवश्यक नहीं है)।

4. एंडपॉइंट पता प्राप्त करें, और NocoBase में भरते समय https:// उपसर्ग जोड़ें।

#थंबनेल कॉन्फ़िगरेशन (वैकल्पिक)

यह कॉन्फ़िगरेशन वैकल्पिक है और इसका उपयोग केवल तभी किया जाना चाहिए जब आपको इमेज प्रीव्यू के आकार या प्रभावों को अनुकूलित करने की आवश्यकता हो।

1. थंबनेल नियम से संबंधित पैरामीटर भरें। विशिष्ट पैरामीटर सेटिंग्स के लिए, इमेज प्रोसेसिंग पैरामीटर्स का संदर्भ लें।

2. पूर्ण अपलोड URL स्टाइल और पूर्ण एक्सेस URL स्टाइल समान रखे जा सकते हैं।

#कॉन्फ़िगरेशन उदाहरण

#MinIO

#बकेट बनाना

1. बाईं ओर के बकेट मेनू पर क्लिक करें -> Create Bucket पर क्लिक करें, और बनाने वाले पेज पर जाएँ।
2. बकेट नाम भरने के बाद, सेव बटन पर क्लिक करें।

#AccessKey और SecretAccessKey प्राप्त करना

1. एक्सेस कीज़ पर जाएँ -> Create access key बटन पर क्लिक करें, और बनाने वाले पेज पर जाएँ।

2. सेव बटन पर क्लिक करें।

1. पॉप-अप विंडो से Access Key और Secret Key को बाद के कॉन्फ़िगरेशन के लिए सहेजें।

#पैरामीटर कॉन्फ़िगरेशन

1. NocoBase -> फ़ाइल मैनेजर पेज पर जाएँ।

2. "नया जोड़ें" बटन पर क्लिक करें और S3 प्रो चुनें।

3. फ़ॉर्म भरें:

   • AccessKey ID और AccessKey Secret वे मान हैं जो पिछले चरण में सहेजे गए थे।
   • रीजन: एक स्व-होस्टेड MinIO में रीजन की कोई अवधारणा नहीं होती है, इसलिए इसे "auto" के रूप में कॉन्फ़िगर किया जा सकता है।
   • एंडपॉइंट: अपने परिनियोजन के डोमेन नाम या IP पते को भरें।
   • पूर्ण एक्सेस URL स्टाइल को Path-Style पर सेट किया जाना चाहिए।

#कॉन्फ़िगरेशन उदाहरण

#टेनसेंट क्लाउड COS

आप ऊपर वर्णित फ़ाइल सेवाओं के कॉन्फ़िगरेशन का संदर्भ ले सकते हैं, क्योंकि तर्क समान है।

#कॉन्फ़िगरेशन उदाहरण

#Cloudflare R2

आप ऊपर वर्णित फ़ाइल सेवाओं के कॉन्फ़िगरेशन का संदर्भ ले सकते हैं, क्योंकि तर्क समान है।

#कॉन्फ़िगरेशन उदाहरण