======Как развернуть сервис 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 интерфейса:

=== Пример настроек сетевого интерфейса ===
<code>[Netdev]
Name=ens160
Kind=vlan

[VLAN]
Id=20 </code>

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


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

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

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

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

<code>apt-get update
apt-get dist-upgrade
apt-get update-kernel </code>
(перед обновлением kernel нужно установить данную утилиту, перед этим указав нужный репозиторий)
=== Установить необходимые пакеты: Установите веб-сервер, Git и другие необходимые инструменты: ===


<code>apt install apache2 git python3 </code>
==== 3. Настройка подключения к Git ====

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

== Перейдите в каталог .ssh/: ==
<code>cd ~/.ssh/ </code>
Создайте ключ:

<code>ssh-keygen</code>
Скопируйте публичный ключ и добавьте его в ваш профиль Git на сервере.
=== Настройте конфигурацию для Git: Создайте или отредактируйте файл ~/.ssh/config с такими параметрами: ===

<code>
Host git.sharix-app.org
    Hostname git.sharix-app.org
    User Denis
    Port 300 </code>
=== Проверьте подключение: Используйте команду: ===


<code>ssh -vv git.sharix-app.org </code>
Если все настроено правильно, вы получите сообщение "publickey succeeded".

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

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


<code>cd /etc/apache2/sites-available/ </code>
=== Создайте конфиг для вашего веб-приложения: ===


<code>sudo vim guide.conf </code>
=== Пример конфига: ===



<code><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> </code>
=== Активировать конфиг и перезапустить Apache: ===


<code>a2ensite guide.conf
systemctl restart apache2 </code>
==== 5. Клонирование репозитория и настройка окружения ====

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


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

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


<code>./bin/install.sh </code>
(после первого выполнения он создаст файл install.cfg, заполните его по примеру install.cfg.example)
=== Создать виртуальное окружение для проекта: ===

(окружение venv встроенно в python3)
<code>python3 -m venv venv
source venv/bin/activate </code>


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

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

<code>apt install postgresql17 </code>

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

=== Войдите в PostgreSQL: ===

<code>psql -U postgres</code>
=== Создайте пользователя: ===

<code>CREATE USER YOURUSER WITH PASSWORD 'yourpassword'; </code>
=== Создайте базу данных: ===

<code>CREATE DATABASE НАЗВАНИЕ БД OWNER YOURUSER; </code>
=== Настроить PostgreSQL: ===

<code>nano /etc/postgresql/12/main/pg_hba.conf </code>
=== Убедитесь, что в нем присутствует запись: ===

<code>host    all             all             0.0.0.0/0            md5 </code>
=== Перезапустите PostgreSQL: ===

<code>systemctl restart postgresql </code>
==== 7. Запуск и перезапуск сервиса ====

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

<code>systemctl start sharix_open.service </code>
=== Проверьте статус: ===

<code>systemctl status sharix_open.service </code>
=== Перезапуск после изменений: Если необходимо, перезапустите сервис: ===

<code>systemctl restart sharix_open.service </code>
==== 8. Отладка ====

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

<code>journalctl -u sharix_open.service </code>
=== Для остановки ненужных процессов: ===

<code>ps aux | grep gunicorn
kill <pid> </code>
===== Заключение =====
После выполнения всех шагов ваш сервис будет готов к работе. Убедитесь, что все сервисы, такие как PostgreSQL, Apache и Django, работают корректно и не конфликтуют между собой.