Сервис artixcs-discovery предназначен для маршрутизации REST-запросов с портов 8080 и 80 на внутренние порты сервисов сервера.

Основные настройки сервиса artixcs-discovery

Настройки сервиса artixcs-discovery доступны по адресу http://<ip>:8500/ui на вкладке "Key / Value"|"rest-routing-settings":

Настройка работы artixcs-discovery по протоколу HTTPS

Для работы по протоколу HTTPS необходимо:

1. Получить или сгенерировать SSL-сертификат.

   Пример генерации самоподписанного сертификата

   sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ./privkey.key -out ./fullchain.pem

2. Создать директории и сохранить в ней файлы сертификата и ключа:

   • /etc/nginx/ssl/rest-routing/fullchain.pem – файл сертификата.

   • /etc/nginx/ssl/rest-routing/privkey.key – файл ключа.

3. В веб-интерфейсе сервиса artixcs-discovery по адресу http://<ip>:8500/ui на вкладке "Key / Value" создать группу параметров "server-settings/".

4. Добавить в группу параметры:

   Key	Value
   dualMode	true
   ssl-key-store-password	<свой пароль>
   sslPort	8443

5. Перезапустить сервис consul-template:

   service consul-template restart

Особенности настройки nginx при работе с artixcs-discovery

При работе с сервисом artixcs-discovery осуществляется перенаправление запросов с помощью сервиса nginx. В конфигурации nginx для artixcs-discovery уже заданы настройки, необходимые для корректного функционирования.

Дополнительно реализована возможность добавления индивидуальных настроек nginx через конфигурационные файлы вида:

• /etc/nginx/conf.d/artix/ext-http*.conf – конфигурация секции http,

  Пример

  /etc/nginx/conf.d/artix/ext-http.conf

• /etc/nginx/conf.d/artix/servers/ext-main*.conf –  конфигурация основной секции server,


  Пример

  /etc/nginx/conf.d/artix/servers/ext-main.conf

• /etc/nginx/conf.d/artix/locations/ext-<имя сервиса>*.conf – конфигурация секции location (используется для настройки сервисов Artix).

  Пример

  /etc/nginx/conf.d/artix/locations/ext-artixcs-rest-buffering.conf

Подключение сервисов к Consul

Для подключения сервисов, установленных на отдельную машину, к Consul необходимо вручную добавить параметры в файл /opt/<Название сервиса>/application.properties.

spring.cloud.consul.host=localhost
spring.cloud.consul.port=8500

Для корректного подключения сервисов к Consul можно вручную добавить параметр в файл /opt/<Название сервиса>/application.properties, прописав приоритетную сеть для подключения.

spring.cloud.inetutils.preferred-networks[0]=192.169.*

При настройке сервисов в docker-контейнере через переменные окружения необходимо привести названия параметров к верхнему регистру и заменить символы "." в названиях на символы "_".

SPRING_CLOUD_CONSUL_HOST=localhost
SPRING_CLOUD_CONSUL_PORT=8500

Регистрация и авторизация сервисов в Consul

Взаимодействие с сервисами через Consul UI доступно только авторизованным пользователям. Для авторизации администратора используется токен SecretID, который записан в файле /opt/artixcs-discovery/bootstrap.json. Токен генерируется автоматически при установке artixcs-discovery.

Для регистрации на Consul необходимо вручную добавить параметр su.artix.discovery.enabled, со значением true в файле /opt/<Название сервиса>/application.properties. Начиная с версии КС #62 настройка скрыта и включена по умолчанию при условии использования обновленных сервисов.

Для авторизации сервисов в Consul используются ACL-токены.

По умолчанию для всех сервисов прописан один токен. Чтобы переопределить ACL-токен сервиса необходимо:

1. Перейти по адресу http://<ip>:8500/ui/dc1/acls/tokens.
2. Авторизоваться в Consul UI используя SecretID.
3. Сгенерировать новый токен.
4. Открыть сгенерированный токен и скопировать значение поля "Token".
5. Вручную добавить параметр spring.cloud.consul.discovery.acl-token, указав скопированное значение в файле /opt/<Название сервиса>/application.properties.
6. Перейти по адресу http://<ip>:8500/ui/dc1/acls/tokens.

Для того чтобы закрыть сервисам доступ к Consul по старому токену необходимо:

1. Перейти по адресу http://<ip>:8500/ui/dc1/acls/tokens.
2. Авторизоваться в Consul UI используя SecretID.
3. Вставить в строку поиска токен AccessorID, который записан в файле /opt/artixcs-discovery/artix-access-token.json.
4. Открыть и удалить найденный токен.

Стартовая страница для перехода к основным сервисам Artix

Страница доступна по адресу http://<ip-адрес сервера>:8080/artix. При переходе на корневой URL http://<ip-адрес сервера> редирект на стартовую страницу осуществляется автоматически.

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

На странице отображается полный список основных сервисов, к которым может быть осуществлен переход:

• artixcs-controlcenter – Control Center,
• tomcat8-artix – Loyalty,
• docker-образ artixcs-pricechecker – Price Checker,
• artixcs-ads – Digital Signage,
• artixcs-consultant-app – Consultant App.

Для данных сервисов поддерживается перенаправление запросов по коротким контекстным путям:

• /сс – Control Center,
• /loyalty – Loyalty (начиная с версии 1.0.60 и выше),
• /pch – Price Checker (начиная с версии 2.3.0 и выше),
• /ads – Digital Signage (начиная с версии 1.0.2 и выше),
• /capp – Consultant App (начиная с версии 1.0.60 и выше).