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

Введение

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

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

Установка Odoo в виртуальной среде или развертывание в виде контейнера Docker дает вам больший контроль над приложением и позволяет запускать несколько экземпляров Odoo в одной системе.

В этой статье рассказывается об установке и развертывании Odoo 15 в виртуальной среде Python на Ubuntu 20.04. Мы загрузим 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

Установить зависимости

Первый шаг — установить Git, Pip, Node.js и инструменты, необходимые для компиляции Odoo:

sudo apt update

sudo apt install git python3-pip build-essential wget python3-dev python3-venv \
 python3-wheel libfreetype6-dev libxml2-dev libzip-dev libldap2-dev libsasl2-dev \
 python3-setuptools node-less libjpeg-dev zlib1g-dev libpq-dev \
 libxslt1-dev libldap2-dev libtiff5-dev libjpeg8-dev libopenjp2-7-dev \
 liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev

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

Запуск Odoo с правами root представляет большую угрозу безопасности. Мы создадим нового системного пользователя и группу с домашним каталогом /opt/odoo15, который будет запускать службу Odoo. Для этого выполните следующую команду:

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

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

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

Odoo использует PostgreSQL в качестве базы данных. PostgreSQL включен в стандартные репозитории Ubuntu. Установка проста:

sudo apt install postgresql

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

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

Установить wkhtmltopdf

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

Версия wkhtmltopdf, включенная в репозитории Ubuntu, не поддерживает верхние и нижние колонтитулы. Рекомендуемая версия для Odoo — версия 0.12.5. Мы скачаем и установим пакет с Github:

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

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

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

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

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

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

sudo su - odoo15

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

git clone https://www.github.com/odoo/odoo --depth 1 --branch 15.0 /opt/odoo15/odoo

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

cd /opt/odoo15

python3 -m venv odoo-venv

Активируйте виртуальную среду:

source odoo-venv/bin/activate

Зависимости Odoo указаны в файле require.txt. Установите все необходимые модули Python с pip3:

pip3 install wheel

pip3 install -r odoo/requirements.txt

Installing Prerequisites

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

deactivate

Создайте новый каталог, отдельный каталог для сторонних надстроек:

mkdir /opt/odoo15/odoo-custom-addons

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

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

exit

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

sudo nano /etc/odoo15.conf

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

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

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

Юнит-файл — это файл конфигурации в стиле ini, который содержит информацию о сервисе.

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

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

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

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

 [Install]
 WantedBy=multi-user.target

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

sudo systemctl daemon-reload

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

sudo systemctl enable --now odoo15

Убедитесь, что служба запущена и работает:

sudo systemctl status odoo15

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

● odoo15.service - Odoo15
 Loaded: loaded (/etc/systemd/system/odoo15.service; enabled; vendor preset: enabled)
 Active: active (running) since Tue 2021-10-26 04:56:28 UTC; 18s ago...

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

sudo journalctl -u odoo15

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

Откройте браузер и введите: http://<your_domain_or_IP_address>:8069

Предполагая, что установка прошла успешно, появится экран, подобный следующему:

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

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

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

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

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

Доменное имя, указывающее на IP-адрес вашего общедоступного сервера. Мы будем использовать example.com.
Нгинкс установлен.
SSL-сертификат для вашего домена. Вы можете установить бесплатный SSL-сертификат Let's Encrypt.

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

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

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

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

 upstream odoochat {
 server 127.0.0.1:8072;
 }

 # HTTP -> HTTPS
 server {
 listen 80;
 server_name www.example.com example.com;

 include snippets/letsencrypt.conf;
 return 301 https://example.com$request_uri;
 }

 # WWW -> NON WWW
 server {
 listen 443 ssl http2;
 server_name www.example.com;

 ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
 ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
 include snippets/ssl.conf;
 include snippets/letsencrypt.conf;

 return 301 https://example.com$request_uri;
 }

 server {
 listen 443 ssl http2;
 server_name 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;

 # SSL parameters
 ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
 ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
 include snippets/ssl.conf;
 include snippets/letsencrypt.conf;

 # 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;
 }

/etc/nginx/sites-enabled/example.com.conf

Не забудьте заменить example.com своим доменом Odoo и указать правильный путь для файлов SSL-сертификата. Фрагменты, используемые в этой настройке, созданы в этом руководстве.

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

sudo systemctl restart nginx

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

proxy_mode = True

/etc/odoo15.conf

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

sudo systemctl restart odoo15

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

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

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

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

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

xmlrpc_interface = 127.0.0.1
 netrpc_interface = 127.0.0.1

/etc/odoo15.conf

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

sudo systemctl restart odoo15

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

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

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

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

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

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

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

Будем считать, что 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 — теоретическое максимальное количество рабочих)

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

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

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

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

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

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

/etc/odoo15.conf

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

sudo systemctl restart odoo15

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

Вывод

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

Вы также можете ознакомиться с нашим руководством по созданию автоматических ежедневных резервных копий баз данных Odoo.