Просмотр кода страницы PC via queues

=Описание=
Описание схемы встраивания, в которой используются очереди, доступно по ссылке:

https://repo.paycontrol.org/server/doc/latest/pc-handbook/ru/#использование-очередей-для-ограничения-соединений-от-pce-к-pcs.


Экземпляр RabbitMQ, в котором будут автоматически созданы две очереди, загружается и разворачивается заказчиком.

Загрузить RabbitMQ можно на сайте: https://www.rabbitmq.com


Приложение состоит из двух модулей:
* для зоны DMZ - ''pc-dmz-queue-1.0.jar'';
* для внутренней сети ''pc-queue-lan-1.0.jar''.

=Файлы для запуска=
==Linux==
Файлы запуска имеют разрешение ''.service''.

Для корректной работы приложения необходимо их отредактировать под конкретное окружение.

''WorkingDirectory=/opt/clientSide'' - директория в которой располагается исполняемый файл конкретного приложения

''ExecStart=java -Xms256m -Xmx512m -jar /opt/clientSide/clientSide-1.0.jar /opt/clientSide/application.yml'' - строка для запуска приложения

Также необходимо обратить на пути до приложения и файла настроек

''User=pcontrol'' - пользователь под которым будет запускаться приложение.

=Установка=
==pc-dmz-queue==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-dmz-queue\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-dmz-queue\
winsw.exe install pc-dmz-queue-1.0.jar
</source>

Логи пишутся в ''C:\pc-dmz-queue\''.

Созданной службой можно усправлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-dmz-queue
</source>
В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-dmz-queue -s /sbin/nologin username
</source>
Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>
Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-dmz-queue.service /etc/systemd/system/
sudo systemctl enable pc-dmz-queue.service
sudo systemctl start pc-dmz-queue.service
</source>
Для просмотра журнала работы сервиса необходимо использовать 
<source lang="bash">
journalctl -u pc-dmz-queue.service
</source>

==pc-queue-lan==
===Windows===
Распакуйте архив в корень диска, так, чтобы файл ''winsw.exe'' был доступен по пути ''C:\pc-queue-lan\winsw.exe''

В командной строке выполните следующие команды
<source lang="cmd">
cd C:\pc-queue-lan\
winsw.exe install pc-queue-lan-1.0.jar
</source>

Логи пишутся в ''C:\pc-queue-lan\''.

Созданной службой можно управлять из приложения Службы(Services).

Настройка подключений производится в ''application.yml''.

===Linux===
Создать папку
<source lang="bash">
mkdir /opt/pc-queue-lan
</source>

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
<source lang="bash">
groupadd -r username
useradd -r -g username -d /opt/pc-queue-lan -s /sbin/nologin username
</source>

Предоставить доступ на запуск файлу start.sh
<source lang="bash">
chmod +x start.sh
</source>

Скопировать файл сервиса, запустить его и включить автозапуск
<source lang="bash">
sudo cp -v pc-queue-lan.service /etc/systemd/system/
sudo systemctl start pc-queue-lan.service
sudo systemctl enable pc-queue-lan.service
</source>

Для просмотра журнала работы сервиса необходимо использовать 
<source lang="bash">
journalctl -u pc-queue-lan.service
</source>

=Конфигурирование модулей=
Установка параметров работы модулей производится в файле application.yml.

==Настройка входящих соединений==
Можно уточнить сетевой порт и адрес, который  будет слушать модуль.
<source lang="yml">
server:
  port: 8090
  address: 0.0.0.0
</source>

0.0.0.0 - означает что модуль будет принимать все запросы на любых сетевых интерфейсах

==Настройка подключения к брокеру очередей==
Модули работают с брокером RabbitMQ. Пример параметров подключения:
<source lang="yml">
spring:
  rabbitmq:
    username: user
    password: pass
    virtual-host: /
    host: example.rabbit.loc
    port: 5672
</source>

==Настройка модуля pc-queue-lan для подключения к серверу PCS==
Адрес и порт сервера PCS:
<source lang="yml">
paycontrol:
  url: pcs.loc
  port: 8080
</source>

=Настройка PC на работу через очередь=
==Настройка PC External==
Для настройки PC External на отправку сообщений в очередь, необхоимо в файле 
* Linux - `/opt/wildfly/bin/standalone.conf`
* Windows - `wildfly\bin\standalone.conf.bat`
в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-dmz-queue, например:

===v3===
<source lang="bash">
-Dpcservice.endpoint=http://localhost:8090/ws/PayControlServiceV3?wsdl
</source>
===v5===
<source lang="bash">
-Dpc_url=http://localhost:8090/pc-api/
</source>

При этом адрес эндпоинта должен оставаться таким-же как и для сервера PC Server.

==Настройка PC Server==
Внесение настроек на сервер PC Server не требуется.