Amazon S3 / MinIO Odoo Integration v.19

Alat bergantung pada pustaka luaran 'boto3'. Pasang pada pelayan Odoo dengan perintah:

1. Hidupkan pilihan 'Amazon S3 Sync' (Cloud Storage > Konfigurasi > Konfigurasi). Add-on pilihan Amazon S3 Odoo Integration diperlukan
2. Buka Konsol Amazon S3: https://console.aws.amazon.com/s3/
3. Cipta bucket baharu atau pilih yang sedia ada. Salin nama bucket yang tepat: ia hendaklah dimasukkan dalam Odoo ke medan 'Bucket'
4. Buka butiran bucket dan salin AWS Region-nya. Masukkan dalam Odoo ke medan 'Region' (contohnya, eu-west-1 atau us-east-1)
5. Buka Konsol AWS IAM: https://console.aws.amazon.com/iam/
6. Cipta pengguna IAM baharu atau pilih pengguna teknikal sedia ada. Pengguna ini patut ada hak penuh untuk senaraikan, baca, cipta, tulis, salin dan padam objek dalam bucket dipilih. Anda boleh pilih admin hak penuh, atau cipta dasar baharu (lihat di bawah)
7. Dalam borang pengguna IAM, buka tab 'Security credentials' dan tekan 'Create access key'
8. Pada halaman 'Access key best practices & alternatives', pilih Application running outside AWS. Ini pilihan yang betul apabila pelayan Odoo menyambung ke S3 dengan kunci akses dari luar AWS, dari Odoo.sh, dari pelayan anda, atau pembekal hos lain. Jika Odoo dipasang pada instans AWS EC2, anda boleh pilih Application running on an AWS compute service, tetapi medan yang disalin ke Odoo adalah sama
9. Tekan 'Next'. Pada langkah seterusnya, secara pilihan masukkan teg perihalan seperti Odoo S3 Sync, kemudian tekan 'Create access key'
10. Pada halaman AWS terakhir, salin Access key atau Access key ID ke medan Odoo 'Access Key'
11. Salin Secret access key ke medan Odoo 'Secret Key'. Penting: AWS tunjuk kunci rahsia sekali sahaja, jadi simpan sebelum tutup tetingkap
12. Jika anda guna pembekal serasi S3 selain AWS S3, salin URL titik akhir dari panel pentadbir pembekal itu lalu masukkan ke Odoo dalam medan 'Amazon S3 endpoint URL'. Contohnya MinIO kerap guna URL seperti https://minio.example.com atau http://localhost:9000; LocalStack biasanya http://localhost:4566
13. Pergi ke Odoo Cloud Storage > Configuration > Cloud Clients dan tekan 'Create'
14. Sebagai rujukan, masukkan nama yang jelas kepada semua pengguna
15. Sebagai klien Cloud, pilih 'Amazon S3'
16. Sebagai nama Root folder, masukkan tajuk yang akan digunakan sebagai S3 prefix induk untuk semua folder tersegerak. Contohnya, 'Odoo' atau 'OdooERP'
17. Isikan medan 'Bucket', 'Region', 'Access Key', 'Secret Key', dan jika perlu 'Amazon S3 endpoint URL' serta gaya pengalamatan
18. Pilih sama ada Odoo patut menggunakan URL presigned sementara atau URL bucket/CDN awam. Untuk bucket peribadi, kekalkan URL presigned dihidupkan dan tetapkan hayatnya dalam saat
19. Tekan 'Confirm'. Odoo menyemak akses bucket lalu mencipta atau mengesahkan awalan folder akar. Penyegerakan Amazon S3 - Odoo sedia dilakukan
20. Gunakan cloud client baharu pada peraturan folder dan/atau folder manual yang perlu disegerakkan dengan baldi Amazon S3 itu
21. Tunggu kerja berjadual segerak dimulakan. Untuk tujuan ujian sahaja: picu integrasi secara manual dari Cloud Storage > Konfigurasi > Konfigurasi > butang 'Launch sync'.

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

Contoh dasar bucket

Amazon S3 mempunyai keistimewaan penting: URL yang dipaparkan dalam Odoo sentiasa pautan pihak Amazon.

Jika Use Public URLs diaktifkan, Odoo menyimpan URL objek S3 terus. Pautan ini hanya berfungsi jika bucket, awalan, objek, CDN atau titik akhir serasi berkaitan boleh dibaca awam. Jika tidak, Amazon S3 akan tunjuk AccessDenied, walaupun pengguna dilog masuk ke konsol AWS.

Untuk pautan awam, konfigurasi kebenaran baldi dalam Amazon S3 dan benarkan baca awam untuk awalan Odoo. Contoh dasar baldi:

{
  "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 sebenar dan Odoo/ dengan awalan folder akar yang dipilih. Pastikan juga tetapan Amazon S3 Block public access tidak menyekat dasar bucket itu.

Jika Use Public URLs dilumpuhkan, Odoo menyimpan pautan AWS Console ke objek atau awalan bucket berkaitan. Pautan sedemikian berguna untuk pengguna Amazon: orang yang membuka mesti dilog masuk ke AWS dan mempunyai akses IAM ke objek itu. Jika pengguna tiada akses AWS, Amazon tidak akan membuka fail.

1. Sediakan pelayan MinIO yang sedang berjalan
2. Buka Konsol MinIO
3. Cipta bucket baharu atau pilih yang sedia ada. Salin nama bucket yang tepat: ia hendaklah dimasukkan dalam Odoo ke medan 'Bucket'
4. Cipta kelayakan akses untuk Odoo. Dalam MinIO, guna pasangan access key / secret key atau akaun perkhidmatan yang mempunyai hak untuk menyenarai, baca, cipta, tulis, salin dan padam objek dalam bucket yang dipilih
5. Salin MinIO Access Key ke medan Odoo 'Access Key'
6. Salin MinIO Secret Key ke medan Odoo 'Secret Key'. Penting: simpan rahsia sebelum tutup halaman MinIO jika MinIO tunjukkannya sekali sahaja
7. Salin URL hujung API S3 MinIO ke Odoo ke medan 'Amazon S3 endpoint URL'. Contohnya, pelayan setempat biasanya guna http://localhost:9000, manakala pelayan pengeluaran mungkin guna https://minio.example.com
8. Pergi ke Odoo Cloud Storage > Configuration > Cloud Clients dan tekan 'Create'
9. Sebagai rujukan, masukkan nama yang jelas kepada semua pengguna
10. Sebagai klien Cloud, pilih 'MinIO'
11. Sebagai nama Root folder, masukkan tajuk yang akan digunakan sebagai MinIO object prefix induk untuk semua folder tersegerak. Contohnya, 'Odoo' atau 'OdooERP'
12. Isikan medan 'Bucket', 'Access Key', 'Secret Key' dan 'Amazon S3 endpoint URL'. Medan 'Region' adalah pilihan untuk MinIO; jika kosong, Odoo menggunakan us-east-1 untuk tandatangan serasi S3
13. Kekalkan gaya pengalamatan sebagai Path-style. Ini pilihan yang disyorkan untuk endpoint MinIO, terutamanya apabila hos MinIO tidak menyediakan nama DNS khusus bucket
14. Pilih sama ada Odoo patut menggunakan URL MinIO awam terus. Hidupkan «Use Public URLs» hanya apabila bucket, prefiks, proksi songsang atau CDN boleh dibaca secara awam. Untuk bucket MinIO peribadi, biarkan dimatikan
15. Tekan 'Confirm'. Odoo menyemak akses bucket lalu mencipta atau mengesahkan awalan folder akar. Penyegerakan MinIO - Odoo sedia dilakukan
16. Gunakan cloud client baharu pada peraturan folder dan/atau folder manual yang perlu disegerakkan dengan baldi MinIO itu
17. Tunggu kerja berjadual segerak dimulakan. Untuk tujuan ujian sahaja: picu integrasi secara manual dari Cloud Storage > Konfigurasi > Konfigurasi > butang 'Launch sync'.

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