Обновления агентов

Агенты обновляются по решению администратора: агент сам новых версий не ищет и ставит только ту, которую ему одобрили. Отдельного экрана для обновлений нет – всё делается на Настройки → Агенты, в колонке «Версия» и в раскрытии строки. Видит и запускает обновления только администратор аккаунта.

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

Версия в строке агента

Рядом с номером версии в строке стоит одно из трёх, по важности:

• кнопка «Обновить» – для агента есть пакет новее, и он поставит его сам;
• плашка хода обновления – «одобрено», «обновляется», «не вернулся», «не удалось», «обновлён», «переодобрите»;
• пометка «отстала» – агент отстал от релиза платформы больше чем на две недели; на сколько дней, видно в подсказке. «до версий» – агент так стар, что версию о себе не сообщает.

Пока у кого-то из агентов обновление в движении, страница обновляется сама, каждые несколько секунд, – перезагружать её не нужно.

Раскрытие строки, блок «Версия»

В раскрытии строки – полная картина:

• номер версии, при отставании – «отстала на N дн.»;
• «→ …» – версия пакета, который можно поставить;
• плашка состояния, см. таблицу ниже;
• пока агент качает пакет – полоса скачивания с процентами и мегабайтами, например «47 %» и «8,0 из 16,8 МБ»; дальше строкой – «проверяет подпись пакета», «ставит пакет» или причина неудачи;
• кнопка «Обновить» – запустить или повторить; «Отменить» – снять одобрение, пока агент не забрал пакет;
• последней строкой – версия браузера, которым агент проверяет страницы.

Состояния обновления

В раскрытии	В строке	Что значит
«доступно обновление»	кнопка «Обновить»	есть пакет новее, ещё не одобрен
«одобрено, ждёт опроса»	«одобрено»	одобрено, агент заберёт пакет при ближайшем опросе
«обновляется»	«обновляется»	агент качает, проверяет или ставит пакет
«не вернулся»	«не вернулся»	десять минут без движения: ни байтов, ни смены шага
«не удалось»	«не удалось»	агент сообщил, что установка сорвалась; причина – строкой ниже
«пакет изменился – переодобрите»	«переодобрите»	пакет подменили после одобрения, агент его не получит; нажмите «Обновить» ещё раз
«обновлён»	«обновлён»	агент вернулся на одобренной версии
«обновляется вручную»	–	пакет есть, но агент сам его не поставит, см. По платформам
–	–	агент на последней версии или для его платформы пакета нет: про обновление ничего не написано

«Не вернулся», «не удалось» и «переодобрите» ждут человека: у них в раскрытии снова есть «Обновить».

Обновить одного или всех

Обновление одобряется поимённо, так что новую версию удобно раскатывать волнами: сначала «Обновить» у одной-двух машин, а когда они вернулись «обновлён», – остальным.

Для последнего шага над таблицей есть кнопка «Обновить всех, кому есть что ставить (N)»: она запускает установку на всех своих агентах, для которых есть пакет новее и которые поставят его сами. Агенты, которые обновляются вручную, и облачные агенты в это число не входят. На вкладке «Роутеры» этой кнопки нет.

Как агент обновляется сам

1. На ближайшем опросе платформа предлагает одобренному агенту пакет.
2. Агент скачивает его кусками; обрыв связи, закрытая крышка ноутбука или перезапуск – пауза, а не начало сначала: после обрыва агент продолжает с того же места. На медленном канале это долго, но не страшно.
3. Агент сверяет контрольную сумму и подпись пакета и проверяет, что внутри именно предложенная версия. Чужой или подменённый пакет удаляется, агент остаётся на своей версии, в панели – «не удалось» с причиной.
4. Агент ставит пакет и перезапускается на новой версии – обычно всё занимает около минуты. На Mac, если новая версия не поднялась, установщик возвращает прежнюю.

Если установка не удалась, ту же версию агент повторит не раньше чем через час (в причине так и написано: «Повтор не раньше чем через …»). Следующую версию он возьмёт сразу.

Браузер для проверок страниц при обновлении агента не перекачивается – только если релиз сменил его версию, и тогда агент принесёт новый сам.

По платформам

Агент	Как обновляется
Mac сотрудника	сам, по «Обновить»; вручную – пакетом поверх, см. Установка на Mac
Windows сотрудника	сам, по «Обновить»; вручную – установочным архивом, см. Установка на Windows
Linux-сервер, частный агент	вручную, повторным запуском установщика, см. Установка на Linux
Linux сотрудника	вручную, новой сборкой
Роутер	вручную
Android	по «Обновить»: приложение скачивает новую версию, сотрудник подтверждает установку, см. Мобильные устройства
iPhone	новой сборкой приложения через TestFlight или MDM, см. Мобильные устройства
Облачный	обновляет сервис

У агентов, которые сами не обновляются, в раскрытии – «обновляется вручную», а в строке, если они отстали, – «отстала».