Перейти к содержанию
zoryn/ maintainer-assistant

zoryn network

Просмотр текущих сборок на локальных и удалённых билдерах.

Experimental

Mesh-сеть экспериментальная и по умолчанию выключена. Для включения добавьте ключ верхнего уровня в ~/.zoryn, перед любыми [секциями]:

zoryn_network = "on"

По умолчанию действует zoryn_network = "off". В этом режиме zoryn не публикует и не ищет endpoints, не исправляет их права и не запускает SSH для mesh. network status сообщает об отключении и завершается успешно, не проверяя имя билдера.

zoryn network status

zoryn network status [BUILDER] [-d|--debug] [-C DIR]

Без BUILDER команда читает каталоги локальных endpoints, включая ретранслированные удалённые записи и резервные снимки состояния билдеров. Она не запускает SSH и не опрашивает все настроенные билдеры. Дочерний worker обслуживает endpoint, получает изменения состояния по IPC и обновляет удалённые статусы примерно раз в пять секунд. Заблокированная сборочная команда и медленный удалённый опрос не мешают обслуживать endpoint. Опубликованный PID принадлежит процессу сборки, а не worker. На удалённых билдерах endpoint по-прежнему доступен через SSH forwarding. Сборка начинается только после готовности endpoint и обязательного forwarding. Удалённые записи видны только тогда, когда локальный endpoint получил их или сохранил резервный снимок. Каждый endpoint выводится один раз. Ошибки обновления и снимки старше пятнадцати секунд сопровождаются предупреждениями. Если BUILDER задан, команда напрямую опрашивает указанный билдер.

Для каждого доступного endpoint выводятся билдер, пользователь исходного процесса, UID, PID, состояние, текущий пакет, фаза и очередь. Очередь включает текущий пакет и принадлежит одному процессу сборки, а не всему билдеру. Во время ожидания занятого билдера процесс публикует свой PID, state=starting и phase=waiting-builder, текущий пакет и запланированную очередь, где текущий пакет стоит первым. При опросе нескольких кандидатов endpoint ожидания привязан к первому кандидату в порядке списка, не признанному недоступным (включая его SSH-адрес), а не ко всем сразу. После ожидания сборка на выбранном билдере сохраняет тот же ID. Процесс сборки сохраняет один worker и ID на весь последовательный цикл, включая ожидание и смену билдера или хоста. Публикации на уже использованных хостах доступны до конца цикла. Параллельные дочерние процессы имеют разные ID; диспетчер без собственной сборки не создаёт endpoint. Циклы batch и task rebuild добавляют оставшиеся запланированные пакеты в порядке выполнения, без явно пропущенных. Последовательный test-rebuild включает ожидающие пакеты для текущей архитектуры: сначала готовые повторные сборки, затем новые пакеты. Параллельные процессы test-rebuild публикуют только назначенный им пакет: нераспределённые задания диспетчера не являются очередью отдельного процесса. План может измениться после последующих проверок. Эти сведения доступны другим участникам группы hashman.

Недоступные, небезопасные и некорректные endpoints отображаются как предупреждения и не скрывают исправные ответы. Предупреждения о сокетах содержат HOST:/путь/к/сокету: локальное имя хоста или настроенный адрес SSH для удалённого запроса. Новые удалённые снимки сохраняют этот хост; в старых снимках он может отсутствовать. При заданном BUILDER ошибка обнаружения на билдере приводит к коду завершения 1. Предупреждения локального обнаружения и отдельных endpoints не меняют код завершения. Команда не удаляет устаревшие сокеты и не меняет очереди. При обнаружении она по возможности восстанавливает группу hashman и права 2750 у каталога своего UID. У своих сокетов с группой hashman она восстанавливает права 0770, не меняя их группу. Симлинки отклоняются; после ремонта проверяются устройство и inode. Чужие объекты и /var/tmp не изменяются. Неудачный ремонт остаётся предупреждением, а успешный виден с --debug.

Протокол каталога

Endpoints также принимают get_catalog (версия каталога 1), страницы — до 1 MiB. Если кешированное расширение превышает лимит ответа get_status в 1 MiB, endpoint возвращает собственный статус и предупреждение вместо кеша. Если не помещается даже предупреждение, возвращается только собственный статус. Страницы каталога остаются доступны. Worker обменивается каталогами с проверенными локальными сокетами и удалёнными билдерами, использованными текущей сессией. network status читает страницы каталогов обнаруженных endpoints и объединяет их по версиям. В вывод добавлены endpoint и age; конфликт одинаковых версий показывается явно, а известные истёкшие записи и LEAVE скрываются. Ошибка страницы сохраняет проверенные результаты и вызывает предупреждение о неполном каталоге. Это доступное представление сети, а не гарантия обнаружения всех участников. Если версия каталога неизвестна, сохраняется fallback на прямые статусы и кешированные снимки с age=unknown (status-only), без гарантии TTL каталога. Известная версия каталога, включая удаление, имеет приоритет. Старые endpoints, отклоняющие get_catalog, поддерживаются. Обмен не зависит от сборки: до восьми одновременных запросов каталога, десять секунд на запрос и 25 секунд на обход каталога одного соседа с момента первого запроса, без учёта ожидания в очереди. Новые циклы запускаются раз в четыре–шесть секунд, когда предыдущий завершён. Адреса из записей не используются для подключения. Проверенные страницы объединяются по мере получения. Ошибка следующей страницы не удаляет уже полученные записи и отражается в debug-логе сборки; обход не считается завершённым. Старые endpoints остаются видимыми через опрос статусов без выдуманных версий каталога. Состав и версии записей многостраничного снимка не меняются при обновлении состояния. Хранятся до четырёх снимков с общим лимитом 8 MiB на закодированные записи и сроком 30 секунд. Неизвестный или просроченный курсор и исчерпание лимита возвращают ошибку, а не неполный успешный ответ. Worker обновляет собственную запись каждые пять секунд, даже без сообщений IPC. Ретрансляция не сбрасывает возраст записи. Активная запись истекает через 60 секунд без новой версии владельца; защита от повторов хранится 300 секунд. После этого или перезапуска защита не гарантируется. При штатном завершении worker отправляет обнаруженным соседям LEAVE с новой версией; общий бюджет доставки — одна секунда. Получатели распространяют tombstone через страницы каталога до 300 секунд. При потере LEAVE и аварийном завершении действует TTL; доставка не гарантируется. Поведение get_status не изменилось. Обмен рассчитан на доверенных участников: записи и LEAVE не подписаны. Участник может их подделать, а ретрансляция расширяет видимость статуса за пределы ACL исходного сокета.

Параметры

ПараметрОписание
-d, --debugПоказать обнаружение, источники кеша, метаданные сокетов и запускаемые команды
-C DIRСменить каталог перед опросом
--helpСправка

Отладочный вывод идёт в stderr. Без BUILDER он показывает локальное обнаружение и сохранённые снимки без запуска SSH. Чтобы увидеть текущие метаданные удалённых сокетов и запускаемые SSH-команды, укажите билдер.

Примеры

zoryn network status
zoryn network status arm-server

При сборке zoryn сам создаёт /var/tmp/zoryn-mesh-<uid> и выставляет группу hashman и права 2750 у своего каталога. Пользователь сборки должен входить в hashman. Создавать каталог от администратора не требуется. См. настройку билдеров.