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

Агент Наблюдателя обновляется отдельно от кабинета: новые версии выходят с исправлениями и новыми данными — ошибками из логов Kubernetes, маскированием персональных данных, томами, выкатками и сетевыми связями контейнеров. Кабинет сам подсказывает, когда агента пора обновить, и выдаёт готовую команду.

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

#Как узнать версию агента

• Раздел «Агенты» в кабинете — у каждого агента указаны версия, статус и время последней отправки.
• Страница агента — версия рядом с названием и журнал последних отправок.
• Лог агента — первая строка после запуска, например nabl-agent 0.14.1 mode=compose …:

docker compose logs nabl-agent | head              # Docker Compose
kubectl -n <namespace> logs deploy/nabl-agent | head  # Kubernetes
sudo journalctl -u nabl-agent | grep "mode="          # сервер

Статусы в разделе «Агенты»:

Над списком — счётчики «можно обновить» (вышла новая версия) и «несовместимы» (версия ниже минимальной для Наблюдателя, такого агента нужно обновить обязательно).

#Как понять, что пора обновиться

На странице стека или сервера кнопка «Агент» меняется на «Обновите агента»:

• жёлтая точка — доступна новая версия, текущая работает;
• красная точка — версия агента несовместима с Наблюдателем.

Нажмите кнопку — откроется окно «Обновление агента» с командой для вашего окружения.

#Как обновить агента

Токен и настройки при обновлении сохраняются.

#Docker Compose

В каталоге с docker-compose.yml, где описан сервис nabl-agent:

docker compose pull nabl-agent && docker compose up -d nabl-agent

Команда скачает свежий образ velgir/nabl-agent:latest и пересоздаст контейнер агента. Если сервис у вас называется иначе, замените имя. Если образ закреплён версией или digest, сначала поменяйте его в docker-compose.yml.

#Kubernetes

kubectl -n <namespace> rollout restart deployment/nabl-agent

С образом latest Kubernetes при перезапуске скачает свежую версию. Если образ закреплён версией, поменяйте его:

kubectl -n <namespace> set image deployment/nabl-agent agent=velgir/nabl-agent:0.14.1

Новые права. Иногда новой версии нужны дополнительные права на чтение. Например, тома PVC с путём на ноде появились в 0.12 вместе с правами на persistentvolumeclaims и persistentvolumes. Без них агент работает, но без новой функции. Чтобы получить права, примените свежий манифест из кабинета.

#Сервер

curl -fsSL https://nablserver.ru/update.sh | sudo sh

Скрипт скачает новую версию, остановит службу nabl-agent, заменит программу и запустит службу снова. Токен и адрес в /opt/nabl-agent/.env не меняются. Если версия уже актуальная, скрипт ничего не перезапускает.

Посмотреть скрипт перед запуском:

curl -fsSL https://nablserver.ru/update.sh -o update.sh && less update.sh

#Как выпустить новый токен агента

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

1. Откройте страницу стека или сервера и нажмите кнопку «Агент». Если агенту нужно обновление, в окне «Обновление агента» нажмите «Пересоздать агента и получить токен».
2. В окне «Пересоздать агента» нажмите «Пересоздать». Затем проверьте название агента и ещё раз нажмите «Пересоздать». Старый агент удаляется, создаётся новый — текущий токен сразу перестаёт работать.
3. Скопируйте токен из окна «Новый токен агента» и замените его на машине, где работает агент.

Через ИИ-ассистента можно выпустить новый токен для того же агента, не пересоздавая его: попросите перевыпустить токен для стека или сервера. Агент, его привязки и история сохраняются, а ответ сразу содержит команду для замены токена. Если у стека или сервера агента нет, ассистент создаст нового и выдаст полную инструкцию установки.

Кто может выпустить новый токен: тот, кто создал агента, или участник с ролью «Редактор» во всех стеках, к которым агент привязан. Если хотя бы один из этих стеков вам недоступен для редактирования, токен меняет создатель агента. Агента сервера меняет только его владелец.

Важно. Пока токен на машине не заменён, данные не приходят. Агент 0.9.2+ после отказа делает паузу в 5 минут и пишет в лог, что токен отклонён; после замены токена отправка возобновляется сразу.

#Замена токена в Docker Compose

Поменяйте NABL_AGENT_TOKEN в environment сервиса или в файле .env и пересоздайте контейнер:

docker compose up -d nabl-agent

#Замена токена в Kubernetes

kubectl -n <namespace> patch secret nabl-agent -p '{"stringData":{"token":"<НОВЫЙ_ТОКЕН>"}}'
kubectl -n <namespace> rollout restart deployment/nabl-agent

#Замена токена на сервере

Агент перечитывает .env перед каждой отправкой, перезапуск не нужен:

sudo sed -i 's/^NABL_AGENT_TOKEN=.*/NABL_AGENT_TOKEN=<НОВЫЙ_ТОКЕН>/' /opt/nabl-agent/.env

Если агент на сервере ещё не установлен или нужна чистая установка, используйте команду установки из окна — она перезапишет .env. См. Мониторинг сервера Linux.

#Какие функции требуют какой версии агента

Кроме новых функций, многие версии уменьшают число ложных ошибок из логов: для PHP, Node.js, Kafka, gin, gorm, ClickHouse и других. Если во вкладке «Ошибки» много шума, сначала обновите агента.

#Закрепление версии в production

latest удобен для начала. В production закрепите версию, чтобы обновлять агента осознанно:

• Docker Compose и Kubernetes — тег версии velgir/nabl-agent:0.14.1 или digest velgir/nabl-agent@sha256:…;
• сервер — обновляется только когда вы запускаете update.sh.

Совет. ИИ-ассистент через MCP покажет версии ваших агентов и выдаст команду обновления или замены токена. См. ИИ-ассистент.

#Что дальше

• Как работает агент — доступы, сеть и безопасность токена.
• Мониторинг Docker Compose — установка в compose-проект.
• Мониторинг Kubernetes — манифест и права.
• Решение проблем — если агент не присылает данные.