Amazon S3 / MinIO Odoo Integration v.19

تعتمد الأداة على المكتبة الخارجية 'boto3'. ثبّتها على خادم Odoo عبر الأمر:

1. فعّل الخيار 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). الإضافة الاختيارية Amazon S3 Odoo Integration مطلوبة
2. افتح Amazon S3 Console: https://console.aws.amazon.com/s3/
3. أنشئ bucket جديداً أو اختر قائماً. انسخ اسم الـ bucket تماماً: يجب إدراجه في Odoo في الحقل 'Bucket'
4. افتح تفاصيل الـ bucket وانسخ AWS Region. أدخله في Odoo في الحقل 'Region' (مثلاً eu-west-1 أو us-east-1)
5. افتح AWS IAM Console: https://console.aws.amazon.com/iam/
6. أنشئ مستخدم IAM جديداً أو اختر مستخدماً تقنياً قائماً. يجب أن يملك هذا المستخدم صلاحيات كاملة لسرد الكائنات وقراءتها وإنشائها وكتابتها ونسخها وحذفها داخل الـ bucket المحدد. يمكنك اختيار مسؤول بصلاحيات كاملة، أو إنشاء سياسة جديدة (انظر أدناه)
7. في نموذج مستخدم IAM، افتح التبويب 'Security credentials' واضغط 'Create access key'
8. في الصفحة 'Access key best practices & alternatives'، اختر الخيار Application running outside AWS. هذا الخيار الصحيح عندما يتصل خادم Odoo بـ S3 بمفتاح وصول من خارج AWS، من Odoo.sh، من خادمك الخاص، أو من مزود استضافة آخر. إذا كان 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. إذا كنت تستخدم مزوداً متوافقاً مع S3 بدلاً من AWS S3، انسخ endpoint URL من لوحة إدارة ذلك المزود وأدخله في Odoo في الحقل 'Amazon S3 endpoint URL'. مثلاً يستخدم MinIO غالباً URL مثل 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. كاسم المجلد الجذر، أدخل عنواناً سيُستخدم كبادئة S3 الأب لكل المجلدات المتزامنة. مثلاً 'Odoo' أو 'OdooERP'
17. املأ الحقول 'Bucket' و'Region' و'Access Key' و'Secret Key'، وعند الحاجة 'Amazon S3 endpoint URL' ونمط العنونة
18. اختر ما إذا كان على Odoo استخدام URL موقّتة مسبقة التوقيع أو URL عامة للـ bucket/CDN. للـ buckets الخاصة، أبقِ URL مسبقة التوقيع مفعّلة وعيّن عمرها بالثواني
19. اضغط 'Confirm'. يتحقق Odoo من وصول الـ bucket وينشئ أو يتحقق من بادئة المجلد الجذر. تصبح مزامنة Amazon S3 - Odoo جاهزة للتنفيذ
20. طبّق عميل السحابة المنشأ حديثاً على قواعد المجلدات و/أو المجلدات اليدوية التي ينبغي مزامنتها مع bucket Amazon S3 ذلك
21. انتظر بدء مهمة المزامنة المجدولة. لأغراض الاختبار فقط: شغّل التكامل يدوياً من Cloud Storage > Configuration > Configuration > الزر 'Launch sync'.

وثائق AWS المفيدة: إنشاء S3 bucket: 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.

مثال سياسة Bucket

لدى Amazon S3 خصوصية مهمة: عنوان URL المعروض في Odoo هو دائمًا رابط من جانب Amazon.

إذا فُعّل Use Public URLs يحفظ Odoo عنوان 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. أنشئ bucket جديداً أو اختر قائماً. انسخ اسم الـ bucket تماماً: يجب إدراجه في Odoo في الحقل 'Bucket'
4. أنشئ بيانات اعتماد وصول لـ Odoo. في MinIO، استخدم زوج مفتاح وصول / مفتاح سري أو حساب خدمة يملك صلاحيات سرد الكائنات وقراءتها وإنشائها وكتابتها ونسخها وحذفها داخل الـ bucket المحدد
5. انسخ MinIO Access Key إلى حقل Odoo 'Access Key'
6. انسخ MinIO Secret Key إلى حقل Odoo 'Secret Key'. مهم: احفظ السر قبل إغلاق صفحة MinIO إذا عرضه MinIO مرة واحدة فقط
7. انسخ MinIO S3 API endpoint 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. كاسم المجلد الجذر، أدخل عنواناً سيُستخدم كبادئة كائن MinIO الأب لكل المجلدات المتزامنة. مثلاً 'Odoo' أو 'OdooERP'
12. املأ الحقول 'Bucket' و'Access Key' و'Secret Key' و'Amazon S3 endpoint URL'. الحقل 'Region' اختياري لـ MinIO؛ إذا كان فارغاً يستخدم Odoo us-east-1 للتوقيع المتوافق مع S3
13. أبقِ نمط العنونة Path-style. هذا الخيار الموصى به لنقاط نهاية MinIO، خاصة عندما لا يوفّر مضيف MinIO أسماء DNS خاصة بالـ bucket
14. اختر ما إذا كان على Odoo استخدام URL عامة مباشرة لـ MinIO. فعّل 'Use Public URLs' فقط عندما يكون الـ bucket أو البادئة أو الوكيل العكسي أو CDN قابلاً للقراءة علناً. لـ buckets MinIO الخاصة، اتركه معطّلاً
15. اضغط 'Confirm'. يتحقق Odoo من وصول الـ bucket وينشئ أو يتحقق من بادئة المجلد الجذر. تصبح مزامنة MinIO - Odoo جاهزة للتنفيذ
16. طبّق عميل السحابة المنشأ حديثاً على قواعد المجلدات و/أو المجلدات اليدوية التي ينبغي مزامنتها مع bucket MinIO ذلك
17. انتظر بدء مهمة المزامنة المجدولة. لأغراض الاختبار فقط: شغّل التكامل يدوياً من Cloud Storage > Configuration > Configuration > الزر '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.