Содержание

Как развернуть сервис ShariX Open на Alt Linux

1. Установить виртуальные машины в соответствии со схемой развертывания сети.
2. Настроить сеть внутри виртуальной машины в соответствии с выбранным сценарием - Development или Production 3. Перенести на виртуальную машину код для развертывания
4. Создать БД для функционирования сервиса (если ее нет) для подключения к программному продукту. Рекомендуется использовать PostgreSQL
5. Подготовить Django-проект к запуску
6. Настроить сервисы (веб-сервер, XMPP-сервер и тп)

Работа с виртуальной машиной

Установить виртуальные машины: Развертывание сети с использованием Proxmox или другой виртуализационной платформы. Рекомендуемые параметры для виртуальной машины:

CPU: 2 ядра
RAM: 4GB
HDD: 40GB

1. Установка виртуальных машин и настройка сети

При установке виртуальной машины на Alt, будет предложено настроить сетевые интерфейсы. Если DHCP не выдаст нужные параметры (Ip, Deafult gateway, Netmask) укажите их вручную соответственно схеме вашей сети.

Настроить сеть на виртуальной машине: Перейдите в /etc/systemd/network/ и создайте конфигурационный файл для сетевого интерфейса. Пример настройки VLAN интерфейса:

Пример настроек сетевого интерфейса

[Netdev]
Name=ens160
Kind=vlan

[VLAN]
Id=20

Здесь ens160 — это интерфейс, на котором работает VLAN 20.

2. Установка и настройка пакетов

После установки виртуальной машины необходимо обновить пакеты и установить необходимые зависимости:

Обновить источники пакетов и обновить систему:

P.S обновляем под Root 

apt-get update
apt-get dist-upgrade
apt-get update-kernel

(перед обновлением kernel нужно установить данную утилиту, перед этим указав нужный репозиторий)

Установить необходимые пакеты: Установите веб-сервер, Git и другие необходимые инструменты:

apt install apache2 git python3

3. Настройка подключения к Git

Настройте SSH-ключи для подключения к репозиториям:

Перейдите в каталог .ssh/:
cd ~/.ssh/

Создайте ключ: 

ssh-keygen

Скопируйте публичный ключ и добавьте его в ваш профиль Git на сервере.

Настройте конфигурацию для Git: Создайте или отредактируйте файл ~/.ssh/config с такими параметрами:

Host git.sharix-app.org
    Hostname git.sharix-app.org
    User Denis
    Port 300

Проверьте подключение: Используйте команду:

ssh -vv git.sharix-app.org

Если все настроено правильно, вы получите сообщение «publickey succeeded».

4. Установка и настройка веб-сервера

Настроить конфиг Apache: Перейдите в каталог:

cd /etc/apache2/sites-available/

Создайте конфиг для вашего веб-приложения:

sudo vim guide.conf

Пример конфига:

<VirtualHost *:80>
    ServerAdmin web@webserver.local
    DocumentRoot /var/www/webapps/<директория с приложением>
    ErrorLog /var/log/apache2/error_log
    CustomLog /var/log/apache2/access_log combined
    AddDefaultCharset utf-8
</VirtualHost>

Активировать конфиг и перезапустить Apache:

a2ensite guide.conf
systemctl restart apache2

5. Клонирование репозитория и настройка окружения

Клонировать репозиторий:

git clone -b unstable https://git.sharix-app.org/ShariX_Open/sharix-open-webapp-base.git
cd sharix-open-webapp-base

Выполнить скрипт:

./bin/install.sh

(после первого выполнения он создаст файл install.cfg, заполните его по примеру install.cfg.example)

Создать виртуальное окружение для проекта:

(окружение venv встроенно в python3) 

python3 -m venv venv
source venv/bin/activate

Укажите параметры подключения к базе данных. Настройте значения SECRET_KEY, ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS.

6. Установка и настройка базы данных PostgreSQL

Установить PostgreSQL (c указанием версии, например):

apt install postgresql17
Создать пользователя и базу данных:

Войдите в PostgreSQL:

psql -U postgres

Создайте пользователя:

CREATE USER YOURUSER WITH PASSWORD 'yourpassword';

Создайте базу данных:

CREATE DATABASE НАЗВАНИЕ БД OWNER YOURUSER;

Настроить PostgreSQL:

nano /etc/postgresql/12/main/pg_hba.conf

Убедитесь, что в нем присутствует запись:

host    all             all             0.0.0.0/0            md5

Перезапустите PostgreSQL:

systemctl restart postgresql

7. Запуск и перезапуск сервиса

Запустите сервис: После настройки и запуска, убедитесь, что сервис работает:

systemctl start sharix_open.service

Проверьте статус:

systemctl status sharix_open.service

Перезапуск после изменений: Если необходимо, перезапустите сервис:

systemctl restart sharix_open.service

8. Отладка

Для отладки ошибок используйте:

journalctl -u sharix_open.service

Для остановки ненужных процессов:

ps aux | grep gunicorn
kill <pid>

Заключение

После выполнения всех шагов ваш сервис будет готов к работе. Убедитесь, что все сервисы, такие как PostgreSQL, Apache и Django, работают корректно и не конфликтуют между собой.