Amazon S3 / MinIO Odoo Integration v.19

Công cụ phụ thuộc thư viện ngoài 'boto3'. Cài cho máy chủ Odoo bằng lệnh:

1. Bật tùy chọn 'Amazon S3 Sync' (Cloud Storage > Cấu hình > Cấu hình). Cần tiện ích bổ sung tùy chọn Amazon S3 Odoo Integration
2. Mở bảng điều khiển Amazon S3: https://console.aws.amazon.com/s3/
3. Tạo bucket mới hoặc chọn bucket có sẵn. Sao chép đúng tên bucket: phải điền vào Odoo trong trường 'Bucket'
4. Mở chi tiết bucket và sao chép AWS Region. Điền vào Odoo trường 'Region' (ví dụ eu-west-1 hoặc us-east-1)
5. Mở bảng điều khiển AWS IAM: https://console.aws.amazon.com/iam/
6. Tạo người dùng IAM mới hoặc chọn người dùng kỹ thuật có sẵn. Người này phải có toàn quyền liệt kê, đọc, tạo, ghi, sao chép và xóa đối tượng trong bucket đã chọn. Bạn có thể chọn admin đủ quyền, hoặc tạo chính sách mới (xem bên dưới)
7. Trên biểu mẫu người dùng IAM, mở tab 'Security credentials' rồi nhấn 'Create access key'
8. Trên trang 'Access key best practices & alternatives', chọn Application running outside AWS. Đây là lựa chọn đúng khi máy chủ Odoo kết nối S3 bằng khóa truy cập từ ngoài AWS, từ Odoo.sh, từ máy chủ của bạn hoặc nhà cung cấp hosting khác. Nếu Odoo cài trên phiên bản AWS EC2, bạn có thể chọn Application running on an AWS compute service, nhưng các trường sao chép sang Odoo vẫn giống nhau
9. Nhấn 'Next'. Ở bước tiếp, tùy chọn nhập thẻ mô tả như Odoo S3 Sync, rồi nhấn 'Create access key'
10. Trên trang AWS cuối, sao chép Access key hoặc Access key ID vào trường Odoo 'Access Key'
11. Sao chép Secret access key vào trường Odoo 'Secret Key'. Quan trọng: AWS chỉ hiện khóa bí mật một lần, hãy lưu trước khi đóng cửa sổ
12. Nếu dùng nhà cung cấp tương thích S3 thay AWS S3, sao chép URL endpoint từ bảng quản trị của nhà cung cấp rồi dán vào Odoo trường 'Amazon S3 endpoint URL'. Ví dụ MinIO thường dùng URL như https://minio.example.com hoặc http://localhost:9000; LocalStack thường http://localhost:4566
13. Vào Odoo Cloud Storage > Configuration > Cloud Clients rồi nhấn 'Create'
14. Với tham chiếu, nhập tên rõ với mọi người dùng
15. Với Cloud client, chọn «Amazon S3»
16. Với tên Root folder, nhập tiêu đề sẽ dùng làm S3 prefix cha cho mọi thư mục đồng bộ. Ví dụ 'Odoo' hoặc 'OdooERP'
17. Điền các trường 'Bucket', 'Region', 'Access Key', 'Secret Key' và nếu cần, 'Amazon S3 endpoint URL' cùng kiểu địa chỉ
18. Chọn Odoo dùng URL presigned tạm thời hay URL bucket/CDN công khai. Với bucket riêng, giữ URL presigned bật và đặt thời hạn theo giây
19. Nhấn 'Confirm'. Odoo kiểm tra quyền bucket và tạo hoặc xác minh tiền tố thư mục gốc. Đồng bộ Amazon S3 - Odoo đã sẵn sàng
20. Áp dụng cloud client vừa tạo cho quy tắc thư mục và/hoặc thư mục thủ công cần đồng bộ với bucket Amazon S3 đó
21. Chờ công việc đồng bộ đã lên lịch khởi chạy. Chỉ dùng để kiểm thử: kích hoạt tích hợp thủ công từ Cloud Storage > Cấu hình > Cấu hình > nút 'Launch sync'.

Tài liệu AWS hữu ích: tạo S3 bucket: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, quản lý khóa truy cập IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Ví dụ chính sách bucket

Amazon S3 có đặc điểm quan trọng: URL hiện trong Odoo luôn là liên kết phía Amazon.

Nếu Use Public URLs bật, Odoo lưu URL đối tượng S3 trực tiếp. Liên kết chỉ hoạt động nếu bucket, tiền tố, đối tượng, CDN hoặc endpoint tương thích liên quan đọc được công khai. Nếu không, Amazon S3 hiện AccessDenied, dù người dùng đã đăng nhập bảng điều khiển AWS.

Với liên kết công khai, cấu hình quyền thùng trên Amazon S3 và cho phép đọc công khai tiền tố Odoo. Ví dụ chính sách thùng:

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

Thay YOUR_BUCKET_NAME bằng tên bucket thật và Odoo/ bằng tiền tố thư mục gốc đã chọn. Đồng thời đảm bảo cài đặt Amazon S3 Block public access không chặn chính sách bucket đó.

Nếu Use Public URLs tắt, Odoo lưu liên kết AWS Console tới đối tượng hoặc tiền tố bucket liên quan. Liên kết này hữu ích cho người dùng Amazon: người mở phải đăng nhập AWS và có quyền IAM với đối tượng đó. Nếu không có quyền AWS, Amazon sẽ không mở tệp.

1. Chuẩn bị máy chủ MinIO đang chạy
2. Mở bảng điều khiển MinIO
3. Tạo bucket mới hoặc chọn bucket có sẵn. Sao chép đúng tên bucket: phải điền vào Odoo trong trường 'Bucket'
4. Tạo thông tin đăng nhập truy cập cho Odoo. Trong MinIO, dùng cặp access key / secret key hoặc tài khoản dịch vụ có quyền liệt kê, đọc, tạo, ghi, sao chép và xóa đối tượng trong bucket đã chọn
5. Sao chép MinIO Access Key vào trường Odoo 'Access Key'
6. Sao chép MinIO Secret Key vào trường Odoo 'Secret Key'. Quan trọng: lưu bí mật trước khi đóng trang MinIO nếu MinIO chỉ hiện một lần
7. Sao chép URL điểm cuối API S3 MinIO vào Odoo vào trường 'Amazon S3 endpoint URL'. Ví dụ, máy chủ cục bộ thường dùng http://localhost:9000, còn máy chủ production có thể dùng https://minio.example.com
8. Vào Odoo Cloud Storage > Configuration > Cloud Clients rồi nhấn 'Create'
9. Với tham chiếu, nhập tên rõ với mọi người dùng
10. Với Cloud client, chọn «MinIO»
11. Với tên Root folder, nhập tiêu đề sẽ dùng làm MinIO object prefix cha cho mọi thư mục đồng bộ. Ví dụ 'Odoo' hoặc 'OdooERP'
12. Điền các trường 'Bucket', 'Access Key', 'Secret Key' và 'Amazon S3 endpoint URL'. Trường 'Region' là tùy chọn với MinIO; nếu trống, Odoo dùng us-east-1 để ký tương thích S3
13. Giữ kiểu địa chỉ là Path-style. Đây là tùy chọn khuyến nghị cho endpoint MinIO, nhất là khi máy chủ MinIO không cung cấp tên DNS riêng cho từng bucket
14. Chọn Odoo có dùng URL MinIO công khai trực tiếp hay không. Bật «Use Public URLs» chỉ khi bucket, tiền tố, proxy ngược hoặc CDN đọc được công khai. Với bucket MinIO riêng, hãy để tắt
15. Nhấn 'Confirm'. Odoo kiểm tra quyền bucket và tạo hoặc xác minh tiền tố thư mục gốc. Đồng bộ MinIO - Odoo đã sẵn sàng
16. Áp dụng cloud client vừa tạo cho quy tắc thư mục và/hoặc thư mục thủ công cần đồng bộ với bucket MinIO đó
17. Chờ công việc đồng bộ đã lên lịch khởi chạy. Chỉ dùng để kiểm thử: kích hoạt tích hợp thủ công từ Cloud Storage > Cấu hình > Cấu hình > nút 'Launch sync'.

Tài liệu MinIO hữu ích: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.