Перейти к содержимому

Инструкция по установке DevOps

Навигация по документу

Устранение неполадок и диагностика работы платформы

Используйте данную инструкцию, если при установке или работе Corta у вас возникают ошибки или сбои.

Как быстро получить информацию о проблемах

Веб-консоль администратора Corta
  • Corta предоставляет веб-консоль сервера с доступом к журналам событий и логам. Используйте её для поиска и анализа ошибок.
  • Веб-консоль позволяет определить причину большинства технических сбоев.
  • Если самостоятельно решить проблему не удаётся, обратитесь за помощью к тех поддержке НПП Протолаб.

Частые ошибки и способы их устранения

Порты заняты или недоступны

Признак:
Ошибка вида:
Cannot start service server: Ports are not available: listen tcp 127.0.0.1:18080: bind: address already in use
Решение:
  • Задайте свободный порт в диапазоне 1024–65535.

В файле docker-compose.yaml для соответствующего сервиса (services.server.ports) можно указать значение, например:

ports:
    - "8081:80"

Или только ["80"] — Docker выберет доступный порт сам.

Не работает WebSocket с Nginx

Для корректной работы WebSocket-соединения настройте проксирование в Nginx.

Пример в файловой конфигурации  nginx.conf (обычно находится в /etc/nginx): 
location /api/websocket {
  proxy_pass http://server:80;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
  proxy_set_header Host $host;
}

Подберите корректный путь location под ваш режим работы и структуру прокси.

Соединение с сервером Corredor

Признак:

Логи содержат ошибку вида:

corredor/service.go: ... could not load corredor server scripts ... connection refused
  • Обычно проблема временная (Corredor запускается медленнее сервера Corta).
  • Если ошибка регулярна, убедитесь, что настройки Corredor и сетевые параметры заданы правильно.

Прокси-сеть не создана (proxy)

Ошибка: 
ERROR: Network proxy declared as external, but could not be found.
Решение:

Создайте прокси-сеть вручную:

docker network create proxy

Убедитесь, что сервис nginx-proxy работает до запуска Corta.

Белый экран / Ошибка "state does not match" на /auth

  • Эту ошибку часто видят на среде разработки или при частых рестартах сервера.

  • Проверьте настройки переменных среды, связанных с авторизацией (AUTH_SESSION_*) в .env.

Аутентификационная "state" не сохраняется между перезапусками без корректной настройки.

Не удаётся войти после корректного ввода логина и пароля

  • В Docker-развёртываниях не всегда все параметры куки и автоматической настройки доступны.
  • Проверьте заголовок set-cookie на стороне клиента, он должен содержать читаемое/корректное доменное имя.

  • Если в поле Domain куки указан ID контейнера, настройте переменную среды DOMAIN (например: DOMAIN=localhost:8080) и пересоздайте контейнер.

Пример корректного set-cookie: 
session=MTYzODQ...tCLvO_DHhw==; Path=/auth; Expires=Sun, XX XXX XXXX XX:XX:XX GMT; HttpOnly
Пример для защищённого домена: 
session=MTYzODQ...tCLvO_DHhw==; Path=/auth; Domain=corta.example.org; Expires=...; Secure; HttpOnly

Флаг Secure автоматически выставляется при использовании HTTPS.

SMTP не работает (не отправляются письма)

Проверьте SMTP через команду:

corta-server auth test-notifications Адрес электронной почты защищен от спам-ботов. Для просмотра адреса в браузере должен быть включен Javascript.
Если e-mail не приходит, проверьте папку "Спам" и логи сервера.
Типичные ошибки: 
could not send email: dial tcp [::1]:25: connect: connection refused

Изменения настроек клиента авторизации не применяются

После изменения client secret, redirect URI или других настроек по умолчанию для авторизации — требуется перезапустить сервер Corta.

Не запускается сервис Discovery

Иногда помогает повторный запуск сервиса, т.к. бывают известные проблемы из-за порядка старта и проверки статуса.

Внимание

Большинство технических ошибок фиксируются через актуальные логи. Убедитесь, что lоги хранятся не менее 7 дней.

Навигация по документу

Инструкция по установке DevOps