Перейти к основному содержимому
Версия: 1.13.0

3. Проверка работоспособности и отладка

3.1 Проверка работоспособности​

Дистрибутив содержит скрипт для автоматической проверки работоспособности основных элементов платформы. Укажите URL платформы http://platform.$DOMAIN, email пользователя <PLATFORM_DEFAULT_EMAIL> и выполните команду:

$ python3 integration_tests/main.py <platform url> <user email> –-show-trace

После запуска скрипта в консоли будет запрошен пароль. Введите пароль пользователя <PLATFORM_DEFAULT_PASSWORD> и нажмите клавишу Enter. В случае успешного выполнения тестов в консоль будет выведен следующий текст:

Test data prepared successfully
----------------------------------------------------------------------------------------------------
create_search_profile test started
create_search_profile test succeeded
----------------------------------------------------------------------------------------------------
Test data deleted successfully

3.1.1 Возможные ошибки при тестировании и пути их решения​

При возникновении ошибок тестирования система возвращает следующий результат:

Error: <error type>
Error message: <error message>

Error type обозначает тип возникшей ошибки, а error message сообщает уточняющую информацию об ошибке.

Команды для отладки сервисов описаны в пункте 3.2, список сервисов и их зона ответственности - в пункте 2.4.3.

Далее перечислены комбинации ошибок и сообщений с возможными шагами по их устранению.

ConnectionError:

  • <urlopen error Wrong url format: asdasd> Введен неверный формат URL, необходимо ввести корректный адрес.

  • <urlopen error [Errno -2] Name or service not known> \ <urlopen error [Errno 111] Connection refused> Введен URL недоступного сервиса. Проверьте корректность введённого адреса, а также убедитесь, что платформа развернута корректно и доступна извне. Если вы обращаетесь по домену, проверьте, что файл /etc/hosts имеет именно тот домен, который указывает на ip адрес развернутой платформы.

  • HTTP Error 405: Not Allowed Убедитесь, что введенный URL ведёт именно на Платформу, а не на сторонний сервис.

  • HTTP Error 502: Bad Gateway / HTTP Error 503: Service Temporarily Unavailable Убедитесь, что сервис backend-dep развернут.

PlatformError:

  • connection to server at "localhost" (::1), port 5432 failed: Connection refused Is the server running on that host and accepting TCP/IP connections? Убедитесь, что база данных доступна и работает правильно.

  • Authorization error Убедитесь, что вы ввели правильные пароль и почту пользователя.

  • Wrong answer from server. JSON can not decoded Убедитесь, что введенный URL ведёт именно на платформу, а не на сторонний сервис.

  • License has not been leased yet Убедитесь, что сервер лицензий работает, и у платформы есть к нему доступ. Дополнительно проверьте, что лицензия активирована корректно.

  • Low quality photo Проверьте, что сервис, отвечающий за вычисление качества фотографий, доступен и работает корректно.

  • Profile not searched Убедитесь, что сервис, отвечающий за поиск по базе персон, доступен и работает корректно.

При появлении любых других типов ошибок или сообщений, которые не получается отладить и устранить на месте, а также невозможности устранения вышеописанных ошибок, обращаться на почту support-platform@3divi.com.

3.2 Отладка​

В случае некорректной работы сервиса логи можно получить с помощью следующей команды, подставив имя интересующей поды:

$ kubectl logs $POD_NAME

Или через команду получения логов предыдущей попытки запуска:

$ kubectl logs $POD_NAME --previous

Или через раздел Events вывода следующей команды:

$ kubectl describe pod $POD_NAME