Как обновляется клиент Fleetd? Проверка подписи, сравнение версий и восстановление после сбоя

Как Fleetd v0.3.0 проверяет подпись пакета, архитектуру и версию, тестирует новый файл и обновляет агент: возможности и ограничения ручного восстановления.

Один из главных рисков при обновлении инструмента удалённого управления — потерять доступ к машине сразу после обновления клиента.

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

Продолжая предыдущие пять заметок о разработке Fleetd, на этот раз разберём обновление клиента. Это не просто загрузка нового файла. Нужно ответить на три вопроса: можно ли доверять файлу, подходит ли он этой машине и что делать, если после замены возникнет проблема?

Сначала обозначим рамки: статья основана на общедоступном исходном коде и документации Fleetd v0.3.0, коммит c4a066d. Эта версия поддерживает удалённое обновление по инициативе администратора, но не предусматривает ни автоматического поиска и установки новых версий по расписанию, ни автоматического отката по результатам проверки работоспособности. Предложенные ниже проверки при приёмке — рекомендации, а не отчёт о проведённом обновлении в рабочей среде.

Удалённое обновление: сначала разделим ответственность

Обновление Fleetd запускается из панели управления. Администратор загружает пакет выпуска и выбирает версию для отдельной машины, находящейся в сети. Можно также обновить машины той же архитектуры, на которых установлена более старая версия.[1]

Сервер отвечает за раздачу пакета и передачу запроса на обновление, а клиент решает, принимать ли его.

Это важное различие: появление файла в собственной панели управления не должно автоматически делать его доверенным. На клиенте локально настраивается открытый ключ выпуска release_key; получив пакет, клиент обязан самостоятельно проверить подпись. Если этот ключ не настроен, удалённое обновление отклоняется.[2]

Если открытый ключ выпуска настроен и на сервере, сервер проверяет пакет при загрузке. Но серверная проверка не заменяет клиентскую. Согласно исходному коду, когда на сервере ключ не настроен, он может лишь разобрать манифест пакета для хранения и отображения. Поэтому успешная загрузка не доказывает, что клиент примет пакет.[4]

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

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

Подпись — это не просто хеш файла

Пакет выпуска v0.3.0 содержит манифест, подпись и исполняемый файл клиента. В манифесте указаны версия, архитектура процессора, размер файла и SHA-256.[3]

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

Так решаются два связанных вопроса:

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

Один лишь хеш без доверенного источника подписи не решает ту же задачу. Если злоумышленник может заменить и файл, и хеш рядом с ним, они по-прежнему будут «совпадать».

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

Версию и архитектуру клиент проверяет повторно

После проверки подписи клиент также проверяет, совпадает ли архитектура в манифесте с его runtime.GOARCH и новее ли версия в манифесте той, которая сейчас запущена.[2]

Поэтому пакет для arm64, даже с правильной подписью, нельзя установить на клиент amd64 только потому, что он появился в списке панели управления.

У сравнения версий тоже есть конкретные границы. В v0.3.0 сравниваются три целых числа: старшая, младшая версия и номер исправления. Суффикс после дефиса игнорируется.[3]

Например, по правилам этой функции основная часть версий 0.4.0-dev и 0.4.0 одинакова, поэтому вторая не будет признана более новой, чем первая. Это не полноценный порядок предварительных выпусков SemVer; общие представления о SemVer не заменяют поведение исходного кода.

Та же и более старая версии отклоняются. Это не позволяет произвольно понизить версию через обычный механизм обновления, но не является защитой от отката на всех уровнях: тот, у кого есть право локально изменять файлы, по-прежнему может заменить программу. Восстановление старого файла также прямо предусмотрено документацией как способ обслуживания.

При обычном выпуске версия в манифесте должна совпадать со встроенной версией исполняемого файла. Скрипт сборки проекта задаёт версию программы, а если ему переданы версия выпуска и файл закрытого ключа подписи, он также создаёт подписанные пакеты для соответствующих архитектур.[5]

Перед заменой новая программа должна сообщить свою версию

Клиент не перезаписывает собственный исполняемый файл сразу после загрузки.

Сначала он записывает проверенный исполняемый файл рядом с действующим, под именем с суффиксом .new. Затем запускает у нового файла подкоманду version: программа должна завершиться за ограниченное время и вывести версию, совпадающую с подписанным манифестом.[2]

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

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

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

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

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

Восстановление зависит от того, где произошёл сбой

Фраза «при ошибке всё откатится» слишком расплывчата. В реализации v0.3.0 нужно как минимум различать следующие этапы:

Этап сбоя Что делает текущая реализация Что ещё нужно проверить
Ошибка загрузки или проверки подписи, содержимого, архитектуры либо версии Возвращает ошибку, не заменяя действующую программу Записана ли причина ошибки и продолжает ли прежний клиент нормально работать
Ошибка самопроверки версии новой программы Удаляет временный файл, сохраняя действующую программу Связана ли ошибка со сборкой, средой запуска или обозначением версии
Ошибка переименования при замене Возвращает ошибку и удаляет временный файл Права доступа к каталогу, состояние файловой системы и диска
После замены новый процесс не запускается или не выполняет рабочие задачи Автоматического отката по состоянию работоспособности нет Возможность доступа в обход штатного соединения, наличие старого файла и резервной копии конфигурации, возможность ручного восстановления

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

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

Переименование при замене — не транзакция обновления всей машины и не гарантия сохранности данных после отключения питания. В рамках этой статьи проверки при отключении питания, отказе диска или на реальном устройстве OpenWrt не проводились.

Сначала одна машина, потом массовое обновление

В документации проекта прямо сказано, что полностью автоматического обновления нет: если одновременно разослать дефектную версию на все машины, все клиенты могут отключиться, после чего исправить их через ту же панель управления уже не получится.[1]

Проверку обновления я бы разделил на три этапа.

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

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

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

В репозитории уже есть тесты пакетов выпуска и логики установки. Они покрывают неправильную подпись, изменение файла, отказ из-за версии и архитектуры, несовпадение выведенной версии, а также сохранение старого файла после штатной замены.[6] При подготовке статьи эти тесты были изучены, но не запускались повторно; они не рассматриваются как доказательство успешного обновления реального устройства.

Если новая программа уже потеряла связь, восстановление зависит от среды развёртывания. Официальное руководство предлагает вручную вернуть старый исполняемый файл и перезапустить службу. В Linux и OpenWrt различаются пути к программе и способы управления службой, поэтому команды для одного типа машин не стоит бездумно переносить на другой.[1]

Надёжное обновление следует считать завершённым, когда машина вновь вышла на связь и выполняет необходимые задачи. Проверка подписи и версии — лишь входные барьеры; путь восстановления после них тоже должен оставаться доступным.

Источники

Дата сверки: 2026-11-09. Анализ реализации ограничен v0.3.0 и не описывает поведение последующих версий. Предыдущая статья: Как сделать оповещения действительно полезными после настройки мониторинга серверов?

  1. Fleetd v0.3.0: руководство по обновлению клиента.
  2. Реализация обновления и самопроверки клиента.
  3. Подпись и проверка пакета выпуска, сравнение версий.
  4. Загрузка и раздача пакетов выпуска сервером.
  5. Скрипт сборки и шаблон установки клиентской службы.
  6. Тесты установки и тесты пакета выпуска.

Концептуальная иллюстрация создана ИИ; это не фотография испытаний, реальный интерфейс или схема подключения.

Обсуждение

Задайте вопрос или поделитесь опытом. Комментарии появляются после проверки. Адрес почты не публикуется. Конфиденциальность комментариев

Загрузка комментариев…