ShariX Open Docs

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======Как развернуть сервис ShariX Open на Debian 12 ======
1. Установить виртуальные машины в соответствии со схемой развертывания сети.\\
2. Настроить сеть внутри виртуальной машины в соответствии с выбранным сценарием - Development или Production
3. Перенести на виртуальную машину код для развертывания\\
4. Создать БД для функционирования сервиса (если ее нет) для подключения к программному продукту. Рекомендуется использовать PostgreSQL\\
5. Подготовить Django-проект к запуску\\
6. Настроить сервисы (веб-сервер, XMPP-сервер и тп)\\

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

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

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



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

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

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

[VLAN]
Id=20 </code>

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


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

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

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

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

<code>apt update
apt dist-upgrade
update-kernel </code>
=== Установить необходимые пакеты: Установите веб-сервер, Git и другие необходимые инструменты: ===


<code>apt install apache2 git python3 python3-venv python3-pip </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>

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


<code>python3 -m venv venv
source venv/bin/activate </code>


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

=== Установить PostgreSQL: ===

<code>apt install postgresql </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, работают корректно и не конфликтуют между собой.