Введение
Odoo — самое популярное в мире универсальное программное обеспечение для бизнеса. Он предлагает широкий спектр бизнес-приложений, включая CRM, веб-сайт, электронную коммерцию, выставление счетов, бухгалтерский учет, производство, склад, управление проектами, инвентаризацию и многое другое, все они легко интегрированы.
В этом руководстве объясняется, как установить Odoo 13 из исходного кода в виртуальной среде Python на компьютере с CentOS 8. Мы загрузим исходный код Odoo с Github и настроим Nginx в качестве обратного прокси-сервера.
Предпосылки
Вы должны войти в систему как root или пользователь с привилегиями sudo для завершения установки.
Если вы хотите установить 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
Установка зависимостей
Установите Python 3, Git, pip и все библиотеки и инструменты, необходимые для компиляции Odoo из исходного кода:
sudo dnf install python3 python3-devel git gcc redhat-rpm-config libxslt-devel bzip2-devel openldap-devel libjpeg-devel freetype-devel
Создать системного пользователя
Создайте нового пользователя и системную группу с домашним каталогом /opt/odoo
, который будет запускать службу Odoo:
sudo useradd -m -U -r -d /opt/odoo13 -s /bin/bash odoo13
Вы можете назвать пользователя как хотите, просто убедитесь, что вы создали пользователя PostgreSQL с таким же именем.
Установите и настройте PostgreSQL.
Теперь установим PostgreSQL 10 из стандартного репозитория CentOS 8:
sudo dnf install @postgresql:10
После завершения установки создайте новый кластер базы данных PostgreSQL:
sudo postgresql-setup initdb
Включите и запустите службу PostgreSQL:
sudo systemctl enable --now postgresql
Создайте пользователя PostgreSQL с тем же именем, что и ранее созданный системный пользователь, в нашем случае это «odoo13»:
sudo su - postgres -c "createuser -s odoo13"
Установить Wkhtmltopdf
Пакет wkhtmltox
предоставляет набор инструментов командной строки с открытым исходным кодом, способных преобразовывать HTML в PDF и различные форматы изображений. Для печати отчетов в формате PDF вам понадобится инструмент wkhtmltopdf
. Рекомендуемая версия для Odoo — 0.12.5
, ее нет в официальных репозиториях CentOS 8.
Установите пакет rpm
с Github, набрав:
sudo dnf install https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos8.x86_64.rpm
Установка и настройка Odoo 13
Прежде чем приступить к процессу установки, зайдите к пользователю «odoo13»:
sudo su - odoo13
Начните с клонирования исходного кода Odoo 13 из репозитория Odoo GitHub:
git clone https://www.github.com/odoo/odoo --depth 1 --branch 13.0 /opt/odoo13/odoo
Перейдите в каталог /opt/odoo13
и создайте новую виртуальную среду Python для установки Odoo:
cd /opt/odoo13
python3 -m venv venv
Активируйте среду с помощью source
команды:
source venv/bin/activate
Установите необходимые модули Python:
pip3 install -r odoo/requirements.txt
Installing Dependencies
После завершения установки деактивируйте среду:
deactivate
Создайте новый каталог для пользовательских надстроек:
mkdir /opt/odoo13/odoo-custom-addons
Вернитесь к своему пользователю sudo:
exit
Затем откройте текстовый редактор и создайте файл конфигурации. В этом руководстве мы используем nano, если вы предпочитаете, вы можете использовать vi, установленный по умолчанию в большинстве дистрибутивов.
sudo dnf install nano
sudo nano /etc/odoo13.conf
[options]
; This is the password that allows database operations:
admin_passwd = superadmin_passwd
db_host = False
db_port = False
db_user = odoo13
db_password = False
addons_path = /opt/odoo13/odoo/addons, /opt/odoo13/odoo-custom-addons
Сохраните и закройте файл, нажав CTRL + X, затем Y, чтобы сохранить изменения, а затем ENTER, если вы используете nano.
Не забудьте изменить superadmin_passwd
на более безопасный.
Создайте файл диска Systemd
Откройте текстовый редактор и создайте файл с именем odoo13.service
внутри каталога /etc/systemd/system/
:
sudo nano /etc/systemd/system/odoo13.service
Вставьте следующее содержимое:
[Unit]
Description=Odoo13
Requires=postgresql.service
After=network.target postgresql.service
[Service]
Type=simple
SyslogIdentifier=odoo13
PermissionsStartOnly=true
User=odoo13
Group=odoo13
ExecStart=/opt/odoo13/venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
StandardOutput=journal+console
[Install]
WantedBy=multi-user.target
Сохраните файл и закройте редактор.
Уведомляет Systemd о существовании нового файла диска:
sudo systemctl daemon-reload
Запустите и включите службу Odoo, выполнив:
sudo systemctl enable --now odoo13
Вы можете проверить статус службы с помощью следующей команды:
sudo systemctl status odoo13
● odoo13.service - Odoo13
Loaded: loaded (/etc/systemd/system/odoo13.service; enabled; vendor preset: disabled)
Active: active (running) since Mon 2020-01-27 23:42:05 CET; 2s ago
Main PID: 32025 (python3)
Tasks: 4 (limit: 12251)
Memory: 92.0M
CGroup: /system.slice/odoo13.service
└─32025 /opt/odoo13/venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
Чтобы просмотреть сообщения, записанные службой Odoo, используйте следующую команду:
sudo journalctl -u odoo13
Протестируйте установку
Откройте браузер и введите: http://DOMINIO_O_INDIRIZZO_IP:8069
Если установка прошла успешно, отобразится конфигурация Odoo.
Если вы не можете получить доступ к странице, ваш брандмауэр, вероятно, блокирует порт 8069
.
Используйте следующие команды, чтобы открыть нужную дверь:
sudo firewall-cmd --permanent --zone=public --add-port=8069/tcp
sudo firewall-cmd --reload
Настройте 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/conf.d/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;
}
# HTTP -> HTTPS
server {
listen 80;
server_name www.example.com example.com;
location ^~ /.well-known/acme-challenge/{
allow all;
root /var/lib/letsencrypt/;
default_type "text/plain";
try_files $uri =404;
}
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;
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;
# 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;
}
location ^~ /.well-known/acme-challenge/{
allow all;
root /var/lib/letsencrypt/;
default_type "text/plain";
try_files $uri =404;
}
# Gzip
gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
gzip on;
}
Когда закончите, перезапустите службу Nginx:
sudo systemctl restart nginx
Далее нам нужно настроить Odoo для использования прокси. Для этого откройте файл конфигурации:
sudo nano /etc/odoo13.conf
Добавьте следующую строку:
proxy_mode = True
Сохраните и закройте файл.
Перезапустите службу Odoo, чтобы изменения вступили в силу:
sudo systemctl restart odoo13
На этом этапе обратный прокси-сервер настроен, и вы можете получить доступ к своему экземпляру Odoo по адресу: https://example.com
.
Изменить интерфейс привязки
Этот шаг необязателен, но это хорошая практика безопасности.
По умолчанию сервер Odoo прослушивает порт 8069
на всех интерфейсах. Чтобы отключить прямой доступ к экземпляру Odoo, вы можете заблокировать порт 8069
для всех общедоступных интерфейсов или заставить Odoo прослушивать только локальный интерфейс.
Мы настроим Odoo только для прослушивания 127.0.0.1
. Откройте конфигурацию:
sudo nano /etc/odoo13.conf
Добавьте следующие две строки в конец файла:
xmlrpc_interface = 127.0.0.1
netrpc_interface = 127.0.0.1
Сохраните файл конфигурации и перезапустите сервер Odoo, чтобы изменения вступили в силу:
sudo systemctl restart odoo13
Включить многопроцессорность
По умолчанию 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 — теоретическое максимальное количество рабочих)
Исходя из приведенного выше расчета, для cron можно использовать 5 воркеров + 1 воркер, всего 6 воркеров.
Рассчитаем потребление оперативной памяти исходя из количества воркеров:
RAM = 6 * ((0.8*150) + (0.2*1024)) ~= 2 GB of RAM
Расчет показывает, что для установки Odoo потребуется около 2 ГБ оперативной памяти.
Чтобы переключиться в многопроцессорный режим, откройте файл конфигурации:
sudo nano /etc/odoo13.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 odoo13
Остальные системные ресурсы будут использоваться другими службами, работающими в этой системе. В этом руководстве мы установили Odoo вместе с PostgreSQL и Nginx на один сервер. В зависимости от вашей конфигурации на сервере могут работать другие службы.
Вывод
В этом руководстве вы познакомились с установкой Odoo 13 на CentOS 8 в виртуальной среде Python с использованием Nginx в качестве обратного прокси-сервера. Мы также показали вам, как включить многопроцессорность и оптимизировать Odoo для производственной среды.