This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Introdução
⚠ Atenção: Este tutorial foi escrito com base na versão 12.0 do Odoo, datada de janeiro de 2021. Desde então, tanto o Odoo quanto outras ferramentas relacionadas podem ter passado por atualizações e mudanças significativas. Isso pode tornar algumas instruções ou referências obsoletas. Para garantir que você está seguindo as orientações corretas, verifique sempre a documentação mais recente e os anúncios oficiais das ferramentas mencionadas.
Nesta página descreveremos uma das maneiras para instalar o Odoo na versão 12.0 e a localização brasileira. Ela é comumente utilizada para desenvolvimento de módulos e utiliza o GIT em um sistema operacional Ubuntu >= 18.04.
A instalação desta forma permite um maior controle sobre a configuração do sistema, tornando mais flexíveis processos como inicio e parada do Odoo, permitindo substituir as configurações e rodar processos a partir de linha de comando, sem precisar editar arquivos de configuração.
Lembramos que para fazer a instalação é necessário que você tenha conhecimentos básicos de programação e comandos git.
Preparando o ambiente
Primeiramente iremos preparar o ambiente fazendo o configurando o idioma e instalando as bibliotecas python necessárias
Siga a seguinte ordem:
Deve-se definir as configurações locais (Locale) do servidor. No terminal, execute os 4 comandos a seguir:
> export LANGUAGE=pt_BR.UTF-8
> export LANG=pt_BR.UTF-8
> sudo locale-gen pt_BR pt_BR.UTF-8
> sudo dpkg-reconfigure locales
Atualizando o Ubuntu
> sudo apt-get update
Python
Instale as bibliotecas Python necessárias para o Odoo:
sudo apt-get install -y wget git pkg-config xmlsec1 libxml2-dev libxmlsec1-dev libxmlsec1-openssl gnupg gnupg1 gnupg2 pkg-config python3 python3-dev python3-pip python3-lxml python3-suds build-essential ldap-utils libssl-dev libxslt1-dev libsasl2-dev libxmlsec1-dev libxml2-dev libldap2-dev libsnmp-dev libffi-dev libevent-dev libpq-dev libpng-dev libjpeg-dev libfreetype6-dev zlib1g-dev fonts-symbola texlive-fonts-extra xfonts-75dpi xfonts-base default-jre ure libreoffice-java-common libreoffice-writer node-clean-css node-less npm libcups2-dev virtualenv
Instalação WKHTMLtoPDF
Para a instalação do WKHTMLtoPDF, necessário para geração dos arquivos PDF, deve-se escolher o download de acordo com o sistema operacional e arquitetura de seu sistema em http://wkhtmltopdf.org/downloads.html ou em http://download.gna.org/wkhtmltopdf/0.12/ . No nosso caso, o sistema operacional é Ubuntu 18.04 (bionic) e a arquitetura é 64 bits. No momento, somente a versão 0.12.5 está funcional.
> cd /tmp
> sudo wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb
> sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb
Confira a versão do wkhtmltopdf, digitando o seguinte comando no terminal:
> wkhtmltopdf –version # Se a versão for 0.12.5, está correta.
Instalação e Configuração PostgreSQL
Instalação do PostgreSQL
> sudo apt-get install postgresql
Criação do Usuário
> sudo -u postgres psql -e --command "CREATE USER odoo WITH SUPERUSER PASSWORD 'odoo'"
Reiniciando o Serviço
> sudo systemctl restart postgresql
Instalando o Odoo + OCA/l10n-brazil e demais dependências OCA
Este tipo de instalação utiliza o git e, portanto, é necessário que você já tenha o mesmo instalado na sua máquina.
Escolha um diretório onde será feito a instalação do ambiente e crie o seguinte diretório:
> mkdir projeto
> cd projeto
> git init
Odoo
Iniciamos adicionando o sub-módulo Odoo na versão 12.0:
> git submodule add -b 12.0 https://github.com/oca/ocb.git core
Localização
Agora vamos adicionar o sub-módulo Localização Brasileira da OCA na versão 12.0:
> mkdir oca
> cd oca
> git submodule add -b 12.0 https://github.com/oca/l10n-brazil
Dependências OCA
Agora vamos adicionar os demais sub-módulos necessários na versão 12.0
> git submodule add -b 12.0 https://github.com/oca/currency
> git submodule add -b 12.0 https://github.com/oca/bank-payment
> git submodule add -b 12.0 https://github.com/oca/account-payment
Dependências Python
Virtualenv
A partir de agora você pode optar por utilizar o virtualenv para ter as todas as bibliotecas python separadas do teu ambiente e de outros projetos. Caso você não queria utilizar o virtualenv pode pular este trecho e partir direto para a instalação das dependências
- Python virtual environments, ou virtualenv são ambientes de trabalhos python isolados.
- Permitem aos desenvolvedores trabalharem com diferentes versões de bibliotecas python instaladas.
- É possível criar quantos ambientes forem precisos;
Documentação oficial <https://virtualenv.pypa.io/en/stable/>_
> cd ..
> virtualenv venv --python=python3
> source /venv/bin/activate
Obs. Para sair do virtualenv (não faça isso agora):
> deactivate
Instalação das dependências.
> python3 -m pip install -r ./core/requirements.txt
> python3 -m pip install -r ./oca/l10n-brazil/requirements.txt
Executando o Odoo
> ./core/odoo-bin -c odoo.conf --save --stop-after-init
Agora edite o arquivo odoo.conf e adicione os módulos OCA.
> nano odoo.conf
Substitua a linha addons_path conforme descrito abaixo:
addons_path = ./core/odoo/addons,
./core/addons,
./oca/l10n-brazil,
./oca/currency,
./oca/bank-payment,
./oca/account-payment
Pronto, agora execute o odoo
> ./core/odoo-bin -c odoo.conf
Acesso o link http://localhost:8069
...
Instalando módulos da localização
...