Различия

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

--- open:tech:admin:instrukcija_po_zapusku_sharix_open [2023/06/01 07:24] – [Установка и настройка системы заявок 'sharix-open-tickets'] 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/<директория с приложением>
@@ Строка 474: / Строка 491: @@
 <code> apt-get install python3 </code>
+Устанавливаем модуль джанго.\\
+<code> apt-get install python3-module-django </code>
 Venv - apt-get install python3-module-virtualenv\\
@@ Строка 489: / Строка 510: @@
 **Последовательность установки и настройки:**
 \\
-. Скачать репозиторий:
+. Скачать репозиторий:\\
 <code>
 git clone -b tickets_module http://git.sharix-app.org/ShariX_Open/sharix-open-tickets.git tickets
 </code>
-. Важный момент:
+. Важный момент:\\
 <code> git checkout master </code>
 . Выполнить шаги, описанные в инструкции по установке из файла 'README.md'.\\
-\\
+. Сгенерировать виртуальное окружение:\\
-. Сгенерировать виртуальное окружение:
 <code>python3 -m venv tickets</code>
-Проверить его создание (в директории должен появиться каталог 'tickets'):
+Проверить его создание (в директории должен появиться каталог 'tickets'):\\
 <code>ls</code>
-\\
-. Добавить в файл '.gitignore' исключения для Git, что не следует отправлять (пароли, логины, что-то еще столь же ценное и важное).
+. Добавить в файл '.gitignore' исключения для Git, что не следует отправлять (пароли, логины, что-то еще столь же ценное и важное).\\
-Для создания и редактирования файла использовать любой текстовый редактор, например, vim:
-\\
+Для создания и редактирования файла использовать любой текстовый редактор, например, vim:\\
 <code>vim .gitignore</code>
-Пример содержимого файла:
+Пример содержимого файла:\\
 <code>
     # Virtualenv
@@ Строка 522: / Строка 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, так как для них могут использоваться разные версии пакетов.\\
-\\
-. Установка зависимостей.
+. Установка зависимостей.\\
 Файл 'requirements.txt' содержит перечень зависимостей (пакетов ОС), необходимых для корректной работы приложения.
-Устанавливаем пакеты в окружение:
+Устанавливаем пакеты в окружение:\\
-<code>pip install -r requirements.txt</code>\\
-Если pip ругается на устаревшую версию - обновить его следующей командой:
+<code> pip3 install -r requirements.txt </code>\\
-<code>pip install --upgrade pip</code>
+Если pip ругается на устаревшую версию - обновить его следующей командой:\\
+<code> pip3 install --upgrade pip </code>
 . Установить в окружение сервер СУБД, инициализировать его, создать пользователя и БД.
 Делается это идентично установке СУБД виртуальной машины, как описано выше в разделе Как создать БД?.
-Необходимо устанавливать postgreSQL версии 15:
+Необходимо устанавливать postgreSQL версии 15:\\
 <code>
 apt-get install postgresql15-server
@@ Строка 558: / Строка 589: @@
 <code>vim var/lib/pgsql/data/pg_hba.conf</code>
-Для того, чтобы остановить виртуальное окружение, использовать команду:
+Для того, чтобы остановить виртуальное окружение, использовать команду:\\
 <code>
 cd sharix-open-tickets\
@@ Строка 574: / Строка 606: @@
 Для проверки нужно будет написать команду reboot и если у вас не запускается проект, значит какой-то сервис не включен.\\
-Команды linux:
+Команды linux:\\
 .	Move – либо перенести файл, либо изменить его название.\\
@@ Строка 592: / Строка 624: @@
 Эта команда может понадобиться, чтобы дать право на исполнение.\\
-u -права для user\\
+<code> chmod </code>
+u - права для user\\
 <code> chmod u+x  </code>
 g – права для group\\
 a – права для всех\\
 А после + идут права на:\\
 x – исполнение\\
 w – запись\\
 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 процессов на сервис.
+Далее запустить сервис штатно.