Amazon S3 / MinIO Odoo Integration v.19

Alat bergantung pada pustaka eksternal 'boto3'. Pasang di server Odoo dengan perintah:

1. Aktifkan opsi 'Amazon S3 Sync' (Cloud Storage > Konfigurasi > Konfigurasi). Add-on opsional Amazon S3 Odoo Integration diperlukan
2. Buka Konsol Amazon S3: https://console.aws.amazon.com/s3/
3. Buat bucket baru atau pilih yang sudah ada. Salin nama bucket yang tepat: harus dimasukkan di Odoo ke bidang 'Bucket'
4. Buka detail bucket dan salin AWS Region-nya. Masukkan di Odoo ke bidang 'Region' (misalnya, eu-west-1 atau us-east-1)
5. Buka Konsol AWS IAM: https://console.aws.amazon.com/iam/
6. Buat pengguna IAM baru atau pilih pengguna teknis yang ada. Pengguna ini harus memiliki hak penuh untuk mencantumkan, membaca, membuat, menulis, menyalin, dan menghapus objek dalam bucket yang dipilih. Anda dapat memilih admin hak penuh, atau membuat kebijakan baru (lihat di bawah)
7. Di formulir pengguna IAM, buka tab 'Security credentials' lalu tekan 'Create access key'
8. Di halaman 'Access key best practices & alternatives', pilih Application running outside AWS. Ini opsi yang benar saat server Odoo terhubung ke S3 dengan access key dari luar AWS, dari Odoo.sh, dari server Anda, atau penyedia hosting lain. Jika Odoo terpasang di instans AWS EC2, Anda dapat memilih Application running on an AWS compute service, tetapi bidang yang disalin ke Odoo sama
9. Tekan 'Next'. Pada langkah berikutnya, secara opsional masukkan tag deskripsi seperti Odoo S3 Sync, lalu tekan 'Create access key'
10. Di halaman AWS terakhir, salin Access key atau Access key ID ke bidang Odoo 'Access Key'
11. Salin Secret access key ke field Odoo 'Secret Key'. Penting: AWS menampilkan kunci rahasia hanya sekali, jadi simpan sebelum menutup jendela
12. Jika memakai penyedia kompatibel S3 alih-alih AWS S3, salin URL endpoint dari panel admin penyedia itu lalu masukkan ke Odoo pada field 'Amazon S3 endpoint URL'. Misalnya MinIO sering memakai URL seperti https://minio.example.com atau http://localhost:9000; LocalStack biasanya http://localhost:4566
13. Buka Odoo Cloud Storage > Configuration > Cloud Clients lalu tekan 'Create'
14. Sebagai referensi, masukkan nama yang jelas bagi semua pengguna
15. Sebagai Cloud client, pilih 'Amazon S3'
16. Sebagai nama Root folder, masukkan judul yang akan dipakai sebagai S3 prefix induk untuk semua folder tersinkron. Misalnya, 'Odoo' atau 'OdooERP'
17. Isi field 'Bucket', 'Region', 'Access Key', 'Secret Key', dan jika perlu 'Amazon S3 endpoint URL' serta gaya pengalamatan
18. Pilih apakah Odoo harus memakai URL presigned sementara atau URL bucket/CDN publik. Untuk bucket privat, biarkan URL presigned aktif dan atur masa hidupnya dalam detik
19. Tekan 'Confirm'. Odoo memeriksa akses bucket lalu membuat atau memverifikasi awalan folder akar. Sinkronisasi Amazon S3 - Odoo siap dilakukan
20. Terapkan cloud client yang baru dibuat ke aturan folder dan/atau folder manual yang harus disinkronkan dengan bucket Amazon S3 itu
21. Tunggu pekerjaan terjadwal sinkron mulai. Hanya untuk pengujian: picu integrasi secara manual dari Cloud Storage > Konfigurasi > Konfigurasi > tombol 'Launch sync'.

Dokumentasi AWS yang berguna: membuat bucket S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, mengelola kunci akses IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Contoh kebijakan bucket

Amazon S3 punya kekhasan penting: URL yang tampil di Odoo selalu tautan sisi Amazon.

Jika Use Public URLs diaktifkan, Odoo menyimpan URL objek S3 langsung. Tautan ini hanya berfungsi jika bucket, prefiks, objek, CDN, atau endpoint kompatibel terkait dapat dibaca publik. Jika tidak, Amazon S3 menampilkan AccessDenied, meski pengguna masuk ke konsol AWS.

Untuk tautan publik, konfigurasi izin bucket di Amazon S3 dan izinkan baca publik untuk prefiks Odoo. Contoh kebijakan bucket:

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

Ganti YOUR_BUCKET_NAME dengan nama bucket yang sebenarnya dan Odoo/ dengan awalan folder akar yang dipilih. Pastikan juga pengaturan Amazon S3 Block public access tidak memblokir kebijakan bucket itu.

Jika Use Public URLs dinonaktifkan, Odoo menyimpan tautan AWS Console ke objek atau prefiks bucket terkait. Tautan ini berguna bagi pengguna Amazon: orang yang membuka harus masuk ke AWS dan punya akses IAM ke objek itu. Jika pengguna tidak punya akses AWS, Amazon tidak akan membuka file.

1. Siapkan server MinIO yang berjalan
2. Buka Konsol MinIO
3. Buat bucket baru atau pilih yang sudah ada. Salin nama bucket yang tepat: harus dimasukkan di Odoo ke bidang 'Bucket'
4. Buat kredensial akses untuk Odoo. Di MinIO, gunakan pasangan access key / secret key atau akun layanan yang berhak mencantumkan, membaca, membuat, menulis, menyalin, dan menghapus objek dalam bucket yang dipilih
5. Salin MinIO Access Key ke field Odoo 'Access Key'
6. Salin MinIO Secret Key ke field Odoo 'Secret Key'. Penting: simpan rahasia sebelum menutup halaman MinIO jika MinIO menampilkannya hanya sekali
7. Salin URL endpoint API S3 MinIO ke Odoo ke field 'Amazon S3 endpoint URL'. Misalnya, server lokal biasanya memakai http://localhost:9000, sedangkan server produksi dapat memakai https://minio.example.com
8. Buka Odoo Cloud Storage > Configuration > Cloud Clients lalu tekan 'Create'
9. Sebagai referensi, masukkan nama yang jelas bagi semua pengguna
10. Sebagai Cloud client, pilih 'MinIO'
11. Sebagai nama Root folder, masukkan judul yang akan dipakai sebagai MinIO object prefix induk untuk semua folder tersinkron. Misalnya, 'Odoo' atau 'OdooERP'
12. Isi field 'Bucket', 'Access Key', 'Secret Key', dan 'Amazon S3 endpoint URL'. Field 'Region' opsional untuk MinIO; jika kosong, Odoo memakai us-east-1 untuk penandatanganan kompatibel S3
13. Pertahankan gaya pengalamatan Path-style. Ini opsi yang disarankan untuk endpoint MinIO, terutama jika host MinIO tidak menyediakan nama DNS per bucket
14. Pilih apakah Odoo harus memakai URL MinIO publik langsung. Aktifkan «Use Public URLs» hanya jika bucket, prefix, reverse proxy, atau CDN dapat dibaca publik. Untuk bucket MinIO privat, biarkan nonaktif
15. Tekan 'Confirm'. Odoo memeriksa akses bucket lalu membuat atau memverifikasi awalan folder akar. Sinkronisasi MinIO - Odoo siap dilakukan
16. Terapkan cloud client yang baru dibuat ke aturan folder dan/atau folder manual yang harus disinkronkan dengan bucket MinIO itu
17. Tunggu pekerjaan terjadwal sinkron mulai. Hanya untuk pengujian: picu integrasi secara manual dari Cloud Storage > Konfigurasi > Konfigurasi > tombol 'Launch sync'.

Dokumentasi MinIO yang berguna: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.