> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Конфигурации и контроль расхождений

> Утверждённые файлы, применение содержимого и прав, проверка состояния, drift и восстановление.

Для повторяемой настройки парка Telepúrte использует сохранённый файл каталога и точное действие над путём на ноде. Можно применить утверждённое содержимое или только проверить, что сервер ему соответствует.

Это отличается от ручного [редактора Web SFTP](https://docs.axottle.com/ru/telepurte/files.md): редактор работает с текущим файлом, а плейбук связывает конкретный артефакт с целями и сохраняет результаты запуска.

## Подготовить утверждённый файл

В **Плейбуки и расписания** добавьте файл в каталог. Укажите понятное имя, например `app.conf`, и загрузите содержимое. Карточка сохраняет размер и контрольную сумму; материал хранится зашифрованным.

Перед первой заменой скачайте текущую конфигурацию с ноды и сохраните её как отдельную исходную версию. Каталог Telepúrte не создаёт автоматически резервную копию каждого файла, который будет перезаписан на сервере.

## Применить содержимое

Добавьте в плейбук **Применить конфигурационный файл** и задайте:

* артефакт из каталога;
* абсолютный путь, например `/etc/example/app.conf`;
* режим `0600`, `0640` или `0644` по требованиям приложения.

На ноде этот точный путь должен быть разрешён агенту. Дополнительно нужны права ОС и разрешение записи в системных ограничениях службы агента. Добавление пути в политику панели не делает защищённый каталог доступным автоматически.

Сначала запустите на тестовой ноде. Запись выполняется с проверкой содержимого и заменой файла; символические ссылки и небезопасные пути отклоняются. Существующий файл может быть заменён — это изменяющая операция.

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

## Проверить без изменения

Действие **Проверить конфигурационный файл** использует тот же артефакт, путь и режим, но не переписывает файл. Оно сравнивает содержимое и права.

| Результат | Значение |
| - | - |
| `unchanged` | Содержимое и режим совпадают с утверждёнными |
| `drifted` | Отличаются содержимое или права |
| `missing` | Файл отсутствует |
| Ошибка | Проверка не состоялась; это не доказательство совпадения или отсутствия |

Например, если текст совпал, но файл стал доступен всем вместо `0600`, проверка тоже обнаружит расхождение. Такая проверка удобна по расписанию и не требует регулярной перезаписи уже правильного файла.

## Пример рабочего цикла

1. Сохраните исходную конфигурацию тестовой машины.
2. Добавьте новую версию `app.conf` в каталог.
3. Создайте плейбук применения файла с точным путём и режимом.
4. Выполните его на тестовой ноде и проверьте приложение штатным валидатором.
5. Создайте отдельный читающий плейбук проверки того же артефакта.
6. Убедитесь в `unchanged`, затем настройте расписание проверки для рабочих целей.

При обнаружении `drifted` сначала определите, является ли изменение ошибкой или новым согласованным состоянием. Не исправляйте его автоматической перезаписью без понимания причины.

## История расхождений

Telepúrte сохраняет последнее успешное наблюдение по паре «нода + путь», ожидаемый артефакт, фактическую контрольную сумму, режим и время проверки. Событие перехода появляется при изменении состояния или утверждённой базы. Повтор того же расхождения обновляет наблюдение, не создавая одинаковое уведомление каждый раз.

Смена утверждённого файла — изменение базы сравнения. Совпадение с новой базой не означает, что прежняя конфигурация была восстановлена. Содержимое файла не копируется в событие расхождения.

Результаты видны в заданиях; сводка и история расхождений доступны через читающие API `/api/v1/config-drift` и `/api/v1/config-drift/events`. Это не непрерывное наблюдение файловой системы: состояние актуально на время последней выполненной проверки.

## Проверка

После применения заново прочитайте файл, проверьте права и приложение. После контрольного задания сверяйте время, путь и ID артефакта, а не только слово `unchanged`. Устаревшее наблюдение не подтверждает текущее состояние.

## Откат

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

Расширенные параметры, обозначенные как API, могут отсутствовать в текущей форме интерфейса.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.