Amazon S3 / MinIO Odoo Integration v.19

उपकरण बाहरी लाइब्रेरी 'boto3' पर निर्भर है। Odoo सर्वर पर इस कमांड से स्थापित करें:

1. विकल्प 'Amazon S3 Sync' चालू करें (Cloud Storage > कॉन्फ़िगरेशन > कॉन्फ़िगरेशन)। वैकल्पिक ऐड-ऑन Amazon S3 Odoo Integration आवश्यक है
2. Amazon S3 Console खोलें: https://console.aws.amazon.com/s3/
3. नया बकेट बनाएँ या मौजूदा चुनें। सटीक बकेट नाम कॉपी करें: इसे Odoo में फ़ील्ड 'Bucket' में डालना चाहिए
4. बकेट विवरण खोलें और उसका AWS Region कॉपी करें। Odoo में फ़ील्ड 'Region' में डालें (उदाहरण, eu-west-1 या us-east-1)
5. AWS IAM Console खोलें: https://console.aws.amazon.com/iam/
6. नया IAM उपयोगकर्ता बनाएँ या मौजूदा तकनीकी उपयोगकर्ता चुनें। इस उपयोगकर्ता के पास चयनित बकेट में ऑब्जेक्ट सूचीबद्ध, पढ़ने, बनाने, लिखने, कॉपी और हटाने के पूर्ण अधिकार होने चाहिए। आप पूर्ण अधिकार वाला एडमिन चुन सकते हैं, या नई नीति बना सकते हैं (नीचे देखें)
7. IAM उपयोगकर्ता फ़ॉर्म में टैब 'Security credentials' खोलें और 'Create access key' दबाएँ
8. पृष्ठ 'Access key best practices & alternatives' पर Application running outside AWS चुनें। जब आपका Odoo सर्वर AWS के बाहर, Odoo.sh, अपने सर्वर या अन्य होस्टिंग से एक्सेस कुंजी से S3 से जुड़ता है तो यही सही विकल्प है। यदि Odoo AWS EC2 इंस्टेंस पर है, तो Application running on an AWS compute service चुन सकते हैं, पर Odoo में कॉपी होने वाले फ़ील्ड वही रहते हैं
9. 'Next' दबाएँ। अगले चरण में वैकल्पिक रूप से Odoo S3 Sync जैसा विवरण टैग लिखें, फिर 'Create access key' दबाएँ
10. अंतिम AWS पृष्ठ पर Access key या Access key ID को Odoo फ़ील्ड 'Access Key' में कॉपी करें
11. Secret access key को Odoo फ़ील्ड 'Secret Key' में कॉपी करें। महत्वपूर्ण: AWS गुप्त कुंजी केवल एक बार दिखाता है, इसलिए विंडो बंद करने से पहले सहेजें
12. अगर AWS S3 की जगह S3-संगत प्रदाता उपयोग करते हैं, उस प्रदाता के एडमिन पैनल से एंडपॉइंट URL कॉपी कर Odoo के फ़ील्ड 'Amazon S3 endpoint URL' में डालें। जैसे MinIO अक्सर https://minio.example.com या http://localhost:9000 उपयोग करता है; LocalStack आमतौर पर http://localhost:4566
13. Odoo Cloud Storage > Configuration > Cloud Clients पर जाएँ और 'Create' दबाएँ
14. संदर्भ के रूप में, ऐसा नाम दें जो सभी उपयोगकर्ताओं को स्पष्ट हो
15. Cloud क्लाइंट के रूप में 'Amazon S3' चुनें
16. Root folder नाम में वह शीर्षक दें जो सभी सिंक फ़ोल्डरों का पैरेंट S3 prefix होगा। उदाहरण: 'Odoo' या 'OdooERP'
17. फ़ील्ड 'Bucket', 'Region', 'Access Key', 'Secret Key' भरें, और ज़रूरत हो तो 'Amazon S3 endpoint URL' तथा एड्रेसिंग स्टाइल भी
18. चुनें कि Odoo अस्थायी presigned URL इस्तेमाल करे या सार्वजनिक बकेट/CDN URL। निजी बकेट के लिए presigned URL चालू रखें और उनका जीवनकाल सेकंड में सेट करें
19. 'Confirm' दबाएँ। Odoo bucket पहुँच जाँचता है और रूट फ़ोल्डर उपसर्ग बनाता या सत्यापित करता है। Amazon S3 - Odoo सिंक्रनाइज़ेशन करने के लिए तैयार है
20. नया cloud client उन फ़ोल्डर नियमों और/या मैन्युअल फ़ोल्डरों पर लागू करें जिन्हें उस Amazon S3 बकेट से सिंक करना है
21. सिंक की निर्धारित जॉब शुरू होने की प्रतीक्षा करें। केवल परीक्षण के लिए: Cloud Storage > कॉन्फ़िगरेशन > कॉन्फ़िगरेशन > बटन 'Launch sync' से एकीकरण मैन्युअल चलाएँ।

उपयोगी AWS दस्तावेज़: S3 बकेट बनाना: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM एक्सेस कुंजियों का प्रबंधन: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

बकेट नीति का उदाहरण

Amazon S3 की एक महत्वपूर्ण विशेषता है: Odoo में दिखाया URL हमेशा Amazon-पक्ष का लिंक होता है।

अगर Use Public URLs चालू है, Odoo सीधे S3 ऑब्जेक्ट URL सहेजता है। यह लिंक तभी काम करता है जब संबंधित S3 बकेट, प्रिफ़िक्स, ऑब्जेक्ट, CDN या संगत एंडपॉइंट सार्वजनिक रूप से पठनीय हो। वरना Amazon S3 AccessDenied दिखाएगा, भले उपयोगकर्ता AWS कंसोल में लॉग इन हो।

सार्वजनिक लिंक के लिए Amazon S3 में बकेट अनुमतियाँ सेट करें और Odoo उपसर्ग के लिए सार्वजनिक पढ़ने की अनुमति दें। उदाहरण बकेट नीति:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadOdooPrefix",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/Odoo/*"
    }
  ]
}

YOUR_BUCKET_NAME को वास्तविक बकेट नाम और Odoo/ को चुने रूट फ़ोल्डर उपसर्ग से बदलें। यह भी सुनिश्चित करें कि Amazon S3 Block public access सेटिंग उस बकेट नीति को न रोकें।

अगर Use Public URLs बंद है, Odoo संबंधित बकेट ऑब्जेक्ट या प्रिफ़िक्स के AWS Console लिंक सहेजता है। ऐसे लिंक Amazon उपयोगकर्ताओं के लिए उपयोगी हैं: खोलने वाले को AWS में लॉग इन होना चाहिए और उस ऑब्जेक्ट पर IAM पहुँच होनी चाहिए। AWS पहुँच न हो तो Amazon फ़ाइल नहीं खोलेगा।

1. चल रहा MinIO सर्वर तैयार करें
2. MinIO Console खोलें
3. नया बकेट बनाएँ या मौजूदा चुनें। सटीक बकेट नाम कॉपी करें: इसे Odoo में फ़ील्ड 'Bucket' में डालना चाहिए
4. Odoo के लिए एक्सेस क्रेडेंशियल बनाएँ। MinIO में access key / secret key जोड़ी या ऐसा सेवा खाता उपयोग करें जिसके पास चयनित बकेट में ऑब्जेक्ट सूचीबद्ध करने, पढ़ने, बनाने, लिखने, कॉपी करने और हटाने के अधिकार हों
5. MinIO Access Key को Odoo फ़ील्ड 'Access Key' में कॉपी करें
6. MinIO Secret Key को Odoo फ़ील्ड 'Secret Key' में कॉपी करें। महत्वपूर्ण: यदि MinIO इसे केवल एक बार दिखाता है तो MinIO पृष्ठ बंद करने से पहले गुप्त कुंजी सहेजें
7. MinIO S3 API एंडपॉइंट URL को Odoo में फ़ील्ड 'Amazon S3 endpoint URL' में कॉपी करें। उदाहरण के लिए स्थानीय सर्वर आमतौर पर http://localhost:9000 उपयोग करता है, जबकि प्रोडक्शन सर्वर https://minio.example.com उपयोग कर सकता है
8. Odoo Cloud Storage > Configuration > Cloud Clients पर जाएँ और 'Create' दबाएँ
9. संदर्भ के रूप में, ऐसा नाम दें जो सभी उपयोगकर्ताओं को स्पष्ट हो
10. Cloud क्लाइंट के रूप में 'MinIO' चुनें
11. Root folder नाम में वह शीर्षक दें जो सभी सिंक फ़ोल्डरों का पैरेंट MinIO object prefix होगा। उदाहरण: 'Odoo' या 'OdooERP'
12. फ़ील्ड 'Bucket', 'Access Key', 'Secret Key' और 'Amazon S3 endpoint URL' भरें। 'Region' MinIO के लिए वैकल्पिक है; खाली होने पर Odoo S3-संगत साइन के लिए us-east-1 उपयोग करता है
13. एड्रेसिंग शैली Path-style रखें। MinIO एंडपॉइंट के लिए यही अनुशंसित विकल्प है, खासकर जब MinIO होस्ट बकेट-विशिष्ट DNS नाम न देता हो
14. चुनें कि Odoo सीधे सार्वजनिक MinIO URL इस्तेमाल करे या नहीं। «Use Public URLs» तभी चालू करें जब बकेट, प्रीफ़िक्स, रिवर्स प्रॉक्सी या CDN सार्वजनिक रूप से पढ़ने योग्य हो। निजी MinIO बकेट के लिए इसे बंद रखें
15. 'Confirm' दबाएँ। Odoo bucket पहुँच जाँचता है और रूट फ़ोल्डर उपसर्ग बनाता या सत्यापित करता है। MinIO - Odoo सिंक्रनाइज़ेशन करने के लिए तैयार है
16. नया cloud client उन फ़ोल्डर नियमों और/या मैन्युअल फ़ोल्डरों पर लागू करें जिन्हें उस MinIO बकेट से सिंक करना है
17. सिंक की निर्धारित जॉब शुरू होने की प्रतीक्षा करें। केवल परीक्षण के लिए: Cloud Storage > कॉन्फ़िगरेशन > कॉन्फ़िगरेशन > बटन 'Launch sync' से एकीकरण मैन्युअल चलाएँ।

उपयोगी MinIO दस्तावेज़: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.