> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/07-server-services.md).

# Управление службами

Проверьте состояние служб, выполните разрешённое действие и разберите журнал без доступа к shell

## Что вы получите

Администратор видит состояние разрешённых служб обменника, отличает безопасное чтение от управляющего действия и умеет подтвердить запуск, остановку или перезапуск через системный агент. Все действия остаются в журнале.

Откройте **«Утилиты» — «Службы»**.

## Разделите права

| Право роли          | Возможность                                                  |
| ------------------- | ------------------------------------------------------------ |
| Просмотр служб      | Видеть состояние и журнал без кнопок управления              |
| Управление службами | Выполнять только действия, разрешённые для конкретной службы |

Глобальный режим чтения и учётная запись администратора **«Только чтение»** также скрывают управляющие действия. Оператору заявок обычно достаточно просмотра.

{% hint style="danger" %}
Остановка Horizon, Frontend, Reverb, Redis или Cron влияет на заявки, уведомления, клиентский сайт или фоновые задачи. Не нажимайте действие только ради проверки кнопки. Для контрольной проверки используйте согласованное окно и службу, воздействие которой заранее понятно.
{% endhint %}

## Прочитайте вкладку «Состояние служб»

Таблица показывает:

* название и текущее состояние;
* время работы или результат последнего одноразового запуска;
* использование памяти и число перезапусков, когда они применимы;
* последний и следующий запуск для расписания;
* только разрешённые действия;
* время наблюдения агентом.

| Состояние                   | Что делать                                            |
| --------------------------- | ----------------------------------------------------- |
| Работает                    | Сверить стабильность, время работы и перезапуски      |
| Запускается                 | Подождать подтверждённого конечного состояния         |
| Нестабильно / Есть проблемы | Прочитать подробность и журнал до действия            |
| Остановлена / Отключена     | Уточнить, запланировано ли это состояние              |
| Ошибка                      | Не скрывать перезапуском без поиска причины           |
| Обслуживание                | Проверить активное обновление или регламентную работу |
| Неизвестно                  | Проверить связь с системным агентом                   |

## Знайте границы управления

| Служба                            | Доступные действия                   |
| --------------------------------- | ------------------------------------ |
| Frontend, Horizon, Reverb         | Запустить, остановить, перезапустить |
| Сбор данных Pulse, Проверка Pulse | Запустить, остановить, перезапустить |
| Планировщик Laravel               | Запустить сейчас                     |
| PHP-FPM, Redis                    | Перезапустить                        |
| Cron                              | Запустить, остановить, перезапустить |
| Агент обновлений                  | Только просмотр                      |
| Резервное копирование             | Только просмотр последнего запуска   |
| Расписание резервных копий        | Включить или отключить расписание    |

Nginx, PostgreSQL, Certbot и произвольные systemd-службы намеренно не управляются из панели. Laravel не получает `sudo`, shell-команду или возможность ввести имя службы.

## Выполните разрешённое действие

{% stepper %}
{% step %}

### Зафиксируйте исходное состояние

Запишите службу, состояние, время наблюдения, память, перезапуски и затронутые функции. Проверьте отсутствие активного обновления.
{% endstep %}

{% step %}

### Нажмите только нужное действие

Панель показывает кнопки согласно доверенному каталогу агента. Остановка и отключение расписания дополнительно предупреждают о временной недоступности функций.
{% endstep %}

{% step %}

### Подтвердите диалог

Сверьте точную службу и действие. После подтверждения не закрывайте прогресс и не нажимайте кнопку повторно.
{% endstep %}

{% step %}

### Дождитесь итогового состояния

Панель выполняет действие и повторно проверяет службу. Успешное сообщение без ожидаемого нового состояния требует дополнительной диагностики.
{% endstep %}

{% step %}

### Проверьте зависимый контур

После Horizon проверьте очередь, после Frontend — клиентский сайт, после Reverb — живые обновления и чат, после Cron или планировщика — ближайшую плановую задачу.
{% endstep %}
{% endstepper %}

Если связь оборвалась после отправки, окно сначала восстанавливает сохранённый результат по тому же ключу и не повторяет системное действие. Не открывайте вторую вкладку для ещё одного перезапуска.

## Работайте с резервными копиями правильно

Строка **«Резервное копирование»** показывает результат одноразовой systemd-задачи, но не запускает её из этого экрана. **«Расписание резервных копий»** позволяет включить или отключить будущие автоматические запуски.

Отключение расписания:

* не удаляет уже созданные копии;
* не доказывает возможность восстановления;
* не останавливает уже начатую задачу;
* требует причины, срока и ответственного за обратное включение.

Создание, проверка и `restore-test` выполняются специалистом штатным `iexctl` либо утверждённым регламентом. До обновления или рискованного изменения нужна свежая проверенная копия, а не только включённый таймер.

## Проверьте журнал действий

Откройте вкладку **«Журнал действий»** и сверьте:

* службу и действие;
* администратора или системного исполнителя;
* дату и время;
* результат **«Выполнено»** или **«Ошибка»**;
* последующее состояние службы.

Журнал доказывает отправку и результат действия агента, но конечную работу бизнес-функции нужно проверить отдельно.

## Если агент недоступен

1. Не повторяйте управляющее действие.
2. Обновите страницу один раз и проверьте **«Агент обновлений»**.
3. Откройте [раздел «Обновления»](https://docs.iexexchanger.com/learn/9.-sistema-i-rasshireniya/06-system-updates.md) только для чтения состояния.
4. Передайте специалисту точное время, службу, действие и сообщение без секретов.
5. Специалист проверяет `iexctl doctor` и read-only состояние служб на сервере.
6. После восстановления перечитайте журнал и только затем принимайте решение о новом действии.

## Этап завершён, если

* [ ] права просмотра и управления разделены;
* [ ] роль только для чтения не видит действий;
* [ ] состояние каждой основной службы понятно;
* [ ] команда знает точный разрешённый набор действий;
* [ ] остановка или перезапуск выполняются только в согласованном окне;
* [ ] потеря ответа не приводит к повторному слепому действию;
* [ ] зависимый клиентский или фоновый контур проверен;
* [ ] расписание копий не перепутано с созданием и восстановлением копии;
* [ ] журнал содержит сотрудника, время, действие и результат;
* [ ] Nginx, PostgreSQL и произвольные команды не ищутся на этом экране.

После проверки служб запустите [полную диагностику системы](https://docs.iexexchanger.com/learn/10.-zapusk/14-system-diagnostics.md).
