#pkg: "@nocobase/plugin-file-storage-s3-pro"

#फ़ाइल भंडारण: S3 (प्रो)

#परिचय

फ़ाइल प्रबंधन प्लगइन के आधार पर, यह संस्करण 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. "नया जोड़ें" बटन पर क्लिक करें और "S3 प्रो" चुनें।

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

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

#अमेज़न S3

#बकेट निर्माण

1. अमेज़न S3 कंसोल पर जाएँ: https://ap-southeast-1.console.aws.amazon.com/s3/home

2. दाहिनी ओर "बकेट बनाएँ" बटन पर क्लिक करें।

3. बकेट नाम भरें, अन्य फ़ील्ड को डिफ़ॉल्ट रहने दें, पृष्ठ के निचले भाग तक स्क्रॉल करें, और प्रक्रिया पूरी करने के लिए "बनाएँ" बटन पर क्लिक करें।

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

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

2. "अनुमति" टैब पर जाएँ और CORS कॉन्फ़िगरेशन अनुभाग तक नीचे स्क्रॉल करें।

3. निम्नलिखित कॉन्फ़िगरेशन दर्ज करें (आवश्यकतानुसार अनुकूलित करें) और सहेजें।

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

#AccessKey और SecretAccessKey पुनर्प्राप्ति

1. ऊपरी-दाहिनी ओर "सुरक्षा क्रेडेंशियल" बटन पर क्लिक करें।

2. "एक्सेस कीज़" अनुभाग तक स्क्रॉल करें और "एक्सेस की बनाएँ" पर क्लिक करें।

3. शर्तों से सहमत हों (उत्पादन वातावरण के लिए IAM का उपयोग करने की सलाह दी जाती है)।

4. प्रदर्शित Access Key और Secret Access Key को सहेजें।

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

1. AccessKey ID और AccessKey Secret वे मान हैं जो आपने पिछले चरण में प्राप्त किए थे। कृपया उन्हें सही ढंग से भरें।

2. बकेट के प्रॉपर्टीज़ पैनल पर जाएँ जहाँ आपको बकेट नाम और क्षेत्र (Region) की जानकारी मिलेगी।

#सार्वजनिक पहुँच (वैकल्पिक)

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

1. अनुमतियाँ पैनल में, "ऑब्जेक्ट ओनरशिप" तक स्क्रॉल करें, "संपादित करें" पर क्लिक करें, और ACLs सक्षम करें।

2. "सार्वजनिक पहुँच ब्लॉक करें" तक स्क्रॉल करें, "संपादित करें" पर क्लिक करें, और इसे ACL नियंत्रण की अनुमति देने के लिए सेट करें।

3. NocoBase में "सार्वजनिक पहुँच" को चेक करें।

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

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

1. Amazon CloudFront के लिए डायनामिक इमेज ट्रांसफ़ॉर्मेशन पर जाएँ।

2. परिनियोजन शुरू करने के लिए पृष्ठ के निचले भाग में Launch in the AWS Console बटन पर क्लिक करें।

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

   1. स्टैक बनाते समय, आपको उस Amazon S3 बकेट का नाम निर्दिष्ट करना होगा जिसमें स्रोत छवियां हैं। कृपया वह बकेट नाम दर्ज करें जो आपने पहले बनाया था।
   2. यदि आपने डेमो UI को परिनियोजित करना चुना है, तो परिनियोजन के बाद, आप छवि प्रसंस्करण कार्यक्षमता का परीक्षण करने के लिए UI का उपयोग कर सकते हैं। AWS CloudFormation कंसोल में, अपना स्टैक चुनें, "आउटपुट" टैब पर जाएँ, 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: अनदेखा करें चुनें (क्योंकि बकेट नाम कॉन्फ़िगरेशन में पहले ही भरा जा चुका है, इसलिए पहुँच के लिए इसकी आवश्यकता नहीं है)।

   

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

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

#बकेट निर्माण

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

2. बाईं ओर के मेनू से "बकेट" चुनें और "बकेट बनाएँ" पर क्लिक करें।

3. बकेट विवरण भरें और "बनाएँ" पर क्लिक करें।
   1. बकेट नाम: अपनी व्यावसायिक आवश्यकताओं के अनुसार चुनें।
   2. क्षेत्र (Region): अपने उपयोगकर्ताओं के लिए निकटतम क्षेत्र चुनें।
   3. अन्य सेटिंग्स डिफ़ॉल्ट रह सकती हैं या आवश्यकतानुसार अनुकूलित की जा सकती हैं।

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

1. अभी बनाए गए बकेट के विवरण पृष्ठ पर जाएँ।

2. बीच के मेनू में "सामग्री सुरक्षा -> CORS" पर क्लिक करें।

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

#AccessKey और SecretAccessKey पुनर्प्राप्ति

1. ऊपरी-दाहिनी ओर अपने खाते के अवतार के नीचे "AccessKey" पर क्लिक करें।

2. प्रदर्शन उद्देश्यों के लिए, हम मुख्य खाते का उपयोग करके एक AccessKey बनाएँगे। उत्पादन वातावरण में, AccessKey बनाने के लिए RAM का उपयोग करने की सलाह दी जाती है। निर्देशों के लिए, कृपया अलीबाबा क्लाउड दस्तावेज़ का संदर्भ लें।

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

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

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

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

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

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

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

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

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

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

1. Thumbnail rule के लिए प्रासंगिक पैरामीटर भरें। विशिष्ट पैरामीटर सेटिंग्स के लिए, छवि प्रसंस्करण पर अलीबाबा क्लाउड दस्तावेज़ का संदर्भ लें।

2. Full upload URL style और Full access URL style सेटिंग्स को समान रखें।

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

#MinIO

#बकेट निर्माण

1. बाईं ओर के बकेट मेनू पर क्लिक करें -> निर्माण पृष्ठ खोलने के लिए बकेट बनाएँ पर क्लिक करें।
2. बकेट नाम दर्ज करने के बाद, सहेजें बटन पर क्लिक करें।

#AccessKey और SecretAccessKey पुनर्प्राप्ति

1. एक्सेस कीज़ पर जाएँ -> निर्माण पृष्ठ खोलने के लिए एक्सेस की बनाएँ बटन पर क्लिक करें।

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

3. भविष्य के कॉन्फ़िगरेशन के लिए पॉपअप विंडो से Access Key और Secret Key सहेजें।

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

1. NocoBase में फ़ाइल प्रबंधक पृष्ठ पर जाएँ।

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

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

   • AccessKey ID और AccessKey Secret: पिछले चरण से सहेजे गए मानों का उपयोग करें।
   • क्षेत्र (Region): निजी तौर पर परिनियोजित MinIO में क्षेत्र की अवधारणा नहीं होती है; आप इसे "auto" पर सेट कर सकते हैं।
   • एंडपॉइंट: अपनी परिनियोजित सेवा का डोमेन नाम या IP पता दर्ज करें।
   • Full access URL style को Path-Style पर सेट करें।

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

#Tencent COS

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

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

#Cloudflare R2

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

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

#उपयोगकर्ता मार्गदर्शिका

फ़ाइल-प्रबंधक प्लगइन दस्तावेज़ का संदर्भ लें।