Como instalar uma pilha ERPNext no Ubuntu 20.04

O autor selecionou a Software in the Public Interest para receber uma doação como parte do programa Write for DOnations.

Introdução

O ERPNext é uma suíte de Planejamento de Recursos Empresariais (ERP) que aproveita o poder e a flexibilidade das tecnologias de código aberto. Ele se destaca no gerenciamento de processos de negócio fundamentais, como finanças, vendas, recursos humanos, fabricação, compras, serviços, necessidades de assistência técnica e muito mais. Entre os benefícios da implementação de um sistema como o ERPNext estão:

• Melhor produtividade, automatizando processos de negócio repetitivos
• Melhoria da eficiência de TI através do compartilhamento de um banco de dados para todos os departamentos dentro da empresa
• Melhor tomada de decisão graças a uma visão integral de como as unidades de negócios se relacionam entre si

O ERPNext é baseado no Frappe, um framework Web full-stack de aplicativos escrito em Python que aproveita ao máximo o ambiente de tempo de execução Node/JavaScript e usa o MariaDB como seu banco de dados de back-end. Uma das muitas vantagens dos aplicativos baseados no Frappe, como o ERPNext, é o utilitário de linha de comando bench. O CLI do bench economiza tempo dos administradores automatizando tarefas como instalar, atualizar, configurar e gerenciar vários sites do Frappe/ERPNext.

Neste tutorial, você irá instalar e configurar uma pilha ERPNext em um servidor executando o Ubuntu 20.04. Isso permitirá que você configure sua pilha para vários ambientes de desenvolvimento ou produção dependendo das suas necessidades. Além disso, isso irá prepará-lo para construir uma arquitetura mais complexa e tolerante a falhas.

Pré-requisitos

• Um servidor Ubuntu 20.04 com pelo menos 4 GB de RAM e um usuário sudo não root. Você pode configurar seu servidor e usuário seguindo nosso guia de configuração inicial do servidor com o Ubuntu 20.04.

• Um nome de domínio totalmente registrado com um registro A apontado para seu servidor. Se você estiver usando um Droplet da DigitalOcean, então pode seguir este guia para configurar corretamente seu DNS. Este tutorial utilizará o your_domain durante todo o processo.

Passo 1 — Configurando o firewall

Embora configurar um firewall para o desenvolvimento seja opcional, para a produção, isso é uma prática de segurança obrigatória.

Você precisará abrir as seguintes portas em seu servidor ERPNext:

• 80/tcp e 443/tcp para o HTTP e HTTPS respectivamente
• 3306/tcp para a conexão do MariaDB (recomendado apenas se precisar de acesso remoto ao banco de dados)
• 143/tcp e 25/tcp para o IMAP e STMP respectivamente
• 22/tcp para o SSH (se você ainda não tiver ativado o OpenSSH nas configurações do seu UFW)
• 8000/tcp para testar sua plataforma antes de implantá-la para a produção

Para abrir várias portas ao mesmo tempo, utilize o seguinte comando:

sudo ufw allow 22,25,143,80,443,3306,8000/tcp

De maneira alternativa, você pode permitir conexões vindas de endereços IP específicos em portas específicas usando este comando:

sudo ufw allow from server_IP to any port port_number

Depois de abrir todas as portas necessárias,o ative o firewall:

sudo ufw enable

Agora, verifique o status do seu firewall:

sudo ufw status

O UFW irá exibir uma lista das suas regras habilitadas. Certifique-se de que as portas necessárias do ERPNext estejam abertas:

Output
Status: active

To                         Action      From
--                         ------      ----
22,25,80,143,443,3306,8000/tcp  ALLOW       Anywhere
22,25,80,143,443,3306,8000/tcp (v6) ALLOW       Anywhere (v6)

Para obter mais informações sobre a configuração do UFW, consulte nosso guia sobre como configurar um firewall com o UFW no Ubuntu 20.04.

Configurar um firewall adequado é o primeiro dos dois passos preliminares. Agora, você irá configurar o mapeamento de teclado e a codificação de caracteres no seu servidor.

Passo 2 — Configurando localidades

É altamente recomendado que você configure o mapeamento de teclado para o console, bem como a linguagem e a codificação de caracteres no seu host. Isso é necessário para evitar possíveis problemas durante o processo de instalação do ERPNext 12. Observe que essa configuração não tem nada a ver com a linguagem UI na sua plataforma ERPNext em si, mas com a configuração de localidades do sistema.

Primeiro, atualize seu servidor:

sudo apt update

Agora, configure o keymap, a linguagem e a codificação de caracteres:

sudo localectl set-keymap us && sudo localectl set-locale LANG=en_US.utf8

O utilitário localectl é usado pelo Ubuntu 20.04 e outras distribuições do Linux para controlar e alterar as configurações de localidade e de layout de teclado em todo o sistema antes do login do usuário, o que é exatamente o que o ERPNext 12 necessita.

Você também precisará adicionar as seguintes linhas ao seu arquivo /etc/environment. Use o nano ou seu editor de texto preferido para abrir o arquivo:

sudo nano /etc/environment

Agora, adicione o conteúdo a seguir:

LC_ALL=en_US.UTF-8
LC_CTYPE=en_US.UTF-8
LANG=en_US.UTF-8

Salve e feche o arquivo.

Reinicialize seu servidor para aplicar todas as alterações:

sudo reboot

Espere alguns minutos para que seu servidor seja reinicializado e então use o ssh para entrar novamente em sua instância. Agora, você está pronto para instalar seu banco de dados.

Passo 3 — Instalando o MariaDB

Agora, você irá adicionar o MariaDB à sua pilha de servidor. O ERPNext 12 requer o MariaDB 10.2+ para um funcionamento adequado. Como o Ubuntu 20.04 inclui o MariaDB 10.3 em seus repositórios oficiais, você pode instalar esta versão usando o comando apt:

sudo apt install mariadb-server

De maneira alternativa, se preferir uma versão mais recente do MariaDB, siga o Passo 3 do nosso guia sobre como instalar uma pilha ERPNext no Ubuntu 18.04. Isso irá guiá-lo através do assistente de repositório online do MariaDB, que o ajudará a instalar a versão mais recente — MariaDB 10.5.

Depois de instalar o mariadb-server, instale os seguintes pacotes:

sudo apt install python3-mysqldb libmysqlclient-dev

O ERPNext 12 é um aplicativo Python e, portanto, requer a biblioteca python3-mysqldb para o gerenciamento de banco de dados. O libmysqlclient-dev é necessário para acessar certas funcionalidades de desenvolvedor do MariaDB.

Em seguida, adicione uma camada extra de segurança ao servidor MariaDB executando o script mysql_secure_installation:

sudo mysql_secure_installation

O script mysql_secure_installation solicitará que você responda a várias perguntas:

• O primeiro prompt irá perguntar-lhe sobre a senha do root. Como ainda não existe nenhuma senha configurada, pressione ENTER.
• Em seguida, quando perguntado sobre a alteração da senha do root do MariaDB, responda N. Usar a senha padrão juntamente com a autenticação do Unix é a configuração recomendada para sistemas baseados no Ubuntu, pois a conta root está intimamente relacionada com tarefas de manutenção automatizadas do sistema.
• As perguntas restantes têm a ver com remover o usuário anônimo do banco de dados, restringir a conta root para fazer login remotamente no localhost, remover o banco de dados de teste e recarregar as tabelas de privilégio. É seguro responder Y a todas essas perguntas.

Depois de completar o script mysql_secure_installation, o MariaDB será iniciado usando sua configuração padrão. A instalação padrão do ERPNext usa o usuário root do MariaDB’s para todas as operações de banco de dados. Embora essa abordagem possa ser conveniente em configurações com um único servidor, ela não é considerada uma boa prática de segurança. Dessa forma,na próxima seção, você irá aprender como evitar este problema criando um novo usuário com privilégios especiais.

Como criar um usuário super administrador do MariaDB

O ERPNext espera usar o usuário root do MariaDB para o gerenciamento de conexões de banco de dados, mas isso nem sempre é ideal. Para superar essa limitação e deixar um usuário não root gerenciar o MariaDB, você criará manualmente um banco de dados com o nome do usuário. Depois disso, será capaz de atribuir privilégios especiais ao novo usuário para que ele conduza as operações de banco de dados do ERPNext.

Abra o prompt do MariaDB:

sudo mysql

Agora, crie um novo banco de dados com o nome do usuário que você deseja atribuir para as conexões do MariaDB. Este tutorial irá usar sammy, mas sinta-se à vontade para escolher um nome diferente:

CREATE DATABASE sammy;

Confirme se o banco de dados foi criado usando esta declaração SQL:

SHOW DATABASES;

Você verá um resultado parecido com este:

Output
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sammy              |
+--------------------+

Agora, crie o usuário sammy do MariaDB com privilégios semelhantes ao root e então dê a ele uma senha forte da sua escolha. Mantenha a senha em um lugar seguro; você precisará dela mais tarde:

GRANT ALL PRIVILEGES ON *.* TO 'sammy'@'%' IDENTIFIED BY 'mariadb_password' WITH GRANT OPTION;

Agora, confirme tanto a criação do usuário quanto dos privilégios do novo usuário:

SELECT host, user, Super_priv FROM mysql.user;

Você verá uma saída como esta:

Output
+-----------+-------+------------+
| Host      | User  | Super_priv |
+-----------+-------+------------+
| localhost | root  | Y          |
| localhost | mysql | Y          |
| %         | sammy| Y         |
+-----------+-------+------------+
3 rows in set (0.001 sec)

Em seguida, libere os privilégios para aplicar todas as alterações:

FLUSH PRIVILEGES;

Depois de terminar, saia da sessão:

exit

Agora que você criou um usuário do banco de dados, precisa apenas ajustar o MariaDB para garantir uma operação adequada do ERPNext 12. Felizmente, a equipe do ERPNext fornece um excelente modelo de configuração que será usado como um ponto de partida para sua implementação. Na próxima seção, você irá aprender como configurar corretamente o banco de dados do MariaDB usando esse modelo.

Passo 4 — Configurando o MariaDB para o ERPNext

Com o MariaDB instalado e protegido, é hora de ajustá-lo para as conexões do ERPNext.

Primeiro, interrompa o mariadb.service:

sudo systemctl stop mariadb

Agora, use o nano ou seu editor de texto favorito para criar um arquivo de configuração do MariaDB chamado mariadb.cnf:

sudo nano /etc/mysql/mariadb.conf.d/mariadb.cnf

Em seguida, adicione o modelo oficial de configuração do ERPNext:

[mysqld]

# GENERAL #
user                           = mysql
default-storage-engine         = InnoDB
socket                         = /var/lib/mysql/mysql.sock
pid-file                       = /var/lib/mysql/mysql.pid

# MyISAM #
key-buffer-size                = 32M
myisam-recover                 = FORCE,BACKUP

# SAFETY #
max-allowed-packet             = 256M
max-connect-errors             = 1000000
innodb                         = FORCE

# DATA STORAGE #
datadir                        = /var/lib/mysql/

# BINARY LOGGING #
log-bin                        = /var/lib/mysql/mysql-bin
expire-logs-days               = 14
sync-binlog                    = 1

# REPLICATION #
server-id                      = 1

# CACHES AND LIMITS #
tmp-table-size                 = 32M
max-heap-table-size            = 32M
query-cache-type               = 0
query-cache-size               = 0
max-connections                = 500
thread-cache-size              = 50
open-files-limit               = 65535
table-definition-cache         = 4096
table-open-cache               = 10240

# INNODB #
innodb-flush-method            = O_DIRECT
innodb-log-files-in-group      = 2
innodb-log-file-size           = 512M
innodb-flush-log-at-trx-commit = 1
innodb-file-per-table          = 1
innodb-buffer-pool-size        = 5462M
innodb-file-format             = barracuda
innodb-large-prefix            = 1
collation-server               = utf8mb4_unicode_ci
character-set-server           = utf8mb4
character-set-client-handshake = FALSE
max_allowed_packet             = 256M

# LOGGING #
log-error                      = /var/lib/mysql/mysql-error.log
log-queries-not-using-indexes  = 0
slow-query-log                 = 1
slow-query-log-file            = /var/lib/mysql/mysql-slow.log

# CONNECTIONS #

pid-file        = /var/run/mysqld/mysqld.pid
socket          = /var/run/mysqld/mysqld.sock
bind-address    = 0.0.0.0

[mysql]
default-character-set = utf8mb4

[mysqldump]
max_allowed_packet=256M

Salve e feche o arquivo. Para obter informações mais detalhadas sobre essas configurações, revise este arquivo modelo no repositório Github do ERPNext. Ele é um ponto de partida útil para explorar essas opções.

O arquivo de configuração /etc/mysql/mariadb.conf.d/mariadb.cnf complementa e também substitui alguns valores incluídos na configuração padrão do MariaDB localizada em /etc/mysql/my.cnf. Este arquivo oferece um modelo curado que melhora muito o desempenho de banco de dados para o ERPNext. No entanto, tenha em mente que, embora esse modelo seja um ótimo ponto de partida, nada impede que você melhore o desempenho do MariaDB ainda mais ajustando esses parâmetros para atender às suas necessidades.

Testando a conexão do MariaDB

Como o ERPNext depende da conexão de banco de dados para quase todas as suas operações internas, é uma boa ideia testar a conexão antes de continuar.

Inicie o mariadb.service:

sudo systemctl start mariadb

Para testar a conexão, use o seguinte comando. Lembre-se de substituir sammy e mariadb_password por suas credenciais:

mysql --user sammy --password mariadb_password --host=localhost --protocol=tcp --port=3306 test

Você verá um resultado mostrando o conteúdo básico de ajuda do MariaDB, bem como diversos parâmetros. Isso significa que sua conexão foi bem sucedida:

Output
mysql  Ver 15.1 Distrib 10.4.13-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Usage: mysql [OPTIONS] [database]

Default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf

...

  --ssl-verify-server-cert
                      Verify server's "Common Name" in its cert against
                      hostname used when connecting. This option is disabled by
                      default.
  -t, --table         Output in table format.
  --tee=name          Append everything into outfile. See interactive help (\h)
                      also. Does not work in batch mode. Disable with
                      --disable-tee. This option is disabled by default.
  -u, --user=name     User for login if not current user.
  -U, --safe-updates  Only allow UPDATE and DELETE that uses keys.
  -U, --i-am-a-dummy  Synonym for option --safe-updates, -U.
  -v, --verbose       Write more. (-v -v -v gives the table output format).

...

max-join-size                     1000000
secure-auth                       FALSE
show-warnings                     FALSE
plugin-dir                        (No default value)
default-auth                      (No default value)
binary-mode                       FALSE
connect-expired-password          FALSE

Se precisar fazer qualquer ajuste nas configurações do MariaDB, ou corrigir qualquer erro, lembre-se de recarregar o serviço usando o seguinte comando:

sudo systemctl restart mariadb

Depois de terminar, ative o MariaDB:

sudo systemctl enable mariadb

Agora que você testou a conexão do banco de dados, continue com a instalação do seu aplicativo ERPNext.

Passo 5 — Configurando o ERPNext 12

Agora que o banco de dados está pronto, continue configurando seu aplicativo Web ERPNext. Nesta seção, você irá aprender como instalar e configurar todos os componentes necessários pelo ERPNext 12 e então instalar o próprio aplicativo.

Comece preparando o servidor com todos os pacotes de sistema exigidos pelo ERPNext 12. Instale as dependências do sistema usando o seguinte comando:

sudo DEBIAN_FRONTEND=noninteractive apt install -y curl build-essential python3-testresources python3-setuptools python3-dev libffi-dev python3-pip libcurl4 dnsmasq fontconfig git htop libcrypto++-dev libfreetype6-dev liblcms2-dev libwebp-dev libxext6 libxrender1 libxslt1-dev libxslt1.1 libffi-dev ntpdate postfix python3-dev python-tk screen vim xfonts-75dpi xfonts-base zlib1g-dev apt-transport-https libsasl2-dev libldap2-dev libcups2-dev pv libjpeg8-dev libtiff5-dev tcl8.6-dev tk8.6-dev libdate-manip-perl logwatch

A variável DEBIAN_FRONTEND=noninteractive foi passada para o comando de instalação para evitar os prompts do Postfix. Para informações detalhadas sobre a configuração do Postfix, leia nosso guia sobre Como instalar e configurar o Postfix no Ubuntu 20.04.

Em seguida, atualize o pip3, que é o gerenciador padrão de pacotes do Python e depois instale as últimas versões de três módulos adicionais do Python:

 sudo -H python3 -m pip install --upgrade setuptools cryptography psutil

O setuptools facilita a instalação e atualização dos pacotes do Python, o cryptography adiciona capacidades de criptografia à sua pilha e o psutil auxilia com o monitoramento do sistema. Agora que você instalou todas as dependências globais necessárias, irá instalar todos os serviços e bibliotecas exigidos pelo ERPNext 12.

Configurando o Node.js e o Yarn

O ERPNext 12 pode trabalhar com a versão 8+ do ambiente de servidor Node.js. Na verdade, no momento em que este artigo está sendo escrito, o script oficial easy_install do ERPNext usa o Node 8. No entanto, do ponto de vista da segurança, é aconselhável instalar uma versão mais recente porque o Node 8 atingiu seu End Of Life (EOL) em 2020 e, portanto, não receberá mais nenhum patch de segurança. No momento da publicação deste artigo, o Ubuntu 20.04 contém a versão 10.19 do Node.js. Embora esta versão ainda seja mantida, por razões semelhantes (EOL em menos de um ano), é altamente aconselhável evitar seu uso. Para este guia, o Node.js versão 12 LTS será instalado juntamente com os gerenciadores de pacotes npm e yarn correspondentes. Note que o framework Frappe usa o yarn para instalar dependências. Se você decidir usar um método alternativo de instalação, certifique-se de que você tenha a versão 1.12+ do yarn em execução no seu sistema.

Adicione o repositório NodeSource ao seu sistema:

curl -sL https://deb.nodesource.com/setup_12.x -o nodesource_setup.sh

Agora, você pode inspecionar o conteúdo do script baixado:

sudo nano nodesurce_setup.sh

Assim que estiver satisfeito com o conteúdo do script, execute-o:

sudo bash nodesource_setup.sh

Esse script irá atualizar automaticamente a lista apt. Agora, instale o nodejs em seu servidor:

sudo apt install nodejs

Em seguida, instale o yarn globalmente usando o gerenciador de pacotes npm:

sudo npm install -g yarn

Agora que você instalou o Node, siga adiante para configurar o wkhtmltopdf para sua plataforma.

O ERPNext usa a ferramenta wkhtmltopdf de código aberto para converter conteúdo HTML em PDF usando o mecanismo de renderização Qt WebKit. Esse recurso é usado principalmente para imprimir faturas, cotações e outros relatórios. No caso do ERPNext 12, uma versão específica do wkhtmltopdf é necessária, a 0.12.5 com o Qt implementado.

Para instalar o wkhtmltopdf, comece indo para um diretório adequado para baixar o pacote. Neste caso, o /tmp:

cd /tmp

Baixe a versão e o pacote apropriados do wkhtmltopdf para o Ubuntu 20.04 da página do projeto:

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb

Agora, instale o pacote usando a ferramenta dpkg:

sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb

Em seguida, copie todos os executáveis relevantes para seu diretório /usr/bin/:

sudo cp /usr/local/bin/wkhtmlto* /usr/bin/

Assim que os arquivos estiverem no lugar, mude suas permissões para torná-los executáveis:

sudo chmod a+x /usr/bin/wk*

Agora que o wkhtmltopdf está instalado corretamente, adicionaremos o Redis à pilha do nosso banco de dados.

Instalando o Redis

O ERPNext 12 usa o Redis para melhorar o desempenho do MariaDB. Mais especificamente, o Redis auxilia com o cache.

Primeiro, instale o Redis a partir do repositório oficial do Ubuntu 20.04:

sudo apt install redis-server

Em seguida, ative o Redis na inicialização:

sudo systemctl enable redis-server

Agora que você adicionou o Redis à sua pilha, vamos dedicar um momento para resumir o que você fez até agora. Até este ponto, você instalou todos os componentes principais exigidos pelo ERPNext 12, que incluem:

• Um backend de banco de dados MariaDB
• O ambiente de servidor JavaScript Node.js
• O gerenciador de pacotes Yarn
• Um cache banco de dados Redis
• O gerador de documentos PDF wkhtmltopdf

Se você estiver instalando o sistema ERP para o desenvolvimento ou para a produção, agora está pronto para o próximo passo, que é a instalação do framework full-stack Frappe e o aplicativo Web ERPNext 12 em si.

Passo 6 — Instalando o Bench CLI do Frappe

Agora que você instalou todos os requisitos de pilha do ERPNext, libere a flexibilidade do utilitário de linha de comando bench do Frappe. O bench CLI foi projetado com o propósito de ajudar os usuários no processo de instalar, configurar e gerenciar aplicativos como o ERPNext que são baseados no Frappe Framework. Nas próximas seções, você irá instalar o CLI bench e então usá-lo para completar o processo de configuração do ERPNext 12.

Certifique-se de que o usuário do Frappe (neste caso sammy) tenha os direitos adequados em seu diretório home:

sudo chown sammy -R /home/sammy

Agora, clone o repositório frappe/bench para seu diretório home. Lembre-se de substituir sammy pelo nome de usuário do seu sistema:

git clone https://github.com/frappe/bench /home/sammy/.bench --depth 1 --branch master

Instale o bench CLI:

sudo pip3 install -e /home/sammy/.bench

Este guia assume que você esteja instalando o ERPNext 12 para cenários de teste/produção e, consequentemente,que você esteja usando a ramificação master. Mas se a sua intenção for desenvolver aplicativos ou módulos do ERPNext personalizados, a ramificação develop pode ser uma opção mais adequada. Para ambos os casos, você está agora preparado para instalar o Frappe Framework. Esse será o passo final antes de instalar o próprio ERPNext.

Configurando o ambiente do Frappe Framework

Nesta seção, você irá criar um ambiente do Frappe usando o bench CLI.

Durante a instalação do Frappe, você pode exceder o limite de inspeção de arquivos do Ubuntu, que por padrão é definido como 8192. Para evitar este problema, defina um limite superior usando o seguinte comando:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

O comando tee irá anexar o conteúdo do seu comando echo ao arquivo chamado ao mesmo tempo em que também imprime o resultado em seu console.

Em seguida, inicialize o Frappe Framework 12. Substitua Sammy pelo nome de usuário do seu sistema:

bench init /home/sammy/frappe-bench --frappe-path https://github.com/frappe/frappe --frappe-branch version-12 --python python3

Durante a execução, um erro sobre seu caminho pode aparecer, juntamente com vários avisos. Deixe o processo continuar até o fim. Depois que ele for finalizado, você verá um resultado semelhante ao seguinte, indicando que seu ambiente foi criado com sucesso:

Output
...
Done in 82.23s.
INFO:bench.utils:setting up backups
no crontab for sammy
SUCCESS: Bench /home/sammy/frappe-bench initialized

Vamos dar uma olhada no comando usado para criar o ambiente:

• /home/sammy/frappe-bench é o caminho onde o Frappe Framework, os sites e aplicativos associados serão instalados. Um novo diretório, chamado frappe-bench neste exemplo, será criado para acomodar todos os arquivos necessários.
• --frappe-path aponta para o repositório do Frappe, que neste caso é o repositório oficial do Github.
• --frappe-branch é a versão do Frappe a ser instalada. Como você quer instalar o ERPNext 12, a versão escolhida é o Frappe 12.
• --python é a versão do Python que será usada. O ERPNext 12 requer o Python 3.6+. No entanto, as versões anteriores ainda usam o Python 2.7.

Para obter mais informações sobre comandos bench CLI, consulte o Manual dos comandos bench.

A flexibilidade oferecida pelo Frappe Framework vai muito além do uso de ambientes isolados. Você também pode criar sites diferentes e instalar aplicativos neles.

Passo 7 — Instalando o aplicativo Web ERPNext 12

Nesta seção, você irá construir um site baseado no Frappe, e então instalar o aplicativo ERPNext 12 nele.

Vá para o diretório onde o Frappe foi inicializado.

cd /home/sammy/frappe-bench

Antes de continuar, será necessário instalar versões específicas das bibliotecas numpy e pandas do Python no ambiente virtual do Frappe. Instale esses pacotes usando o seguinte comando:

./env/bin/pip install numpy==1.18.5 && ./env/bin/pip install pandas==0.24.2

Neste momento, a instalação pode parar por cerca de 10 a 20 minutos enquanto exibe esta mensagem:

Output
...
Building wheel for pandas (setup.py) ... -

Isso tem a ver com um bug relacionado ao pandas e o Ubuntu 20.04, que, no momento em que este tutorial está sendo escrito, ainda é relativamente novo. No entanto, os pacotes serão compilados e, assim que forem concluídos, você verá um resultado como este:

Output
...
Successfully built pandas
Installing collected packages: pandas
Successfully installed pandas-0.24.2

Agora, continue a instalação. Faça o download do ERPNext 12 do seu repositório usando o bench CLI:

bench get-app erpnext https://github.com/frappe/erpnext --branch version-12

Em seguida, crie o novo site, substituindo your_domain pelo domínio que você associou ao IP deste servidor:

bench new-site your_domain --admin-password 'erpnext_admin_password' --mariadb-root-username sammy --mariadb-root-password 'mariadb_password'

Vamos reservar um momento para revisar as opções usadas no comando acima:

• bench new-site cria um novo site baseado no Frappe Framework.
• your_domain é o nome para o novo site. Certifique-se de que o DNS do seu domínio tenha um registro A apontando para o IP do seu servidor.
• erpnext_admin_password é a senha desejada para o usuário Administrator do ERPNext. Mantenha essa senha em um lugar seguro — você precisará dela em breve.
• mariadb_password é a senha que você criou no início do guia para o usuário sammy do MariaDB.

Depois disso, instale o aplicativo ERPNext no site:

bench --site your_domain install-app erpnext

Assim que a instalação for concluída, você terá um aplicativo ERPNext 12 em funcionamento. Agora, vamos testá-lo usando um comando bench:

bench start

O comando acima irá iniciar um console de monitoramento em tempo real mostrando várias mensagens sobre o servidor Web e outros serviços. Abra um navegador Web e vá até localhost:8000 (para instalações locais) ou your_domain:8000 (se você estiver usando um servidor remoto). Você verá a tela de login do ERPNext (abordaremos o login e a configuração em um passo posterior, assim que fizermos nosso site ficar pronto para a produção).

Depois de visitar sua implantação teste, retorne ao seu terminal e pressione CTRL+C. Isso irá parar o ERPNext e sair do console de monitoramento.

Se seu objetivo principal for criar módulos ou modificar o ERPNext 12, então pode parar aqui. Não há mais componentes necessários para fins de desenvolvimento. No entanto, se o que você precisa é um sistema pronto para a produção que não requer uma inicialização manual, então será necessário instalar e configurar alguns componentes adicionais. Esse é o seu próximo passo.

Passo 8 — Configurando o ERPNext 12 para a produção

Embora seu aplicativo ERPNext 12 esteja pronto, o sistema como um todo não está preparado para a produção. Para garantir a confiabilidade e segurança do ERPNext, será necessário habilitar alguns serviços adicionais:

• O Fail2ban fornece uma camada extra de proteção contra tentativas de força bruta de usuários e bots maliciosos.
• O Nginx opera principalmente como um proxy Web, redirecionando todo o tráfego da porta 8000 para a porta 80 (HTTP) ou porta 443 (HTTPS)
• O Supervisor garante que os processos chave do ERPNext estejam em funcionamento constante, reiniciando-os conforme necessário.

Até este ponto, você instalou e configurou o ERPNext 12 manualmente, o que lhe permitiu personalizar o processo para funcionar em qualquer caso de uso particular. No entanto, para o resto da configuração de produção, aproveite a conveniência do bench CLI e deixe-o automatizar a instalação e configuração desses serviços restantes.

Certifique-se de estar no diretório de trabalho do Frappe:

cd /home/sammy/frappe-bench

Agora, use o seguinte comando para terminar a configuração do ERPNext 12 para produção:

sudo bench setup production sammy --yes

O comando acima irá instalar e configurar o Nginx, Supervisor e Fail2Ban e definir sammy como proprietário do ambiente de produção.

Os arquivos de configuração criados pelo comando bench são:

• Dois arquivos de configuração do Nginx localizados em /etc/nginx/nginx.conf e /etc/nginx/conf.d/frappe-bench.conf
• Uma prisão de proxy do Fail2Ban localizada em /etc/fail2ban/jail.d/nginx-proxy.conf e um filtro localizado em /etc/fail2ban/filter.d/nginx-proxy.conf

Essas configurações padrão serão suficientes para este tutorial, mas sinta-se livre para explorar e ajustar esses arquivos para atender às suas necessidades. Pare todos os serviços executando:

sudo supervisorctl stop all

Assim que tudo estiver pronto, reinicie seus serviços:

sudo supervisorctl start all

Agora, você está pronto para testar sua instalação.

Testando sua instalação do ERPNext 12

Em primeiro lugar, verifique se os serviços de produção chave estão em execução. Use o seguinte comando systemctl e então canalize-o para o grep:

systemctl list-unit-files | grep 'fail2ban\|nginx\|supervisor'

Você verá uma saída como esta:

Output
fail2ban.service                       enabled
nginx.service                          enabled
supervisor.service                     enabled

Depois de confirmar que tudo está funcionando como esperado, você pode testar o ERPNext 12 ao vivo em seu servidor. Abra seu navegador favorito e vá até your_domain, ou onde quer que você esteja hospedando seu aplicativo ERPNext 12.

Depois de alguns segundos, a tela de login do ERPNext 12 deve aparecer. Use Administrator para o nome de usuário (e-mail) e a senha erpnext_admin_password que você criou anteriormente para a senha.

Na próxima tela, você verá um menu suspenso onde pode selecionar o idioma da interface do usuário para o aplicativo:

Após a seleção de idiomas, o ERPNext irá questioná-lo sobre seu país, fuso horário e moeda:

Depois de completar as informações sobre a sua região, você será capaz de criar seu primeiro usuário do ERPNext. As informações que você fornecer serão usadas como as credenciais de login do usuário.

Na próxima tela, você será questionado sobre o que o ERPNext chama de Domains (domínios). Se não tiver certeza sobre qual é o seu domínio, selecione Distribution e clique no botão Next.

Em seguida, será necessário fornecer um nome e abreviação da empresa.

Na última tela, o ERPNext irá perguntar o que sua empresa faz, o nome do seu banco, o tipo de gráficos de contas e o período do ano fiscal. Você será capaz de inserir bancos adicionais mais tarde. Por enquanto, preencha todos os campos como quiser e clique no botão Complete Setup.

Em seguida, você verá uma barra de progresso.

Assim que o processo de configuração for concluído, o painel principal do ERPNext 12 será exibido.

Agora, você terminou de instalar e configurar totalmente um aplicativo ERPNext 12.

Conclusão

Agora que você instalou corretamente seu aplicativo ERPNext 12, pode ser desejável iniciar a implementação do sistema para as necessidades do seu negócio. Um bom ponto de partida é clicando no botão Getting Started no painel do ERPNext. O ERPNext irá então ajudá-lo a configurar a plataforma para todas as suas necessidades de negócios e e-commerce.

Pode ser que você também queira aumentar a velocidade do ERPNext. Se esse for o caso, então leia sobre o ajuste de desempenho do ERPNext, que irá guiá-lo pelas práticas recomendadas e como depurar problemas relacionados ao desempenho.