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 > Yapılandırma > Yapılandırma). İ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 (örneğin 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ının seçili bucket içinde nesneleri listeleme, okuma, oluşturma, yazma, kopyalama ve silme için tam haklara sahip olması gerekir. Tam yetkili yöneticiyi 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ırma sağlayıcısından erişim anahtarıyla S3'e bağlandığında doğru seçenek budur. 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ı olarak 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, bu yüzden pencereyi kapatmadan kaydedin
12. AWS S3 yerine S3 uyumlu bir sağlayıcı kullanıyorsanız uç nokta URL'sini o sağlayıcının yönetim panelinden kopyalayıp Odoo'da 'Amazon S3 endpoint URL' alanına yazın. Örneğin MinIO çoğu zaman https://minio.example.com veya http://localhost:9000 kullanır; LocalStack genellikle http://localhost:4566 kullanır
13. Odoo Cloud Storage > Yapılandırma > Cloud Clients yoluna 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 senkronize 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 adresleme stili alanlarını doldurun
18. Odoo'nun geçici ön imzalı URL mü yoksa genel bucket/CDN URL mü kullanacağını seçin. Özel bucket'larda ön imzalı 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 yapılmaya hazırdır
20. Yeni oluşturulan bulut istemcisini, 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 > Yapılandırma > Yapılandırma > '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 bir S3 nesne URL'si kaydeder. Bu bağlantı yalnızca ilgili S3 bucket, önek, nesne, CDN veya uyumlu uç nokta herkese açık okunabilirse ç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 nesnesine veya önekine AWS Console bağlantıları kaydeder. Bu bağlantılar Amazon kullanıcıları için yararlıdır: bağlantıyı açan kişi AWS'te oturum açmış olmalı ve o bucket nesnesine IAM erişimine sahip olmalıdır. Kullanıcının 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 nesneleri listeleme, okuma, oluşturma, yazma, kopyalama ve silme haklarına sahip 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 gizli anahtarı yalnızca bir kez gösteriyorsa, MinIO sayfasını kapatmadan önce kaydedin
7. MinIO S3 API uç nokta URL'sini Odoo'daki 'Amazon S3 endpoint URL' alanına kopyalayın. Örneğin yerel sunucu genellikle http://localhost:9000 kullanır, üretim sunucusu ise https://minio.example.com kullanabilir
8. Odoo Cloud Storage > Yapılandırma > Cloud Clients yoluna gidin ve 'Create'e basın
9. Referans olarak tüm kullanıcılara açık bir ad girin
10. Bulut istemcisi olarak 'MinIO' seçin
11. Kök klasör adı olarak, tüm senkronize klasörler için ü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. 'Region' alanı MinIO için 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. Bu, MinIO uç noktaları için önerilen seçenektir; özellikle MinIO sunucusu bucketa özel DNS adları sağlamıyorsa
14. Odoo'nun doğrudan genel MinIO URL'leri kullanıp kullanmayacağını seçin. 'Use Public URLs' seçeneğini yalnızca bucket, önek, reverse proxy veya CDN herkese açık okunabiliyorsa 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 yapılmaya hazırdır
16. Yeni oluşturulan bulut istemcisini, bu MinIO bucket ile senkronize edilecek klasör kurallarına ve/veya manuel klasörlere uygulayın
17. Zamanlanmış senkron işinin başlamasını bekleyin. Yalnızca test için: entegrasyonu Cloud Storage > Yapılandırma > Yapılandırma > '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.