Laboratório: Implantação do Odoo Community em ambiente isolado com PostgreSQL

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

13

Validações

5

Versões da documentação consultada

Odoo Community 16.0 · PostgreSQL 15 (consulte a documentação para versões suportadas)

Topologia

Uma máquina virtual Linux (Ubuntu Server) conecta-se localmente ao PostgreSQL e expõe o Odoo na porta 8069. O acesso é feito via navegador de outra máquina na mesma rede privada (por exemplo, 192.168.56.0/24).

┌──────────────┐
│ VM Ubuntu   │
│ (Odoo+PGSQL)│
└─────┬────────┘
      │ 192.168.56.10
      │
┌─────▼───────┐
│ Navegador   │
│ (host ou VM)│
└─────────────┘

Equipamentos e software

Roteiro

1. Preparar o sistema operacional

   Atualize os pacotes do Ubuntu para garantir segurança e compatibilidade. Isso evita conflitos de dependências.

   sudo apt update && sudo apt upgrade -yCopiar

   O que você deve ver: Pacotes atualizados sem erros.

2. Instalar dependências básicas

   Odoo requer Python, pip, git e ferramentas de compilação. Instale tudo antes de prosseguir.

   sudo apt install -y python3 python3-pip git build-essential wget python3-venvCopiar

   O que você deve ver: Todos os pacotes instalados com sucesso.

3. Instalar e configurar o PostgreSQL

   Odoo usa PostgreSQL como backend. Instale e garanta que o serviço está ativo.

   sudo apt install -y postgresqlCopiar

   O que você deve ver: PostgreSQL instalado e rodando (systemctl status postgresql mostra 'active').

4. Criar usuário PostgreSQL para o Odoo

   Odoo precisa de um usuário dedicado no banco. Crie um usuário 'odoo' sem senha para uso local.

   sudo -u postgres createuser -s odooCopiar

   O que você deve ver: Usuário 'odoo' criado (sem saída se bem-sucedido).

5. Criar usuário do sistema para o Odoo

   Separe o ambiente do Odoo criando um usuário de sistema sem privilégios de sudo.

   sudo adduser --system --home=/opt/odoo --group odooCopiar

   O que você deve ver: Usuário e diretório /opt/odoo criados.

6. Clonar o código-fonte do Odoo Community

   Baixe a versão Community do repositório oficial. Isso garante acesso ao código aberto e atual.

   sudo -u odoo git clone https://github.com/odoo/odoo.git --depth 1 --branch 16.0 /opt/odoo/odoo-serverCopiar

   O que você deve ver: Repositório clonado em /opt/odoo/odoo-server.

7. Criar ambiente virtual Python

   Isole as dependências do Odoo usando venv. Isso evita conflitos com outros projetos Python.

   sudo -u odoo python3 -m venv /opt/odoo/venvCopiar

   O que você deve ver: Ambiente virtual criado em /opt/odoo/venv.

8. Instalar dependências Python do Odoo

   Instale os requisitos do Odoo no ambiente virtual. Use o requirements.txt oficial.

   sudo -u odoo /opt/odoo/venv/bin/pip install -r /opt/odoo/odoo-server/requirements.txtCopiar

   O que você deve ver: Dependências instaladas sem erros.

9. Criar diretório para addons personalizados

   Facilite futuras customizações criando um diretório separado para módulos extras.

   sudo mkdir /opt/odoo/custom-addons && sudo chown odoo: /opt/odoo/custom-addonsCopiar

   O que você deve ver: Diretório /opt/odoo/custom-addons criado e com permissões corretas.

10. Configurar o arquivo odoo.conf

    Odoo precisa de um arquivo de configuração. Crie um básico apontando para PostgreSQL local e os diretórios de addons.

    sudo tee /etc/odoo.conf > /dev/null <<EOF
    [options]
    ; Caminho do diretório de log
    logfile = /var/log/odoo/odoo.log
    ; Porta padrão
    xmlrpc_port = 8069
    ; Caminho dos addons
    addons_path = /opt/odoo/odoo-server/addons,/opt/odoo/custom-addons
    ; Usuário do banco
    db_user = odoo
    EOF
    sudo mkdir -p /var/log/odoo && sudo chown odoo: /var/log/odooCopiar

    O que você deve ver: Arquivo /etc/odoo.conf criado e diretório de log pronto.

11. Executar o Odoo pela primeira vez

    Teste a instalação rodando o Odoo manualmente. Isso facilita identificar erros de configuração.

    sudo -u odoo /opt/odoo/venv/bin/python3 /opt/odoo/odoo-server/odoo-bin -c /etc/odoo.confCopiar

    O que você deve ver: Odoo inicializa e exibe logs no terminal. Mensagem indicando 'Odoo is running' e 'HTTP service (werkzeug) running on 0.0.0.0:8069'.

12. Acessar a interface web do Odoo

    No navegador, acesse http://192.168.56.10:8069 (ajuste o IP conforme sua VM).

    O que você deve ver: Tela de criação do banco de dados do Odoo. Interface web carregando sem erros.

13. Configurar inicialização automática (opcional)

    Para produção, configure o Odoo como serviço systemd. Consulte a documentação para parâmetros avançados.

    sudo tee /etc/systemd/system/odoo.service > /dev/null <<EOF
    [Unit]
    Description=Odoo
    After=network.target postgresql.service
    
    [Service]
    Type=simple
    User=odoo
    Group=odoo
    ExecStart=/opt/odoo/venv/bin/python3 /opt/odoo/odoo-server/odoo-bin -c /etc/odoo.conf
    
    [Install]
    WantedBy=multi-user.target
    EOF
    sudo systemctl daemon-reload
    sudo systemctl enable --now odooCopiar

    O que você deve ver: Serviço Odoo ativo e iniciado automaticamente no boot.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Altere a senha do usuário Odoo no banco após instalação.
• Restrinja o acesso à porta 8069 apenas à rede interna.
• Não rode o Odoo como root.
• Proteja o arquivo de configuração (odoo.conf) contra leitura por outros usuários.
• Mantenha o sistema operacional e dependências atualizados.

Checklist final

• Sistema operacional atualizado
• PostgreSQL instalado e rodando
• Usuário 'odoo' criado no sistema e no banco
• Código-fonte do Odoo Community clonado
• Ambiente virtual Python funcional
• Arquivo odoo.conf criado e configurado
• Odoo acessível via navegador na porta 8069