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

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

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

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

Добавьте в плейбук Применить конфигурационный файл и задайте:
  • артефакт из каталога;
  • абсолютный путь, например /etc/example/app.conf;
  • режим 0600, 0640 или 0644 по требованиям приложения.
На ноде этот точный путь должен быть разрешён агенту. Дополнительно нужны права ОС и разрешение записи в системных ограничениях службы агента. Добавление пути в политику панели не делает защищённый каталог доступным автоматически. Сначала запустите на тестовой ноде. Запись выполняется с проверкой содержимого и заменой файла; символические ссылки и небезопасные пути отклоняются. Существующий файл может быть заменён — это изменяющая операция. Применение файла не означает перезапуск приложения. Добавьте соответствующий отдельный шаг только после того, как понятны требования сервиса и проверка конфигурации.

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

Действие Проверить конфигурационный файл использует тот же артефакт, путь и режим, но не переписывает файл. Оно сравнивает содержимое и права. Например, если текст совпал, но файл стал доступен всем вместо 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, могут отсутствовать в текущей форме интерфейса.