← Платформа агентов

/ru/agents · автоматизация

idevops — агент инфраструктуры и эксплуатации

Агент ЯКомпании развёртывает инфраструктуру, настраивает доступ и мониторинг, диагностирует сбои и проверяет работу сервисов. Возможности, порядок работы и границы самостоятельности.

Разработчик: ЯКомпания
  • агенты
  • idevops
  • DevOps
  • инфраструктура
  • ЯКомпания

Назначение

idevops — агент «ЯКомпании» для развёртывания и сопровождения инфраструктуры, часть её платформы агентов. Он работает с серверами, Kubernetes, сетевыми настройками и сервисами приложений: применяет конфигурацию, разбирает ошибки и проверяет результат на работающей системе.

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

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

Вход

Для начала нужны задача и сведения о целевой системе:

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

Описание целевого состояния может включать cluster.yaml, манифесты Kubernetes и конфигурацию OpenTofu. Для ресурсов приложения используется deployment.json. Эти файлы имеют разные назначения: инфраструктурный проект не становится приложением только ради подключения правил агента.

Возможности

Серверы и кластеры

Агент использует OpenTofu для управления облачными ресурсами и сетевым экраном. Через инструменты развёртывания настраивает Kubernetes на базе k3s, системные службы и операторы кластера. В рабочий стек входят Gateway API и kgateway, cert-manager, External Secrets Operator и Reloader.

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

Развёртывание приложений и доступ к ресурсам

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

Поддерживаемые задачи включают настройку PostgreSQL и Redis, доступа к объектному хранилищу и Temporal, управление пользователями и ролями в ZITADEL, подключение секретов из OpenBao. Конкретный набор служб и способ аутентификации определяются целевой инфраструктурой.

Сеть, сертификаты и защита интерфейсов

Агент настраивает маршрутизацию к сервисам, TLS-сертификаты и правила доступа. Проверяет внешние порты, перенаправления на HTTPS, требования к шифрованию соединений и авторизацию в административных интерфейсах.

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

Логи и оповещения

idevops настраивает сбор логов контейнеров и системных служб через Vector, хранение в VictoriaLogs и правила LogsQL в vmalert. Alertmanager группирует уведомления и отправляет их по настроенному каналу, в том числе по SMTP с TLS.

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

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

Эксплуатационная документация

Агент сохраняет команды управления, схему сервисов, результаты проверок и незакрытые вопросы. Для проверки веб-интерфейсов может выполнить разрешённый вход через браузер и снять скриншоты рабочих страниц.

Снимок формы входа и снимок доступной после авторизации панели подтверждают разные сценарии. В отчёте должно быть видно, что именно проверено; секреты и закрытые данные не предназначены для публичной документации.

Порядок работы

  1. Прочитать конфигурацию и локальный регламент. Установить целевой хост, кластер, окружение и границы разрешённых изменений.
  2. Проверить доступ. Для Kubernetes явно выбрать kubeconfig и контекст, сверить адрес API-сервера. Имя кластера может не совпадать с именем контекста.
  3. Собрать факты. Посмотреть состояние компонентов, ошибки и действующие настройки. Отделить проблему приложения от отказа его зависимостей или инфраструктуры.
  4. Подготовить и применить изменение в соответствующем репозитории. Использовать существующие инструменты автоматизации; согласовать действия, выходящие за выданные полномочия.
  5. Проверить изменённый сценарий на работающей системе. При неудаче продолжить диагностику либо зафиксировать конкретное препятствие.
  6. Обновить документацию и передать результат: что изменено, чем подтверждено и какие ограничения остались.

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

Выход

Результат Что остаётся после работы
Развёрнутое окружение Конфигурация в репозитории и проверенные сервисы
Инфраструктурное исправление Изменённые манифесты или настройки и результат проверки затронутого сценария
Диагностика Наблюдаемые факты, найденная причина либо проверенные гипотезы и препятствие дальнейшему разбору
Мониторинг Сбор логов, правила оповещения, настройки доставки и результаты её проверки
Эксплуатационный отчёт Схема, инструкции управления, состояние проверок и допустимые к передаче скриншоты
Передача в разработку Задача с симптомом, контекстом и ожидаемым поведением, без секретов

Проверки

Успешное применение манифеста означает, что API принял конфигурацию. Готовность сервиса требует отдельной проверки:

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

Принятие письма SMTP-сервером не доказывает, что адресат прочитал его. Состояние контейнера Running не доказывает исправность пользовательского сценария. В отчёте сохраняется именно тот уровень подтверждения, который получен.

Связи с другими агентами

Если причина требует изменения кода приложения, idevops передаёт задачу в его репозиторий. В подключённом маршруте мониторинга сигнал проходит через alert-relay в issue, затем через iomp к агенту разработки. Повторные срабатывания могут дополнять открытую задачу; сырые логи с персональными данными и токенами не должны попадать в её описание.

Агент разработки готовит исправление кода, а эксплуатационная проверка подтверждает его поведение после выпуска. Создание issue или pull request ещё не означает восстановление сервиса. Наличие такого маршрута у платформы не означает, что он подключён в каждом окружении.

Ограничения

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

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

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

Модель может ошибиться в причине сбоя или выборе исправления. Поэтому idevops не обещает безотказную работу, универсальную совместимость со всеми облаками или полное устранение рисков безопасности. Проверка относится к конкретному сценарию и моменту времени.

Практический пример

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

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

Оценка результата

Эффект оценивается по завершённым эксплуатационным задачам: времени до диагностики и восстановления, повторным инцидентам, ошибочным изменениям и объёму ручных исправлений. Для развёртывания важно учитывать весь путь до проверенного приложения, включая ожидание доступов и исправление конфигурации.

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

← Платформа агентов