Различия

Показаны различия между двумя версиями страницы.

--- open:tech:admin:instrukcija_po_zapusku_sharix_open [2023/06/02 09:25] – [Установка минимальных пакетов для развертывания решения] alexey.kanavichev
+++ open:tech:admin:instrukcija_po_zapusku_sharix_open [2025/04/28 09:27] (текущий) – sharixadmin
@@ Строка 1: / Строка 1: @@
-====== Как развернуть сервис ======
+====== Как развернуть сервис ShariX Open ======
+[[open:tech:admin:install:developers|Инструкция для продвинутых разработчиков]]
 . Установить виртуальные машины в соответствии со схемой развертывания сети (рекомендуемый вариант по умолчанию - ALT Linux P10.1)\\
@@ Строка 8: / Строка 10: @@
 . Настроить сервисы (веб-сервер, XMPP-сервер и тп)\\
+[[open:tech:admin:install:debian|Особенности установки на Debian]]
+[[open:tech:admin:install:astra|Особенности установки на Astra]]
+[[open:tech:admin:install:fedora|Особенности установки на Fedora]]
+[[open:tech:admin:install:redos|Особенности установки на Red OS]]
+[[open:tech:admin:install:altlinux|Особенности установки на ALT Linux]]
+[[open:tech:admin:install:test-guide| <del>Тестовый гайд</del>]]
 ====== Полезные знания для процесса разворачивания сервиса ======
@@ Строка 160: / Строка 173: @@
 <code> vim guide.conf </code>
-Вставляем config\\
+Вставляем готовый текст конфига или создаем вручную:\\
-  * порт - 80 (система за пределами джинкса) или 443 (порт для https, то есть для защищенного соединения с помощью сертификата)\\
+  * После заголовка **VirtualHost** указывается адрес хоста и через двоеточие - порт, например: **80** (стандартный порт **http**, система за пределами Nginx) или **443** (стандартный порт **https** - для защищенного соединения, где идентификация подлинности сервера на клиенте производится с помощью сертификата, а трафик шифруется с использованием протокола TLS или устаревшего SSL). Вместо конкретного адреса можно использовать замещающий символ "*". Адрес в формате IPv6 необходимо указывать в квадратных скобках.\\
-  * ServerAdmin - почта администратора;
+  * **ServerAdmin** - электронная почта администратора сервера;
-  * ServerName - основной домен, по которому идет подключение по сети
+  * **ServerName** - основное доменное имя сервера;
-  * ServerAlias - “поддомен”/можно дублировать ServerName (*.sharix-app.org)
+  * **ServerAlias** - алиас (псевдоним) имени сервера 'ServerName';
-  * DocumentRoot - переместить директорию, где все собрано /var/www/webapps/<директория с приложением> (создаете и указываете свою директорию)
+  * **DocumentRoot** - корневая директория виртуального хоста - необходимо указать директорию, где будет размещено web-приложение, например: '/var/www/webapps/<директория с приложением>';
+  * **ErrorLog** - полный путь и имя файла журнала ошибок;
+  * **CustomLog** - полный путь и имя файла журнала доступа к серверу;
+  * **AddDefaultCharset** - кодировка по умолчанию, например: 'utf-8'.
-Далее его сохраняем wq\\
+Далее - сохраняем конфиг и выходим из редактора (команда 'wq')\\
 === Пример конфига Apache ===
 <code>
-<VirtualHost <адрес хоста>:80; <адрес хоста>:443>
+<VirtualHost <адрес хоста>:80>
         ServerAdmin web@webserver.local
         DocumentRoot /var/www/webapps/<директория с приложением>
@@ Строка 532: / Строка 549: @@
     *.py[cod]
     *$py.class
-*.py
-    #migrations
+    # Django
     migrations/
-    !migrations/__init__.py
 </code>\\
 . После того как скачали репозиторий и все пакеты, перейти в созданное окружение:\\
-<code>source tickets/bin/activate</code>
+<code> source tickets/bin/activate </code>
 Теперь вы находитесь внутри созданного окружения. Это нужно для того, чтобы не было проблем с разными версиями в разных проектах на Django, так как для них могут использоваться разные версии пакетов.\\
@@ Строка 550: / Строка 565: @@
 Устанавливаем пакеты в окружение:\\
-<code>pip install -r requirements.txt</code>\\
+<code> pip3 install -r requirements.txt </code>\\
 Если pip ругается на устаревшую версию - обновить его следующей командой:\\
-<code>pip install --upgrade pip</code>
+<code> pip3 install --upgrade pip </code>
@@ Строка 627: / Строка 642: @@
 r – чтение\\
 Также права можно отзывать используя -, вместо +\\
-**Если есть какие-либо вопросы, то можно обращаться к Денису Петрову.**
+===== Запуск, перезапуск и отладка =====
+. Уточнить имя сервиса.
+<code>ls /etc/systemd/system/</code>
+. Штатный запуск:
+<code>systemctl start sharix_open.service</code>
+Проверить статус или остановить - это status или stop.
+Чтобы запустить gunicorn "на коленке" для проверки ошибок:
+<code>кореньпроекта/bin/webuser.sh</code>
+Если не перезапускается - возможно, лишние процессы gunicorn.
+Посмотреть:
+<code># ps aux | grep gun</code>
+Убить ненужные - команда kill и номер процесса, в нормальном состоянии от 2 процессов на сервис.
+Далее запустить сервис штатно.