Amazon S3 / MinIO Odoo Integration v.19

Το εργαλείο εξαρτάται από την εξωτερική βιβλιοθήκη 'boto3'. Εγκαταστήστε τη στον διακομιστή Odoo με την εντολή:

1. Ενεργοποιήστε την επιλογή 'Amazon S3 Sync' (Cloud Storage > Διαμόρφωση > Διαμόρφωση). Απαιτείται το προαιρετικό πρόσθετο Amazon S3 Odoo Integration
2. Ανοίξτε την κονσόλα Amazon S3: https://console.aws.amazon.com/s3/
3. Δημιουργήστε νέο bucket ή επιλέξτε υπάρχον. Αντιγράψτε το ακριβές όνομα του bucket: πρέπει να εισαχθεί στο Odoo στο πεδίο 'Bucket'
4. Ανοίξτε τα στοιχεία του bucket και αντιγράψτε την περιοχή AWS. Εισαγάγετέ την στο Odoo στο πεδίο 'Region' (π.χ. eu-west-1 ή us-east-1)
5. Ανοίξτε την κονσόλα AWS IAM: 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, αντιγράψτε το URL του endpoint από τον πίνακα διαχειριστή του παρόχου και επικολλήστε το στο 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 client, επιλέξτε «Amazon S3»
16. Ως όνομα Root folder εισαγάγετε έναν τίτλο που θα χρησιμοποιείται ως γονικός S3 prefix για όλους τους συγχρονισμένους φακέλους. Για παράδειγμα, 'Odoo' ή 'OdooERP'
17. Συμπληρώστε τα πεδία 'Bucket', 'Region', 'Access Key', 'Secret Key' και, αν χρειάζεται, 'Amazon S3 endpoint URL' και στυλ διευθυνσιοδότησης
18. Επιλέξτε αν το Odoo θα χρησιμοποιεί προσωρινά presigned URL ή δημόσια URL bucket/CDN. Για ιδιωτικά bucket κρατήστε τα presigned URL ενεργά και ορίστε τη διάρκεια ζωής τους σε δευτερόλεπτα
19. Πατήστε 'Confirm'. Το Odoo ελέγχει την πρόσβαση στο bucket και δημιουργεί ή επαληθεύει το πρόθεμα του ριζικού φακέλου. Ο συγχρονισμός Amazon S3 - Odoo είναι έτοιμος να γίνει
20. Εφαρμόστε τον νέο cloud client σε κανόνες φακέλων ή/και χειροκίνητους φακέλους που πρέπει να συγχρονιστούν με εκείνο το bucket 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.

Παράδειγμα πολιτικής bucket

Το Amazon S3 έχει μια σημαντική ιδιαιτερότητα: η URL που εμφανίζεται στο Odoo είναι πάντα σύνδεσμος της πλευράς Amazon.

Αν το Use Public URLs είναι ενεργό, το Odoo αποθηκεύει απευθείας URL αντικειμένου S3. Ο σύνδεσμος λειτουργεί μόνο αν το σχετικό bucket, πρόθεμα, αντικείμενο, CDN ή συμβατό endpoint είναι δημόσια αναγνώσιμο. Αλλιώς το 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 με το πραγματικό όνομα bucket και το Odoo/ με το επιλεγμένο πρόθεμα ριζικού φακέλου. Βεβαιωθείτε επίσης ότι οι ρυθμίσεις Amazon S3 Block public access δεν αποκλείουν αυτή την πολιτική bucket.

Αν το Use Public URLs είναι απενεργοποιημένο, το Odoo αποθηκεύει συνδέσμους AWS Console στο σχετικό αντικείμενο ή πρόθεμα του bucket. Τέτοιοι σύνδεσμοι είναι χρήσιμοι για χρήστες Amazon: όποιος ανοίγει τον σύνδεσμο πρέπει να είναι συνδεδεμένος στο AWS και να έχει πρόσβαση IAM σε αυτό το αντικείμενο. Αν ο χρήστης δεν έχει πρόσβαση AWS, η Amazon δεν θα ανοίξει το αρχείο.

1. Προετοιμάστε έναν ενεργό διακομιστή MinIO
2. Ανοίξτε την κονσόλα MinIO
3. Δημιουργήστε νέο bucket ή επιλέξτε υπάρχον. Αντιγράψτε το ακριβές όνομα του bucket: πρέπει να εισαχθεί στο Odoo στο πεδίο 'Bucket'
4. Δημιουργήστε διαπιστευτήρια πρόσβασης για το Odoo. Στο MinIO, χρησιμοποιήστε ζεύγος access key / secret key ή λογαριασμό υπηρεσίας με δικαιώματα εμφάνισης, ανάγνωσης, δημιουργίας, εγγραφής, αντιγραφής και διαγραφής αντικειμένων στο επιλεγμένο bucket
5. Αντιγράψτε το MinIO Access Key στο πεδίο Odoo «Access Key»
6. Αντιγράψτε το MinIO Secret Key στο πεδίο Odoo «Secret Key». Σημαντικό: αποθηκεύστε το μυστικό πριν κλείσετε τη σελίδα MinIO αν το MinIO το εμφανίζει μόνο μία φορά
7. Αντιγράψτε το URL του σημείου πρόσβασης MinIO S3 API στο Odoo στο πεδίο «Amazon S3 endpoint URL». Για παράδειγμα, ένας τοπικός διακομιστής συνήθως χρησιμοποιεί http://localhost:9000, ενώ ένας διακομιστής παραγωγής μπορεί να χρησιμοποιεί https://minio.example.com
8. Μεταβείτε στο Odoo Cloud Storage > Configuration > Cloud Clients και πατήστε 'Create'
9. Ως αναφορά, εισαγάγετε ένα όνομα κατανοητό σε όλους τους χρήστες
10. Ως Cloud client, επιλέξτε «MinIO»
11. Ως όνομα Root folder εισαγάγετε έναν τίτλο που θα χρησιμοποιείται ως γονικός MinIO object prefix για όλους τους συγχρονισμένους φακέλους. Για παράδειγμα, 'Odoo' ή 'OdooERP'
12. Συμπληρώστε τα πεδία 'Bucket', 'Access Key', 'Secret Key' και 'Amazon S3 endpoint URL'. Το πεδίο 'Region' είναι προαιρετικό για MinIO· αν είναι κενό, το Odoo χρησιμοποιεί us-east-1 για υπογραφή συμβατή με S3
13. Κρατήστε το στυλ διευθυνσιοδότησης ως Path-style. Αυτή είναι η συνιστώμενη επιλογή για endpoint MinIO, ειδικά όταν ο κεντρικός υπολογιστής MinIO δεν παρέχει ονόματα DNS ανά bucket
14. Επιλέξτε αν το Odoo θα χρησιμοποιεί άμεσα δημόσια URL MinIO. Ενεργοποιήστε το «Use Public URLs» μόνο όταν το bucket, το prefix, ο αντίστροφος διαμεσολαβητής ή το CDN είναι δημόσια αναγνώσιμα. Για ιδιωτικά bucket MinIO αφήστε το απενεργοποιημένο
15. Πατήστε 'Confirm'. Το Odoo ελέγχει την πρόσβαση στο bucket και δημιουργεί ή επαληθεύει το πρόθεμα του ριζικού φακέλου. Ο συγχρονισμός MinIO - Odoo είναι έτοιμος να γίνει
16. Εφαρμόστε τον νέο cloud client σε κανόνες φακέλων ή/και χειροκίνητους φακέλους που πρέπει να συγχρονιστούν με εκείνο το bucket 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.