Amazon S3 / MinIO Odoo Integration v.19

도구는 외부 라이브러리 'boto3'에 의존합니다. Odoo 서버에 다음 명령으로 설치하세요:

1. 옵션 'Amazon S3 Sync'을(를) 켜세요 (Cloud Storage > 구성 > 구성). 선택 추가 모듈 Amazon S3 Odoo Integration이(가) 필요합니다
2. Amazon S3 콘솔 열기: https://console.aws.amazon.com/s3/
3. 새 버킷을 만들거나 기존 버킷을 선택하세요. 정확한 버킷 이름을 복사해 Odoo의 'Bucket' 필드에 넣어야 합니다
4. 버킷 세부정보를 열고 AWS Region을 복사하세요. Odoo의 'Region' 필드에 넣습니다(예: eu-west-1 또는 us-east-1)
5. AWS IAM 콘솔 열기: https://console.aws.amazon.com/iam/
6. 새 IAM 사용자를 만들거나 기존 기술 사용자를 고르세요. 이 사용자는 선택한 버킷에서 개체를 나열, 읽기, 만들기, 쓰기, 복사, 삭제할 전체 권한이 있어야 합니다. 전체 권한 관리자를 고르거나 새 정책을 만들 수 있습니다(아래 참조)
7. IAM 사용자 양식에서 탭 'Security credentials'를 열고 'Create access key'를 누릅니다
8. 페이지 'Access key best practices & alternatives'에서 Application running outside AWS를 선택하세요. Odoo 서버가 AWS 밖, Odoo.sh, 자체 서버 또는 다른 호스팅에서 액세스 키로 S3에 연결할 때 올바른 옵션입니다. Odoo가 AWS EC2 인스턴스에 있으면 Application running on an AWS compute service를 선택할 수 있지만 Odoo로 복사되는 필드는 같습니다
9. 'Next'를 누르세요. 다음 단계에서 선택적으로 Odoo S3 Sync 같은 설명 태그를 입력한 뒤 'Create access key'를 누르세요
10. 마지막 AWS 페이지에서 Access key 또는 Access key ID를 Odoo 필드 'Access Key'에 복사하세요
11. Secret access key를 Odoo 필드 'Secret Key'에 복사하세요. 중요: AWS는 비밀 키를 한 번만 보여 주므로 창을 닫기 전에 저장하세요
12. AWS S3 대신 S3 호환 공급자를 쓰면 해당 공급자 관리 패널에서 엔드포인트 URL을 복사해 Odoo의 'Amazon S3 endpoint URL' 필드에 넣으세요. 예: MinIO는 종종 https://minio.example.com 또는 http://localhost:9000; LocalStack은 보통 http://localhost:4566
13. Odoo Cloud Storage > Configuration > Cloud Clients로 이동한 뒤 'Create'를 누릅니다
14. 참조에는 모든 사용자가 알아볼 이름을 입력하세요
15. Cloud 클라이언트로 'Amazon S3'를 선택
16. Root folder 이름으로 동기화된 모든 폴더의 상위 S3 prefix로 쓸 제목을 입력하세요. 예: 'Odoo' 또는 'OdooERP'
17. 필드 'Bucket', 'Region', 'Access Key', 'Secret Key'를 채우고, 필요하면 'Amazon S3 endpoint URL'과 주소 지정 스타일도 입력하세요
18. Odoo가 임시 presigned URL을 쓸지 공개 버킷/CDN URL을 쓸지 선택하세요. 비공개 버킷은 presigned URL을 켜 두고 수명을 초 단위로 설정하세요
19. 'Confirm'을 누르세요. Odoo가 bucket 접근을 확인하고 루트 폴더 접두사를 만들거나 검증합니다. Amazon S3 - Odoo 동기화를 할 준비가 되었습니다
20. 새로 만든 cloud client를 해당 Amazon S3 버킷와(과) 동기화할 폴더 규칙 및/또는 수동 폴더에 적용하세요
21. 동기화 예약 작업이 시작될 때까지 기다리세요. 테스트 전용: Cloud Storage > 환경설정 > 환경설정 > 'Launch sync' 버튼에서 통합을 수동으로 실행합니다.

유용한 AWS 문서: S3 버킷 만들기: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM 액세스 키 관리: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

버킷 정책 예시

Amazon S3에는 중요한 특성이 있습니다. Odoo에 표시되는 URL은 항상 Amazon 쪽 링크입니다.

Use Public URLs가 켜져 있으면 Odoo는 직접 S3 객체 URL을 저장합니다. 관련 S3 버킷, 접두사, 객체, CDN 또는 호환 엔드포인트가 공개 읽기 가능할 때만 작동합니다. 그렇지 않으면 AWS 콘솔에 로그인한 상태여도 Amazon S3가 AccessDenied를 표시합니다.

공개 링크는 Amazon S3에서 버킷 권한을 설정하고 Odoo 접두사에 공개 읽기를 허용하세요. 버킷 정책 예:

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

YOUR_BUCKET_NAME을 실제 버킷 이름으로, Odoo/를 선택한 루트 폴더 접두사로 바꾸세요. Amazon S3 Block public access 설정이 해당 버킷 정책을 막지 않는지도 확인하세요.

Use Public URLs가 꺼져 있으면 Odoo는 관련 버킷 객체 또는 접두사에 대한 AWS Console 링크를 저장합니다. 이런 링크는 Amazon 사용자에게 유용합니다. 여는 사람은 AWS에 로그인되어 있어야 하고 해당 객체에 IAM 접근이 있어야 합니다. AWS 접근이 없으면 Amazon이 파일을 열지 않습니다.

1. 실행 중인 MinIO 서버를 준비합니다
2. MinIO 콘솔 열기
3. 새 버킷을 만들거나 기존 버킷을 선택하세요. 정확한 버킷 이름을 복사해 Odoo의 'Bucket' 필드에 넣어야 합니다
4. Odoo용 액세스 자격 증명을 만드세요. MinIO에서는 선택한 버킷에서 객체를 나열, 읽기, 만들기, 쓰기, 복사, 삭제할 권한이 있는 access key / secret key 쌍 또는 서비스 계정을 사용하세요
5. MinIO Access Key를 Odoo 필드 'Access Key'에 복사하세요
6. MinIO Secret Key를 Odoo 필드 'Secret Key'에 복사하세요. 중요: MinIO가 한 번만 보여 주면 MinIO 페이지를 닫기 전에 비밀을 저장하세요
7. MinIO S3 API 엔드포인트 URL을 Odoo의 'Amazon S3 endpoint URL' 필드에 복사하세요. 예를 들어 로컬 서버는 보통 http://localhost:9000을, 프로덕션 서버는 https://minio.example.com을 쓸 수 있습니다
8. Odoo Cloud Storage > Configuration > Cloud Clients로 이동한 뒤 'Create'를 누릅니다
9. 참조에는 모든 사용자가 알아볼 이름을 입력하세요
10. Cloud 클라이언트로 'MinIO'를 선택
11. Root folder 이름으로 동기화된 모든 폴더의 상위 MinIO object prefix로 쓸 제목을 입력하세요. 예: 'Odoo' 또는 'OdooERP'
12. 'Bucket', 'Access Key', 'Secret Key', 'Amazon S3 endpoint URL' 필드를 입력하세요. 'Region'은 MinIO에서 선택 사항이며 비어 있으면 Odoo가 S3 호환 서명에 us-east-1을 사용합니다
13. 주소 지정 스타일을 Path-style로 유지하세요. MinIO 엔드포인트에 권장되며, 특히 MinIO 호스트가 버킷별 DNS 이름을 제공하지 않을 때 그렇습니다
14. Odoo가 직접 공개 MinIO URL을 사용할지 선택하세요. 버킷, 접두사, 리버스 프록시 또는 CDN이 공개 읽기 가능할 때만 «Use Public URLs»를 켜세요. 비공개 MinIO 버킷은 꺼 두세요
15. 'Confirm'을 누르세요. Odoo가 bucket 접근을 확인하고 루트 폴더 접두사를 만들거나 검증합니다. MinIO - Odoo 동기화를 할 준비가 되었습니다
16. 새로 만든 cloud client를 해당 MinIO 버킷와(과) 동기화할 폴더 규칙 및/또는 수동 폴더에 적용하세요
17. 동기화 예약 작업이 시작될 때까지 기다리세요. 테스트 전용: Cloud Storage > 환경설정 > 환경설정 > 'Launch sync' 버튼에서 통합을 수동으로 실행합니다.

유용한 MinIO 문서: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.