Amazon S3 / MinIO Odoo Integration v.19

Araç harici 'boto3' kütüphanesine bağlıdır. Odoo sunucunuz için şu komutla kurun:

1. 'Amazon S3 Sync' seçeneğini açın (Cloud Storage > Configuration > Configuration). İsteğe bağlı eklenti Amazon S3 Odoo Integration gerekir
2. Amazon S3 Console'u açın: https://console.aws.amazon.com/s3/
3. Yeni bir bucket oluşturun veya mevcut olanı seçin. Tam bucket adını kopyalayın: Odoo'da 'Bucket' alanına yazılmalıdır
4. Bucket ayrıntılarını açın ve AWS Region'ı kopyalayın. Odoo'da 'Region' alanına yazın (ör. eu-west-1 veya us-east-1)
5. AWS IAM Console'u açın: https://console.aws.amazon.com/iam/
6. Yeni bir IAM kullanıcısı oluşturun veya mevcut teknik kullanıcıyı seçin. Bu kullanıcı seçili bucket içinde nesneleri listeleme, okuma, oluşturma, yazma, kopyalama ve silme için tam yetkiye sahip olmalıdır. Tam yetkili admin seçebilir veya yeni bir politika oluşturabilirsiniz (aşağıya bakın)
7. IAM kullanıcı formunda 'Security credentials' sekmesini açın ve 'Create access key'e basın
8. 'Access key best practices & alternatives' sayfasında Application running outside AWS seçin. Odoo sunucunuz AWS dışından, Odoo.sh'ten, kendi sunucunuzdan veya başka bir barındırıcıdan erişim anahtarıyla S3'e bağlanıyorsa bu doğrudur. Odoo bir AWS EC2 örneğindeyse Application running on an AWS compute service seçebilirsiniz; Odoo'ya kopyalanan alanlar aynıdır
9. 'Next'e basın. Sonraki adımda isteğe bağlı Odoo S3 Sync gibi bir açıklama etiketi girin, sonra 'Create access key'e basın
10. Son AWS sayfasında Access key veya Access key ID değerini Odoo alanı 'Access Key'e kopyalayın
11. Secret access key değerini Odoo alanı 'Secret Key'e kopyalayın. Önemli: AWS gizli anahtarı yalnızca bir kez gösterir; pencereyi kapatmadan kaydedin
12. AWS S3 yerine S3 uyumlu bir sağlayıcı kullanıyorsanız endpoint URL'yi o panelden kopyalayıp Odoo alanı 'Amazon S3 endpoint URL'e yazın. MinIO çoğu zaman https://minio.example.com veya http://localhost:9000; LocalStack genelde http://localhost:4566 kullanır
13. Odoo Cloud Storage > Configuration > Cloud Clients'a gidin ve 'Create'e basın
14. Referans olarak tüm kullanıcılara açık bir ad girin
15. Cloud client olarak 'Amazon S3' seçin
16. Root folder name olarak tüm senkron klasörlerin üst S3 öneki olacak bir başlık girin. Örneğin 'Odoo' veya 'OdooERP'
17. 'Bucket', 'Region', 'Access Key', 'Secret Key' ve gerekirse 'Amazon S3 endpoint URL' ile addressing style alanlarını doldurun
18. Odoo'nun geçici presigned URL mü yoksa genel bucket/CDN URL mü kullanacağını seçin. Özel bucket'larda presigned URL'leri açık tutun ve ömrü saniye cinsinden ayarlayın
19. 'Confirm'e basın. Odoo bucket erişimini kontrol eder ve kök klasör önekini oluşturur veya doğrular. Amazon S3 - Odoo senkronizasyonu hazırdır
20. Yeni oluşturulan cloud client'ı o Amazon S3 bucket'ına senkron edilecek klasör kurallarına ve/veya elle klasörlere uygulayın
21. Zamanlanmış senkron işinin başlamasını bekleyin. Yalnızca test için: entegrasyonu Cloud Storage > Configuration > Configuration > 'Launch sync' düğmesinden elle tetikleyin.

Yararlı AWS belgesi: S3 bucket oluşturma: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM erişim anahtarlarını yönetme: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Bucket politikası örneği

Amazon S3'ün önemli bir özelliği vardır: Odoo'da gösterilen URL her zaman Amazon tarafı bir bağlantıdır.

Use Public URLs açıksa Odoo doğrudan S3 nesne URL'si kaydeder. Bu bağlantı yalnızca ilgili S3 bucket, önek, nesne, CDN veya uyumlu endpoint herkese açıksa çalışır. Aksi halde kullanıcı AWS konsolunda oturum açmış olsa bile Amazon S3 AccessDenied gösterir.

Genel bağlantılar için Amazon S3'te bucket izinlerini yapılandırın ve Odoo öneki için herkese açık okuma verin. Örnek bucket politikası:

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

YOUR_BUCKET_NAME yerine gerçek bucket adını, Odoo/ yerine seçilen kök klasör önekini yazın. Amazon S3 Block public access ayarlarının bu bucket politikasını engellemediğinden emin olun.

Use Public URLs kapalıysa Odoo ilgili bucket nesnesi veya öneki için AWS Console bağlantıları kaydeder. Bu bağlantılar Amazon kullanıcıları içindir: açan kişi AWS'te oturum açmış ve o nesneye IAM erişimine sahip olmalıdır. AWS erişimi yoksa Amazon dosyayı açmaz.

1. Çalışan bir MinIO sunucusu hazırlayın
2. MinIO Console'u açın
3. Yeni bir bucket oluşturun veya mevcut olanı seçin. Tam bucket adını kopyalayın: Odoo'da 'Bucket' alanına yazılmalıdır
4. Odoo için erişim kimlik bilgileri oluşturun. MinIO'da seçili bucket içinde listeleme, okuma, oluşturma, yazma, kopyalama ve silme yetkili bir access key / secret key çifti veya hizmet hesabı kullanın
5. MinIO Access Key değerini Odoo alanı 'Access Key'e kopyalayın
6. MinIO Secret Key değerini Odoo alanı 'Secret Key'e kopyalayın. Önemli: MinIO sırrı yalnızca bir kez gösteriyorsa sayfayı kapatmadan kaydedin
7. MinIO S3 API endpoint URL'sini Odoo alanı 'Amazon S3 endpoint URL'e kopyalayın. Yerel sunucu genelde http://localhost:9000, üretim https://minio.example.com kullanabilir
8. Odoo Cloud Storage > Configuration > Cloud Clients'a gidin ve 'Create'e basın
9. Referans olarak tüm kullanıcılara açık bir ad girin
10. Cloud client olarak 'MinIO' seçin
11. Root folder name olarak tüm senkron klasörlerin üst MinIO nesne öneki olacak bir başlık girin. Örneğin 'Odoo' veya 'OdooERP'
12. 'Bucket', 'Access Key', 'Secret Key' ve 'Amazon S3 endpoint URL' alanlarını doldurun. MinIO için 'Region' isteğe bağlıdır; boşsa Odoo S3 uyumlu imza için us-east-1 kullanır
13. Adresleme stilini Path-style olarak bırakın. MinIO endpoint'leri için önerilen seçenektir, özellikle MinIO ana bilgisayarı bucket'a özel DNS adları vermiyorsa
14. Odoo'nun doğrudan genel MinIO URL kullanıp kullanmayacağını seçin. 'Use Public URLs' yalnızca bucket, önek, reverse proxy veya CDN herkese açıksa açın. Özel MinIO bucket'larında kapalı bırakın
15. 'Confirm'e basın. Odoo bucket erişimini kontrol eder ve kök klasör önekini oluşturur veya doğrular. MinIO - Odoo senkronizasyonu hazırdır
16. Yeni cloud client'ı o MinIO bucket'ına senkron edilecek klasör kurallarına ve/veya elle klasörlere uygulayın
17. Zamanlanmış senkron işinin başlamasını bekleyin. Yalnızca test için: entegrasyonu Cloud Storage > Configuration > Configuration > 'Launch sync' düğmesinden elle tetikleyin.

Yararlı MinIO belgesi: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.