Проверка и решение проблем

Установка не завершается

Проверьте доступ к шине, валидность кода и SHA-256 скачанных пакетов. Если Compose уже начал запускаться, повторите установщик с тем же кодом и каталогом: незавершённая активация может быть продолжена. Проверьте docker compose ps в каталоге установки и локальный GET /healthz. Код считается использованным только после успешной проверки стека и создания администратора.

Не открывается кабинет

Проверьте DNS/hosts, TLS-прокси и его направление на порт 8080, затем <адрес>/healthz и <адрес>/auth/realms/forsell/.well-known/openid-configuration. Для локальных тестовых доменов нужен доверенный CA на компьютере пользователя.

Нет таблицы в каталоге

Убедитесь, что DAG завершился, и у пользователя есть catalog.list и dataset.read.<schema>.<name>. Администратор с system.admin видит все доступные клиентские наборы. Системные схемы и внутренние таблицы Airflow в каталог не входят.

Название колонки выглядит техническим

Кабинет показывает подпись из PostgreSQL COMMENT ON COLUMN; если её нет, он лишь разделяет имя на слова. Попросите разработчика клиентского пакета добавить комментарий в следующую миграцию. Изменение файла в postgres-init само по себе не обновляет уже существующую базу: миграцию нужно применить к установленному PostgreSQL.

DAG не может читать источник

Откройте Настройки → Секреты источников и проверьте статус обязательных полей. В параметрах DAG значения секретов указывать нельзя. Ошибку исполнения ищите в истории конкретного DAG.

MCP возвращает 401 или 403

При 401 проверьте вход через forsell-mcp, срок жизни токена и OAuth audience. При 403 проверьте catalog.list и роль выбранного набора. Если MCP-клиент не поддерживает статический OAuth client ID, его совместимость пока не гарантирована.