Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Поиск и исправление ошибок установки

1. Предварительные действия

В случае возникновения проблем в процессе установки, в первую очередь следует убедиться, что параметры среды функционирования соответствуют заявленным требованиям:

  1. Проверьте, что управляющему хосту и целевому хосту выделено необходимое количество процессорных ядер и оперативной памяти.

  2. Проверьте наличие свободного пространства в файловой системе хостов:

    • Управляющий хост — минимум 50 ГБ

    • Целевой хост — минимум 150 ГБ

  3. Все необходимые имена разрешаются с управляющего хоста и целевого хоста, а также с клиентского устройства, например:

    nslookup portal.sample.box
nslookup api.sample.box

  4. Убедитесь, что у пользователя, под учетной записью которого производится установка на целевой хост, есть права для использования sudo без необходимости ввода пароля на целевом хосте:

    sudo -v

  5. Проверьте, что целевой хост имеет доступ к репозиториям операционной системы для загрузки необходимых пакетов в процессе установки.

  6. Проверьте корректность указанных параметров в файлах конфигурации (hosts и config.yml) в директории inventories. Убедитесь в том, что домен DNS для внутренних сервисов введен в соответствии с wildcard-записью в DNS.

2. Исправление ошибок в процессе установки

В случае возникновения ошибки в процессе разворачивания портала проверьте лог-файлы пода, находящегося в статусе ERROR.

Для проверки можно использовать инструмент командной строки Kubernetes cli — kubectl (необходимо предварительная установка инструмента) либо UI-инструменты Lens, OpenLens.

При возникновении ошибки выполните действия:

  1. Подключитесь к кластеру с локальной машины или с целевого хоста.

  2. При подключении с локальной машины скопируйте файл /etc/rancher/k3s/k3s.yaml с целевого хоста на локальную машину ~/.kube/config.
    Дальнейшие примеры представлены для случая выполнения команд на целевом хосте:

    sudo kubectl get pods -A (1)

sudo kubectl logs -n analytics имя-пода (2)
    1 Получение всех подов
    2 Просмотр логов

  3. Рекомендуется запускать установки с повышенной детализацией, для этого используйте ключ -vvv:

    docker run -it --network host --rm -v /home/$USER/analytics:/apps -v ~/.ssh/id_rsa:/root/.ssh/analytics/id_rsa -v ~/.kube/analytics:/root/.kube/analytics deploy-manager:1.8.0 -i inventories/box/hosts analytics.yml --ask-vault-pass -vvv

3. Исправление ошибок после установки

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

  1. При наличии проблемы со сбором метрик на платформе Grafana просмотрите лог-файлы vmagent, vminsert, vmstorage, vmselect.

  2. В случае отсутствия аналитических данных проверьте лог-файл airflow.

  3. При возникновении сообщения Please install python3-apt package выполните действия:

    1. Проверьте, что установлен данный пакет.

    2. Если пакет python3-apt package не установлен, выполните его установку.

    3. Если пакет установлен, но сообщение все равно возникает, введите команду:

      cd /usr/lib/python3/dist-packages
sudo ln -s apt_inst.cpython-35m-x86_64-linux-gnu.so apt_inst.so
sudo ln -s apt_pkg.cpython-35m-x86_64-linux-gnu.so apt_pkg.so