Решение проблем¶

Платформа¶

Симптом	Причина	Решение
Под платформы перезапускается, в логе ошибка подключения к базе	Не задан пароль PostgreSQL или база недоступна	Проверьте секрет PostgreSQL и доступность сервиса базы
После входа снова открывается страница входа	Платформа открыта по HTTP, а cookie сессии передаётся только по HTTPS	Откройте платформу по HTTPS через Ingress
Нет пользователя `admin`	Учётные записи `admin` и `developer` создаются только в режимах `local` и `sso+local`	Включите локальный вход или назначьте роль `platform-admin` через группу провайдера
Пользователь OIDC вошёл, но не видит разделы	Группы пользователя не сопоставлены с ролями	Проверьте `NEOMSA_ESB_AUTH_GROUP_MAPPING` и маппер групп в клиенте Keycloak
Правка в git не появляется в платформе	Платформа хранит файлы проектов в своей базе. Версия из git применяется при старте и только если коммит новее	Выполните Pull или перезапустите платформу
После входа интерфейс долго показывает загрузку проектов и не открывается	В секрете `neomsa-esb` нет ключей `karavan.git.*`	Создайте секрет из шаблона чарта, не удаляя эти ключи
В логе платформы `Connection refused` с адресом пода и портом 9876	Интеграция собрана без `camel.management.port=9876`	Добавьте параметр и порт `observability` в проект и пересоберите интеграцию
В списке проектов лишние «интеграции»	В корне репозитория лежат посторонние папки	Держите в корне только папки проектов, `configuration` и `templates`

Сборка¶

Симптом	Причина	Решение
403 при создании пода сборщика	У сборщика нет прав или указан неверный ServiceAccount	Проверьте `NEOMSA_ESB_BUILDER_SERVICE_ACCOUNT` и роли чарта
Под сборщика не создаётся, в событиях `secret not found` или `couldn't find key`	Фрагмент пода сборщика в проекте `configuration` ссылается на другой секрет или ключи	Используйте `builder.pod.jkube.yaml` из комплекта поставки. Он читает секрет `neomsa-esb` и ключи `git-` и `image-`
`has not been downloaded from it before`	Библиотеки нет в Maven-репозитории сборщика	Запросите образ сборщика с нужной библиотекой в технической поддержке. См. Офлайн-сборщик
Сборка пытается скачать другую версию библиотеки	Версия в проекте не совпадает с `camel-dependencies`	Возьмите версию из `camel-dependencies` 4.22.2
Сборка удаляет ServiceAccount	В `deployment.jkube.yaml` указан `serviceAccount` при `jkube.recreate=true`	Уберите `serviceAccount` из фрагмента
`exec format error` при старте интеграции	Базовый образ не подходит к архитектуре узлов	Используйте базовый образ из комплекта поставки и узлы `linux/amd64`

Интеграция¶

Симптом	Причина	Решение
`ClassNotFoundException` на main-классе или старт без маршрутов	Нет параметра `jib.containerizingMode=exploded`	Задайте `jib.containerizingMode=exploded`
Сборка успешна, но под работает со старой версией	Образ публикуется с тегом `latest`, а политика загрузки `IfNotPresent`	`jkube.imagePullPolicy=Always`
`Connection refused` при вызове другой интеграции	Service отправляет трафик на порт 80, а Camel слушает 8080	`jkube.enricher.jkube-service.port=80:8080`
Пробы падают, под перезапускается	Нет `/observe/health` или пробы смотрят не на тот порт	Задайте `camel.management.enabled=true` и `camel.management.port=9876`, пробы направьте на порт `observability`
Нет метрик в Prometheus	У пода нет меток `provider=neomsa-esb` и `group=neomsa-esb` или метка `release` PodMonitor не совпадает с релизом kube-prometheus-stack	Проверьте `jkube.enricher.jkube-project-label.*` и параметры PodMonitor в чарте
Нет трейсов в APM	Нет секрета `neomsa-esb-apm`, в `deployment.jkube.yaml` указано другое имя секрета или неверный адрес APM	Проверьте секрет и переменные OpenTelemetry в `deployment.jkube.yaml`
`NoClassDefFoundError: io/opentelemetry/api/internal/InstrumentationUtil`, трейсов нет	Версия SDK OpenTelemetry не подходит к Camel 4.22.2	Укажите версию 1.64.0 в `camel.jbang.dependencies`
В выходном топике Kafka нет ожидаемого ключа записи	Ключ задан в заголовке `kafka.KEY`, а в Camel 4.22 заголовок называется `CamelKafkaKey`	Задайте ключ в `CamelKafkaKey` до отправки
В Kibana не находится цепочка по бизнес-ключу	Бизнес-ключ не выводится в лог	Добавьте заголовок в `camel.mdc.customHeaders`

Dev-режим¶

Симптом	Причина	Решение
`Cannot invoke "String.getBytes"` при запуске	В проекте нет `deployment.jkube.yaml`	Скопируйте файл из шаблона
Под dev-режима не запускается из-за конфликта Service	Интеграция уже развернута, и Service с этим именем занят	Удалите развертывание перед отладкой (см. ниже)
Нет кнопки запуска в режиме разработчика	У проекта есть контейнер	Удалите развертывание интеграции

kubectl -n <namespace> delete deploy,svc -l app=<project>,provider=neomsa-esb

После отладки остановите dev-режим и соберите проект заново.