Em resumo
Amazon S3 / MinIO Odoo Integration e uma aplicacao Odoo 19 de Gestao documental. A ferramenta para sincronizar anexos Odoo com Amazon S3 e/ou MinIO nos dois sentidos.
Amazon S3 / MinIO Odoo Integration liga Cloud Storage Solutions ao armazenamento de objetos compatível com S3. Sincroniza pastas e anexos Odoo com buckets Amazon S3 ou MinIO nos dois sentidos e permite aos utilizadores Odoo aceder a objetos via ligações presigned ou públicas.
Ideal para
Equipas de armazenamento de objetos
Use buckets Amazon S3 ou compatíveis com S3 como backend de armazenamento dos anexos e árvores de pastas Odoo.
MinIO e armazenamento compatível com S3
Ligue o Odoo ao MinIO ou a outros ambientes compatíveis com S3 quando preferir armazenamento de objetos auto-alojado.
Acesso controlado a objetos
Escolha ligações de objeto presigned ou públicas para o Odoo abrir ficheiros sincronizados segundo a política de acesso do bucket.
Porque as equipas o escolhem
Principais vantagens antes dos detalhes
Buckets Amazon S3
Guarde anexos e pastas Odoo sincronizados em buckets Amazon S3 enquanto o Odoo mantém o contexto de negócio.
Compatibilidade MinIO
Use MinIO ou armazenamento compatível com S3 quando a infraestrutura precisar de um backend de objetos auto-alojado.
Caminhos de objeto guiados pelo Odoo
Gere caminhos de objeto do bucket a partir de regras de pasta Odoo, pastas manuais e caixas de anexos do registo.
Sincronização bilateral
Envie anexos Odoo para armazenamento compatível com S3 e reflita os objetos na nuvem de volta no Odoo.
URL presigned ou públicas
Abra objetos sincronizados através de ligações presigned ou públicas conforme a política do bucket e as definições do conector.
Registos e recuperação
Monitorize trabalhos de sincronização S3/MinIO, novas tentativas e sincronização inversa a partir dos registos Odoo.
Como funciona a sincronização Amazon S3 / MinIO
A sincronização agendada mantém alinhadas as pastas Odoo e os objetos de buckets compatíveis com S3.
Do Odoo para armazenamento compatível com S3
- A sincronização direta cria caminhos de objeto do bucket e carrega anexos a partir de pastas Odoo sincronizadas.
- Os binários sincronizados tornam-se anexos URL no Odoo, reduzindo o uso do filestore Odoo.
- Os trabalhos da fila processam alterações Amazon S3 e MinIO com registos para administradores.
Dos buckets de volta ao Odoo
- A sincronização inversa cria anexos URL Odoo e subpastas para novos objetos do bucket.
- Atualizações, movimentos e eliminações no armazenamento compatível com S3 refletem-se nas pastas Odoo ligadas quando possível.
- A sincronização inversa pode trazer ficheiros de volta ao Odoo quando uma ligação S3 ou MinIO é reposta ou alterada.
URL Amazon S3 / MinIO
Abra objetos de bucket sincronizados a partir do Odoo no modo de ligação que corresponde à política de armazenamento.
Ligações de objeto presigned
- Use URL presigned quando os objetos do bucket devam permanecer privados mas abrir a partir do Odoo.
- A geração de ligações segue a configuração do cliente compatível com S3 e a política de expiração.
- Este modo é útil para acesso controlado sem expor os objetos do bucket globalmente.
Ligações de objeto públicas
- Use ligações públicas quando a política do bucket expuser intencionalmente os objetos sincronizados.
- O Odoo mantém o contexto de registo, pasta e anexo mesmo quando o acesso ao objeto é controlado pela política S3.
- Os administradores gerem credenciais do bucket, âmbito de sincronização e registos nas definições Cloud Storage.
Pronto para avaliar?
Comece com um pedido de demo gratuito ou compre na Odoo Apps Store.
Base de demonstração personalizada gratuita. Sem telefone nem cartão. Atualizações gratuitas vitalícias e apoio especializado na versão major do Odoo.
Sugestões de configuração e instalação para Amazon S3 / MinIO Odoo Integration Odoo v.19
Dependência Python
A ferramenta depende da biblioteca externa 'boto3'. Instale-a no servidor Odoo com o comando:
pip3 install boto3Configuração Amazon S3 e início de sessão
- Ative a opção 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). É necessário o extra opcional Amazon S3 Odoo Integration
- Abra a Amazon S3 Console: https://console.aws.amazon.com/s3/
- Crie um novo bucket ou escolha um existente. Copie o nome exato do bucket: deve ser inserido no Odoo no campo 'Bucket'
- 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)
- Abra a AWS IAM Console: https://console.aws.amazon.com/iam/
- Crie um novo utilizador IAM ou escolha um utilizador técnico existente. Este utilizador 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)
- No formulário do utilizador IAM, abra o separador 'Security credentials' e prima 'Create access key'
- 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
- Prima 'Next'. No passo seguinte, introduza opcionalmente uma etiqueta de descrição como Odoo S3 Sync e depois prima 'Create access key'
- Na página final da AWS, copie Access key ou Access key ID para o campo Odoo 'Access Key'
- 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
- 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
- Vá a Odoo Cloud Storage > Configuration > Cloud Clients e prima 'Create'
- Como referência, introduza qualquer nome que fique claro para todos os utilizadores
- Como Cloud client, escolha 'Amazon S3'
- 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'
- Preencha os campos 'Bucket', 'Region', 'Access Key', 'Secret Key' e, se necessário, 'Amazon S3 endpoint URL' e o estilo de addressing
- 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
- 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
- Aplique o cliente cloud recém-criado às regras de pastas e/ou pastas manuais que devem ser sincronizadas com esse bucket Amazon S3
- 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
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ListObjectsInBucket",
"Effect": "Allow",
"Action": [
"s3:ListBucket"
],
"Resource": "arn:aws:s3:::NAME_OF_YOUR_BUCKET"
},
{
"Sid": "AllObjectActions",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:DeleteObject"
],
"Resource": "arn:aws:s3:::NAME_OF_YOUR_BUCKET/*"
}
]
}
Create a new AWS IAM user
Specify the IAM user name
Attach permission policies directly
Amazon S3 bucket policy JSON example
Review and name the S3 policy
Select the bucket policy for the user
Review and create the IAM user
Create an access key for the user
Choose the access key use case
Set the access key description tag
Retrieve the access key and secret
Configurar o cliente Amazon S3 no Odoo
URL Amazon S3 e permissões de acesso
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 utilizadores 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 ficheiro.
Configuração MinIO e início de sessão
- Prepare um servidor MinIO em execução
- Abra a MinIO Console
- Crie um novo bucket ou escolha um existente. Copie o nome exato do bucket: deve ser inserido no Odoo no campo 'Bucket'
- 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
- Copie a MinIO Access Key para o campo Odoo 'Access Key'
- 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
- 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
- Vá a Odoo Cloud Storage > Configuration > Cloud Clients e prima 'Create'
- Como referência, introduza qualquer nome que fique claro para todos os utilizadores
- Como Cloud client, escolha 'MinIO'
- 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'
- 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
- 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
- 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
- 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
- Aplique o cliente cloud recém-criado às regras de pastas e/ou pastas manuais que devem ser sincronizadas com esse bucket MinIO
- 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.
Create a MinIO access key
Copy the new MinIO credentials
Configurar o cliente cloud MinIO no Odoo
Perguntas frequentes sobre Amazon S3 / MinIO Odoo Integration Odoo v.19
Onde ficam armazenados os ficheiros sincronizados? São duplicados no Odoo e nas clouds?
A aplicação assume que o conteúdo binário dos anexos fica no Cloud Client e não no servidor Odoo. Esses anexos no Odoo passam a ser do tipo URL e pode aceder-lhes a qualquer momento a partir da caixa de anexos ou do Cloud Client.
Após a configuração, não são necessárias ações manuais: a sincronização é totalmente automática. Decida que tipos de documento Odoo devem ser sincronizados e configure um modelo relacionado para cada um (clientes, encomendas de venda ou compra, tarefas, projetos, etc.).
Posso ter várias pastas para o mesmo tipo de documento? Por exemplo, projetos internos e projetos de clientes?
Sim, pode. Para isso, prepare uma regra para cada uma e aplique filtros: por exemplo, por tipo de projeto.
Torne os filtros mutuamente exclusivos para que um documento seja atribuído de forma inequívoca. Por exemplo: «cliente mas não fornecedor», «fornecedor mas não cliente». Caso contrário, a pasta do documento saltaria de um modelo para outro.
É possível tornar a sincronização em tempo real?
Não. Temos razões fortes para evitar a sincronização em tempo real:
Desempenho. Se a sincronização for em tempo real, cada carregamento de ficheiro mostra o ecrã de espera.
Conflitos. Se 2 utilizadores alterarem um item ao mesmo tempo, a situação pode ficar sem solução. Com trabalhos regulares podemos corrigir depois; em tempo real seria preciso uma fila, ainda mais confusa.
Funcionalidade. Em especial, mudar o nome e reestruturar. A sincronização inversa baseia-se na lógica dos diretórios e em cada sincronização verifica 100 % dos itens. Após cada atualização seriam milhares de pedidos por segundo. Caso contrário, as alterações perder-se-iam.
Posso alterar o nome predefinido das pastas nas clouds?
Pode atribuir o seu nome aos diretórios dos modelos (encomendas de venda, oportunidades, fornecedores, etc.) para qualquer tipo de documento.
Para as pastas de objetos (SO-001, John Smith, etc.), a ferramenta usa o método Odoo que constrói o nome de apresentação. Pode alterá-lo com uma expressão de nome. A sintaxe é a dos modelos de e-mail Odoo.
Posso alterar a frequência dos trabalhos de sincronização?
Não, a partir da versão 15 não deve alterar as ações agendadas. Estão otimizadas para correr a cada 15 minutos e garantir a ligação mais estável e rápida.
Os timeouts do servidor Odoo devem ser de pelo menos 15 minutos (900 segundos).
Para parar a sincronização temporariamente, faça-o no formulário do cliente cloud em causa.
Posso sincronizar anexos com vários clientes cloud
Sim, a partir da versão 15 pode configurar várias ligações. Assim é possível sincronizar algumas pastas com um cliente cloud e outras com outro.
Tenha em conta que não é possível sincronizar a mesma pasta com vários armazenamentos cloud ao mesmo tempo.
Usamos um editor especial nas clouds (p. ex. OnlyOffice, Office 365, etc.). Os ficheiros seriam abertos nesse editor?
Sim, consoante a configuração do seu cliente cloud.
Preciso apenas da aplicação Cloud Storage Solution?
A partir da versão 15 a aplicação pode ser usada sozinha para estruturar anexos em pastas e disponibilizar uma interface de gestor de ficheiros.
Se o objetivo for ligar a um dos clientes cloud, é preciso instalar pelo menos uma aplicação opcional do cliente.
O que acontece quando altero uma regra de pasta?
Quando uma regra de pasta muda, a lista de pastas também muda. Se uma pasta deixar de corresponder às condições, é removida. Se os ficheiros já estavam sincronizados, a sincronização inversa devolve-os ao Odoo e apaga-os do Cloud Client.
Se o objeto do documento não corresponder à regra de pasta, a pasta não é criada. Se mais tarde corresponder, a pasta relacionada será gerada.
Os textos da aplicação e do site em idiomas diferentes do inglês são assistidos por IA e estão alinhados com as traduções oficiais do Odoo. Se detetar um erro, enviar um pedido de traducao e nos corrigimos.
Bases de dados de demonstração Odoo (pré-visualizações)
Para esta aplicação, podemos fornecer uma base de dados de demonstração personalizada gratuita.
Não precisa de um número de telefone ou cartão de crédito para entrar em contacto connosco. Deve apenas passar por um breve registo de e-mail, que não demora mais de 30 segundos.
A seu pedido, preparamos uma base de dados de pré-visualização individual onde pode fazer qualquer teste e validar as suas hipóteses durante cerca de duas semanas.
Comunicação de erros
Se encontrar bugs ou comportamento inconsistente, não hesite em nos contactar. Garantimos o fornecimento de correções em até 60 dias após a compra e estamos intensamente interessados em melhorar nossas ferramentas mesmo após esse período.
Não precisa de um número de telefone ou cartão de crédito para entrar em contacto connosco. Deve apenas passar por um breve registo de e-mail, que não demora mais de 30 segundos.
Inclua o maximo de detalhes possivel no seu pedido: capturas de ecra, registos do servidor Odoo, uma descricao completa de como reproduzir o problema, entre outros. Normalmente, sao necessarios alguns dias uteis para preparar um plano de trabalho para um problema (se for confirmado um erro) ou fornecer orientacoes sobre o que deve ser feito (caso contrario).
Pedidos de recursos públicos e ideias de módulos (desenvolvimento gratuito)
Estamos fortemente motivados para melhorar as nossas ferramentas e ficaríamos gratos por qualquer feedback. Se os seus requisitos forem de utilização pública e puderem ser implementados de forma eficiente, a equipa irá incluí-los na nossa lista de tarefas.
Esta lista de tarefas é processada regularmente e não envolve taxas extra. Embora não possamos prometer prazos e design final, pode ser uma boa forma de obter as características desejadas sem investimentos e riscos.
Não precisa de um número de telefone ou cartão de crédito para entrar em contacto connosco. Deve apenas passar por um breve registo de e-mail, que não demora mais de 30 segundos.
A ferramenta para guardar palavras-passe no Odoo com segurança partilhada. Cofres
198€
A ferramenta para definir metas KPI e controlar o cumprimento por periodo. Painéis. Graficos
198€
A ferramenta para construir uma base de conhecimento profunda, interna e externa. KMS. Revisoes tipo wiki
398€
A ferramenta para servicos por marcacao, da reserva as vendas e avaliacoes
A ferramenta para gerir o Odoo a partir de chats de IA via MCP. Claude. Qualquer IA com MCP.
198€
A ferramenta para estruturar anexos Odoo em pastas e sincronizar com Google Drive, OneDrive/SharePoint, Nextcloud/ownCloud, Dropbox, Amazon S3, Box e NAS. Gestor de ficheiros. DMS
A ferramenta para sincronizar anexos Odoo com OneDrive nos dois sentidos
A ferramenta para sincronizar anexos Odoo com Google Drive nos dois sentidos
A ferramenta para sincronizar anexos Odoo com ownCloud/Nextcloud nos dois sentidos