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

Инструкция по установке 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 дней.

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