Amazon S3 / MinIO Odoo Integration v.19

A ferramenta depende da biblioteca externa 'boto3'. Instale-a no servidor Odoo com o comando:

1. Ative a opção 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). É necessário o extra opcional Amazon S3 Odoo Integration
2. Abra a Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Crie um novo bucket ou escolha um existente. Copie o nome exato do bucket: deve ser inserido no Odoo no campo 'Bucket'
4. Abra os detalhes do bucket e copie a AWS Region. Insira-a no Odoo no campo 'Region' (por exemplo, eu-west-1 ou us-east-1)
5. Abra a AWS IAM Console: https://console.aws.amazon.com/iam/
6. Crie um novo usuario IAM ou escolha um usuario técnico existente. Este usuario deve ter direitos completos para listar, ler, criar, escrever, copiar e eliminar objetos no bucket selecionado. Pode selecionar o admin com direitos completos ou criar uma nova política (ver abaixo)
7. No formulário do usuario IAM, abra o separador 'Security credentials' e prima 'Create access key'
8. Na página 'Access key best practices & alternatives', selecione a opção Application running outside AWS. Esta é a opção correta quando o servidor Odoo se liga ao S3 por access key a partir de fora da AWS, do Odoo.sh, do seu próprio servidor ou de outro fornecedor de alojamento. Se o Odoo estiver instalado numa instância AWS EC2, pode em vez disso selecionar Application running on an AWS compute service, mas os campos copiados para o Odoo são os mesmos
9. Prima 'Next'. No passo seguinte, introduza opcionalmente uma etiqueta de descrição como Odoo S3 Sync e depois prima 'Create access key'
10. Na página final da AWS, copie Access key ou Access key ID para o campo Odoo 'Access Key'
11. Copie Secret access key para o campo Odoo 'Secret Key'. Importante: a AWS mostra a secret key apenas uma vez, por isso guarde-a antes de fechar a janela
12. Se usar um fornecedor compatível com S3 em vez de AWS S3, copie o URL do endpoint no painel de administração desse fornecedor e insira-o no Odoo no campo 'Amazon S3 endpoint URL'. Por exemplo, o MinIO usa frequentemente um URL como https://minio.example.com ou http://localhost:9000; o LocalStack usa normalmente http://localhost:4566
13. Vá a Odoo Cloud Storage > Configuration > Cloud Clients e prima 'Create'
14. Como referência, introduza qualquer nome que fique claro para todos os usuarios
15. Como Cloud client, escolha 'Amazon S3'
16. Como Root folder name, introduza um título que será usado como prefixo S3 pai de todas as pastas sincronizadas. Por exemplo, 'Odoo' ou 'OdooERP'
17. Preencha os campos 'Bucket', 'Region', 'Access Key', 'Secret Key' e, se necessário, 'Amazon S3 endpoint URL' e o estilo de addressing
18. Escolha se o Odoo deve usar URLs presigned temporários ou URLs públicos de bucket/CDN. Para buckets privados, mantenha os URLs presigned ativos e defina o tempo de vida em segundos
19. Prima 'Confirm'. O Odoo verifica o acesso ao bucket e cria ou confirma o prefixo da pasta raiz. A sincronização Amazon S3 - Odoo está pronta a ser feita
20. Aplique o cliente cloud recém-criado às regras de pastas e/ou pastas manuais que devem ser sincronizadas com esse bucket Amazon S3
21. Aguarde que o trabalho agendado de sync seja iniciado. Apenas para fins de teste: dispare a integração manualmente em Cloud Storage > Configuration > Configuration > o botão 'Launch sync'.

Documentação AWS útil: criar um bucket S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, gestão de chaves de acesso IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Exemplo de política de bucket

A Amazon S3 tem uma peculiaridade importante: o URL mostrado no Odoo é sempre uma ligação do lado da Amazon.

Se Use Public URLs estiver ativo, o Odoo guarda um URL direto do objeto S3. A ligação só funciona se o bucket, prefixo, objeto, CDN ou endpoint compatível for publicamente legível. Caso contrário a Amazon S3 mostra AccessDenied, mesmo com sessão na consola AWS.

Para ligações públicas, configure as permissões do bucket na Amazon S3 e permita leitura pública do prefixo Odoo. Exemplo de política de bucket:

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

Substitua YOUR_BUCKET_NAME pelo nome real do bucket e Odoo/ pelo prefixo da pasta raiz escolhido. Confirme também que as definições Amazon S3 Block public access não bloqueiam essa política.

Se Use Public URLs estiver desativado, o Odoo guarda ligações da AWS Console para o objeto ou prefixo do bucket. São úteis para usuarios Amazon: quem abre a ligação deve ter sessão na AWS e acesso IAM a esse objeto. Sem acesso AWS, a Amazon não abre o arquivo.

1. Prepare um servidor MinIO em execução
2. Abra a MinIO Console
3. Crie um novo bucket ou escolha um existente. Copie o nome exato do bucket: deve ser inserido no Odoo no campo 'Bucket'
4. Crie credenciais de acesso para o Odoo. No MinIO, use um par access key / secret key ou uma conta de serviço com direitos para listar, ler, criar, escrever, copiar e eliminar objetos no bucket selecionado
5. Copie a MinIO Access Key para o campo Odoo 'Access Key'
6. Copie a MinIO Secret Key para o campo Odoo 'Secret Key'. Importante: guarde o secret antes de fechar a página MinIO se o MinIO o mostrar apenas uma vez
7. Copie o URL do endpoint da API S3 MinIO para o Odoo no campo 'Amazon S3 endpoint URL'. Por exemplo, um servidor local usa normalmente http://localhost:9000, enquanto um servidor de produção pode usar https://minio.example.com
8. Vá a Odoo Cloud Storage > Configuration > Cloud Clients e prima 'Create'
9. Como referência, introduza qualquer nome que fique claro para todos os usuarios
10. Como Cloud client, escolha 'MinIO'
11. Como Root folder name, introduza um título que será usado como prefixo de objeto MinIO pai de todas as pastas sincronizadas. Por exemplo, 'Odoo' ou 'OdooERP'
12. Preencha os campos 'Bucket', 'Access Key', 'Secret Key' e 'Amazon S3 endpoint URL'. O campo 'Region' é opcional para MinIO; se estiver vazio, o Odoo usa us-east-1 para a assinatura compatível com S3
13. Mantenha o estilo de addressing como Path-style. Esta é a opção recomendada para endpoints MinIO, especialmente quando o anfitrião MinIO não fornece nomes DNS específicos do bucket
14. Escolha se o Odoo deve usar URLs MinIO públicos diretos. Ative 'Use Public URLs' apenas quando o bucket, o prefixo, o reverse proxy ou a CDN forem publicamente legíveis. Para buckets MinIO privados, deixe desativado
15. Prima 'Confirm'. O Odoo verifica o acesso ao bucket e cria ou confirma o prefixo da pasta raiz. A sincronização MinIO - Odoo está pronta a ser feita
16. Aplique o cliente cloud recém-criado às regras de pastas e/ou pastas manuais que devem ser sincronizadas com esse bucket MinIO
17. Aguarde que o trabalho agendado de sync seja iniciado. Apenas para fins de teste: dispare a integração manualmente em Cloud Storage > Configuration > Configuration > o botão 'Launch sync'.

Documentação MinIO útil: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.