Не работает сервис


Вопрос: Что предпринять, если при запуске сервиса поды находятся в состоянии Pending? В логах указано, что отсутствует связь с Redis.

Ответ:

  1. Необходимо проверить YAML-файлы с настройками подключений к Redis на корректность параметров (хост, порт, пароль).
  2. Для Redis в файле конфигурации «redis.conf» в параметр «dir» необходимо добавить путь для дампа (например, /var/lib/redis).
  3. В PostgreSQL необходимо увеличить значение параметра «max_connections», рассчитывается как 25 коннектов на один микросервис. В файле «redis.conf» установить значение «maxclients» не менее 3000.
  4. В Docker указать параметры:
  redis:
    image: redis:latest
    ports:
      - "6379:6379"
    ulimits:
      nofile:
        soft: 65535
        hard: 65535
    command: ["redis-server", "--maxclients", "3000"]

Вопрос: Не сохраняются файлы, не загружается сервис окружений.

Ответ: Наиболее вероятная причина – проблема с настройкой хранилища. Оно либо не было создано, либо существующее хранилище не было привязано к соответствующей политике.

В настройках хранилища обязательно должны быть указаны параметры подключения (путь к хранилищу и другие). Также в пути к хранилищу не должна быть указана временная директория (папка /tmp/), так как данные из нее могут быть утеряны.


Вопрос: Как просмотреть логи определенного сервиса в Kubernetes?

Ответ: Для просмотра логов сервиса необходимо выполнить следующие команды:

1. Найти идентификатор пода:

kubectl get pods | grep "наименование_сервиса"

В результате будет получена строка с идентификатором пода.

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

kubectl logs 'идентификатор_сервиса'

Будут получены все развернутые логи.


Вопрос: Почему в реестре процессов не создается экземпляр процесса?

Ответ: Необходимо проверить корректность настройки сервисов Zeebe, Operate и Elasticsearch. Сервис Operate для отображения данных использует индексы, созданные Zeebe, поэтому оба сервиса должны быть настроены на подключение к одному и тому же экземпляру или кластеру Elasticsearch.


Вопрос: Почему появляется ошибка «Отсутствуют актуальные лицензионные условия»?

Ответ: В версиях 1.10 и 1.11 данная ошибка не влияет на работоспособность системы.


Вопрос: По каким причинам в системе может не работать полнотекстовый поиск?

Ответ: Необходимо проверить настройки топика Kafka – сервис-индексатор полнотекстового поиска может слушать не тот топик Kafka, из-за чего данные не попадают в Elasticsearch. Необходимо обратиться к команде DevOps для проверки и корректировки конфигурации топиков. Возможны проблемы с настройками Elasticsearch.

Также для обеспечения полноценной работы полнотекстового поиска и индексации содержимого файлов необходимо установить и настроить Debezium.

Описание установки: Установка Debezium с помощью Docker

Описание настройки: Настройки Debezium


Вопрос: Сервис уведомлений (dh-email-notifications) не работает, какие возможны варианты решения проблемы?

Ответ: Возможный вариант решения проблемы – со стороны DevOps-инженеров (или иных сотрудников, разворачивающих сервисы) необходимо проверить настройки для данного сервиса (dh-email-notifications).

img

img

В настройках необходимо настроить HOST и PORT.

img

Затем указать адрес SMTP-сервера.

Настройка сервиса dh-email-notifications необязательна для работоспособности Платформы.


Вопрос: Возникла ошибка, которую невозможно интерпретировать по тексту в пользовательском интерфейсе или консоли разработчика. Что можно предпринять для диагностики?

Ответ: Для диагностики необходимо самостоятельно или с привлечением команды DevOps проанализировать логи сервисов. Следует определить к какому сервису выполнялось обращение в момент ошибки и последовательно изучить его логи, а также логи зависимых сервисов по цепочке вызовов.


Вопрос: Почему в реестре процессов не создается экземпляр процесса?

Ответ: Необходимо проверить корректность настройки сервисов Zeebe, Operate и Elasticsearch. Сервис Operate для отображения данных использует индексы, созданные Zeebe, поэтому оба сервиса должны быть настроены на подключение к одному и тому же экземпляру или кластеру Elasticsearch.


Вопрос: Проблема с индексацией поиска. Почему может не выполняться поиск по объектам?

Ответ: Необходимо указать настройки для подключения любого документного сервиса к индексированию контента (на примере ldm-system-objects-service):

1. Настройки dh-federal-search-service:

  • через сервис конфигураций необходимо добавить в переменную «docshouse.federal-search.services.names» в конец списка наименование нового сервиса:
docshouse.federal-search.services.names = dh-documents-service,...,ldm-system-objects-service

или с помощью DevOps-инженеров в переменную окружения «FEDERAL_SEARCH_INDEXED_SERVICES_NAME»;

  • через сервис конфигураций необходимо добавить в переменную «docshouse.federal-search.services.topics» в конец списка наименование топика нового сервиса:
docshouse.federal-search.services.topics = test-dh-documents-service-topic,...,test-ldm-system-objects-service-topic

или с помощью DevOps-инженеров в переменную окружения «FEDERAL_SEARCH_CHANGED_ACL_SERVICES_TOPICS».

2. Настройки ldm-index-content-controller-service:

  • через сервис конфигураций добавить в переменную «ldm.index-content-controller.documentsApplications» в конец списка наименование нового сервиса:
ldm.index-content-controller.documentsApplications = dh-documents-service,ldm-system-objects-service
  • через сервис конфигураций добавить в переменную «ldm.index-content-controller.documentsTopics» в конец списка наименование топика нового сервиса:
ldm.index-content-controller.documentsTopics = test-dh-documents-service-topic,test-ldm-system-objects-service-topic

или с помощью DevOps-инженеров в переменную окружения «DH_INDEX_CONTENT_CONTROLLER_KAFKA_LISTENER_TOPIC_LIST».

3. Перезапустить dh-federal-search-service и ldm-index-content-controller-service.

На стенде префикс сервисов может отличаться (в примере указан префикс «test»).

Настройки маршрутизации распознавания контента файлов описаны в документации: Настройки маршрутизации распознавания контента файлов