Как установить Odoo 14 на Ubuntu 20.04 LTS

Введение

Odoo — популярный набор бизнес-приложений с открытым исходным кодом. Он предлагает широкий спектр приложений, включая CRM, электронную коммерцию, создание веб-сайтов, выставление счетов, бухгалтерский учет, производство, склад, управление проектами, инвентаризацию и многое другое, все они легко интегрированы.

Odoo можно установить разными способами в зависимости от варианта использования и доступных технологий. Самый простой и быстрый способ установить Odoo — использовать официальные репозитории APT Odoo.

Установка Odoo в виртуальной среде или развертывание в виде контейнера Docker позволяет вам лучше контролировать конфигурацию вашей системы и запускать несколько версий Odoo в одной системе.

В этом руководстве мы расскажем вам об установке и развертывании Odoo 14 в виртуальной среде Python на Ubuntu 20.04 LTS. Мы загрузим Odoo из их репозитория Github и будем использовать Nginx в качестве обратного прокси-сервера.

Если вы хотите установить Odoo на удаленный сервер, продолжайте чтение, в противном случае пропустите первый абзац «Подключение к серверу» и читайте следующий.

Подключение к серверу

Чтобы получить доступ к серверу, вам нужно знать IP-адрес. Вам также потребуется ваше имя пользователя и пароль для аутентификации. Чтобы подключиться к серверу как root, введите следующую команду:

ssh root@IP_DEL_SERVER

Далее вам нужно будет ввести пароль пользователя root.

Если вы не используете пользователя root, вы можете войти под другим именем пользователя с помощью той же команды, а затем изменить root на свое имя пользователя:

ssh nome_utente@IP_DEL_SERVER

Затем вам будет предложено ввести пароль пользователя.

Стандартный порт для подключения по ssh — 22, если ваш сервер использует другой порт, вам нужно будет указать его с помощью параметра -p, затем введите следующую команду:

ssh nome_utente@IP_DEL_SERVER -p PORTA

Предварительные требования для установки

Войдите в Ubuntu как пользователь sudo, чтобы успешно завершить это руководство.

После входа в систему как пользователь sudo без полномочий root обновите кеш Apt:

sudo apt update

Установите Git, Pip, Node.js и инструменты, необходимые для создания зависимостей Odoo:

sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less

Создать системного пользователя

Создайте системного пользователя с помощью команды useradd, который будет запускать Odoo, с именем odoo14 и домашним каталогом /opt/odoo14:

sudo useradd -m -d /opt/odoo14 -U -r -s /bin/bash odoo14

Вы можете установить имя пользователя по своему выбору, если вы создаете пользователя PostgreSQL с таким же именем.

Установите и настройте PostgreSQL.

Odoo использует PostgreSQL в качестве базы данных. Чтобы установить PostgreSQL, выполните следующую команду:

sudo apt install postgresql

После завершения установки создайте пользователя PostgreSQL с тем же именем, что и ранее созданный системный пользователь, в нашем случае odoo14:

sudo su - postgres -c "createuser -s odoo14"

Установить Wkhtmltopdf

Пакет wkhtmltox предоставляет набор инструментов командной строки с открытым исходным кодом, способных преобразовывать HTML в PDF и различные форматы изображений. Чтобы печатать отчеты в формате PDF, вам необходимо установить инструмент wkhtmltopdf. Рекомендуемая версия для Odoo — 0.12.6, которая недоступна в стандартных репозиториях Ubuntu 20.04.

Загрузите пакет с помощью следующей команды wget:

sudo wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox_0.12.6-1.bionic_amd64.deb

После завершения загрузки установите пакет, набрав:

sudo apt install./wkhtmltox_0.12.6-1.bionic_amd64.deb

Установите и настройте Odoo 14

Как упоминалось выше, мы установим Odoo из исходного кода в изолированной виртуальной среде Python.

Сначала переключитесь на пользователя odoo14:

sudo su - odoo14

Клонируйте исходный код Odoo 14 с GitHub:

git clone https://www.github.com/odoo/odoo --depth 1 --branch 14.0 /opt/odoo14/odoo

После завершения загрузки создайте новую виртуальную среду Python для Odoo:

cd /opt/odoo14

python3 -m venv odoo-venv

Активируйте среду с помощью следующей команды:

source odoo-venv/bin/activate

Установите все необходимые модули Python с pip3:

pip3 install wheel

pip3 install -r odoo/requirements.txt

Если вы столкнулись с ошибкой компиляции во время установки, убедитесь, что установлены все необходимые зависимости, перечисленные в разделе « Installing Prerequisites предварительных условий».

После этого деактивируйте среду, набрав:

deactivate

Мы создаем себе новую папку, которая будет содержать сторонние дополнения.

mkdir /opt/odoo14/odoo-custom-addons

Далее мы добавим этот каталог в параметр addons_path. Этот параметр определяет список каталогов, в которых Odoo ищет модули.

Вернитесь к своему пользователю sudo:

exit

Создайте файл конфигурации со следующим содержимым:

sudo nano /etc/odoo14.conf

[options]
 ; This is the password that allows database operations:
 admin_passwd = my_admin_passwd
 db_host = False
 db_port = False
 db_user = odoo14
 db_password = False
 addons_path = /opt/odoo14/odoo/addons,/opt/odoo14/odoo-custom-addons

Не забудьте изменить my_admin_passwd на более безопасный.

Создайте файл диска Systemd

Откройте текстовый редактор и создайте файл сервисной единицы с именем odoo14.service со следующим содержимым:

sudo nano /etc/systemd/system/odoo14.service

[Unit]
 Description=Odoo14
 Requires=postgresql.service
 After=network.target postgresql.service

 [Service]
 Type=simple
 SyslogIdentifier=odoo14
 PermissionsStartOnly=true
 User=odoo14
 Group=odoo14
 ExecStart=/opt/odoo14/odoo-venv/bin/python3 /opt/odoo14/odoo/odoo-bin -c /etc/odoo14.conf
 StandardOutput=journal+console

 [Install]
 WantedBy=multi-user.target

Уведомляет systemd о существовании нового файла диска:

sudo systemctl daemon-reload

Запустите службу Odoo и включите ее запуск при запуске, выполнив:

sudo systemctl enable --now odoo14

Проверить статус услуги:

sudo systemctl status odoo14

Вывод должен выглядеть следующим образом, указывая на то, что служба Odoo запущена и работает.

● odoo14.service - Odoo14
 Loaded: loaded (/etc/systemd/system/odoo14.service; enabled; vendor preset: enabled)
 Active: active (running) since Sat 2020-10-17 19:25:47 CEST; 2s ago
 Main PID: 11987 (python3)
 Tasks: 4 (limit: 2286)
 Memory: 82.2M
 CGroup: /system.slice/odoo14.service
 └─11987 /opt/odoo14/odoo-venv/bin/python3 /opt/odoo14/odoo/odoo-bin -c /etc/odoo14.conf

Чтобы просмотреть сообщения, записанные службой Odoo, используйте следующую команду:

sudo journalctl -u odoo14

Протестируйте установку

Откройте браузер и введите: http://TUO_DOMINIO_O_IP:8069, вы должны увидеть страницу конфигурации Odoo 14.

Настройте Nginx в качестве прокси-сервера завершения SSL.

Веб-сервер Odoo по умолчанию предлагает трафик через HTTP. Чтобы сделать дистрибутив Odoo более безопасным, мы настроим Nginx в качестве прокси-сервера завершения SSL, который будет обслуживать трафик через HTTPS.

Прокси-сервер завершения SSL — это прокси-сервер, который обрабатывает шифрование/дешифрование SSL. Это означает, что завершающий прокси-сервер (Nginx) будет обрабатывать и расшифровывать входящие соединения TLS (HTTPS) и передавать незашифрованные запросы во внутреннюю службу (Odoo). Трафик между Nginx и Odoo не будет шифроваться (HTTP).

Использование обратного прокси -сервера предлагает множество преимуществ, таких как балансировка нагрузки, терминация SSL, кэширование, сжатие, доставка статического контента и многое другое.

Прежде чем продолжить работу с этим разделом, убедитесь, что выполнены следующие предварительные условия:

Доменное имя, указывающее на IP-адрес вашего общедоступного сервера. Мы будем использовать example.com.
Установите Nginx на Ubuntu 20.04.

Откройте текстовый редактор и создайте/отредактируйте блок доменного сервера:

sudo nano /etc/nginx/sites-enabled/example.com

Следующая конфигурация настраивает завершение SSL, перенаправление с HTTP на HTTPS, перенаправление с WWW на не WWW, кэширует статические файлы и включает сжатие GZip.

# Odoo servers
 upstream odoo {
 server 127.0.0.1:8069;
 }

 upstream odoochat {
 server 127.0.0.1:8072;
 }

 server {
 listen 80;
 server_name www.example.com example.com;

 proxy_read_timeout 720s;
 proxy_connect_timeout 720s;
 proxy_send_timeout 720s;

 # Proxy headers
 proxy_set_header X-Forwarded-Host $host;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_set_header X-Real-IP $remote_addr;


 # log files
 access_log /var/log/nginx/odoo.access.log;
 error_log /var/log/nginx/odoo.error.log;

 # Handle longpoll requests
 location /longpolling {
 proxy_pass http://odoochat;
 }


 # Handle /requests
 location /{
 proxy_redirect off;
 proxy_pass http://odoo;
 }

 # Cache static files
 location ~* /web/static/{
 proxy_cache_valid 200 90m;
 proxy_buffering on;
 expires 864000;
 proxy_pass http://odoo;
 }


 # Gzip
 gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
 gzip on;
 }

Не забудьте заменить example.com своим доменом.

Теперь вам нужно установить SSL-сертификаты с помощью Let’s Encrypt на Nginx. Сертификаты будут установлены и настроены автоматически.

Когда закончите, перезапустите службу Nginx:

sudo systemctl restart nginx

Далее нам нужно настроить Odoo для использования прокси. Для этого откройте файл конфигурации и добавьте следующую строку:

sudo nano /etc/odoo14.conf

proxy_mode = True

Перезапустите службу Odoo, чтобы изменения вступили в силу:

sudo systemctl restart odoo14

На этом этапе обратный прокси-сервер настроен, и вы можете получить доступ к своему экземпляру Odoo по адресу: https://example.com.

Изменить интерфейс привязки

Этот шаг необязателен, но это хорошая практика безопасности.

По умолчанию сервер Odoo прослушивает порт 8069 на всех интерфейсах. Чтобы отключить прямой доступ к экземпляру Odoo, вы можете заблокировать порт 8069 для всех общедоступных интерфейсов или заставить Odoo прослушивать только локальный интерфейс.

Мы настроим Odoo только для прослушивания 127.0.0.1. Откройте файл конфигурации и добавьте следующие две строки в конец файла:

sudo nano /etc/odoo14.conf

xmlrpc_interface = 127.0.0.1
 netrpc_interface = 127.0.0.1

Сохраните файл конфигурации и перезапустите сервер Odoo, чтобы изменения вступили в силу:

sudo systemctl restart odoo14

Включить многопроцессорность

По умолчанию Odoo работает в многопоточном режиме. Для производственных развертываний рекомендуется переключиться на многопроцессорный сервер, так как это повышает стабильность и позволяет лучше использовать системные ресурсы.

Чтобы включить многопроцессорность, вам нужно изменить конфигурацию Odoo и установить ненулевое количество рабочих процессов. Количество воркеров рассчитывается исходя из количества ядер ЦП в системе и доступной оперативной памяти.

Согласно официальной документации Odoo для расчета количества воркеров и необходимого объема оперативной памяти можно использовать следующие формулы и допущения:

Расчет количества рабочих

Теоретическое максимальное количество рабочих = (system_cpus * 2) + 1
1 рабочий может обслуживать ~ = 6 одновременных пользователей
Хроны также требуют процессора

Расчет размера оперативной памяти

Будем считать, что 20% всех запросов — тяжелые запросы, а 80% — легкие запросы. Для тяжелых требований требуется около 1 ГБ ОЗУ, а для более легких требований — около 150 МБ ОЗУ.
Требуемая оперативная память = number_of_workers * ( (light_worker_ratio * light_worker_ram_estimation) + (heavy_worker_ratio * heavy_worker_ram_estimation) )

Если вы не знаете, сколько процессоров у вас в системе, используйте следующую команду grep:

grep -c ^processor /proc/cpuinfo

Допустим, у вас есть система с 4 ядрами ЦП, 8 ГБ ОЗУ и 30 одновременными пользователями Odoo.

30 users /6 = **5** (5 — теоретическое необходимое количество рабочих)
(4 * 2) + 1 = **9** (9 — теоретическое максимальное количество рабочих)

Исходя из приведенного выше расчета, для cron можно использовать 5 воркеров + 1 воркер, всего 6 воркеров.

Рассчитаем потребление оперативной памяти исходя из количества воркеров:

RAM = 6 * ((0.8*150) + (0.2*1024)) ~= 2 GB of RAM

Расчет показывает, что для установки Odoo потребуется около 2 ГБ оперативной памяти.

Чтобы переключиться в многопроцессорный режим, откройте файл конфигурации и добавьте рассчитанные значения:

sudo nano /etc/odoo14.conf

limit_memory_hard = 2684354560
 limit_memory_soft = 2147483648
 limit_request = 8192
 limit_time_cpu = 600
 limit_time_real = 1200
 max_cron_threads = 1
 workers = 5

Перезапустите службу Odoo, чтобы изменения вступили в силу:

sudo systemctl restart odoo14

Остальные системные ресурсы будут использоваться другими службами, работающими в этой системе. В этом руководстве мы установили Odoo вместе с PostgreSQL и Nginx на один сервер. В зависимости от вашей конфигурации на сервере могут работать другие службы.

Вывод

В этом руководстве вы познакомились с установкой Odoo 14 на Ubuntu 20.04 LTS в виртуальной среде Python с использованием Nginx в качестве обратного прокси-сервера. Мы также показали вам, как включить многопроцессорность и оптимизировать Odoo для производственной среды.