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