Текущая версия от 12:01, 8 октября 2025

Описание

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

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

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

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

Для корректной работы с очередями нужно создать админ-пользователя помимо guest и настроить подключение через этого нового пользователя.

Приложение состоит из двух модулей:

для зоны DMZ - pc-queue-dmz-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

В командной строке выполните следующие команды

cd C:\pc-queue-dmz\
winsw.exe install pc-queue-dmz-1.0.jar

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

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

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

Linux

Создать папку

mkdir /opt/pc-queue-dmz

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.

groupadd -r username
useradd -r -g username -d /opt/pc-queue-dmz -s /sbin/nologin username

Предоставить доступ на запуск файлу start.sh

chmod +x start.sh

Скопировать файл сервиса, запустить его и включить автозапуск

sudo cp -v pc-dmz-queue.service /etc/systemd/system/
sudo systemctl enable pc-queue-dmz.service
sudo systemctl start pc-queue-dmz.service

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

journalctl -u pc-queue-dmz.service

pc-queue-lan

Windows

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

В командной строке выполните следующие команды

cd C:\pc-queue-lan\
winsw.exe install pc-queue-lan-1.0.jar

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

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

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

Linux

Создать папку

mkdir /opt/pc-queue-lan

В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.

groupadd -r username
useradd -r -g username -d /opt/pc-queue-lan -s /sbin/nologin username

Предоставить доступ на запуск файлу start.sh

chmod +x start.sh

Скопировать файл сервиса, запустить его и включить автозапуск

sudo cp -v pc-queue-lan.service /etc/systemd/system/
sudo systemctl start pc-queue-lan.service
sudo systemctl enable pc-queue-lan.service

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

journalctl -u pc-queue-lan.service

Конфигурирование модулей

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

Настройка входящих соединений

Можно уточнить сетевой порт и адрес, который будет слушать модуль.

server:
  port: 8090
  address: 0.0.0.0

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

Настройка подключения к брокеру очередей

Модули работают с брокером RabbitMQ. Пример параметров подключения:

spring:
  rabbitmq:
    username: exampleuser
    password: examplepass
    virtual-host: /
    host: example.rabbit.loc
    port: 5672

Настройка модуля pc-queue-lan для подключения к серверу PCS

Адрес и порт сервера PCS:

paycontrol:
  url: example.pcs.loc
  port: 8080

Настройка PC на работу через очередь

Настройка PC External

Для настройки PC External на отправку сообщений в очередь, необхоимо в файле

Linux - `/opt/wildfly/bin/standalone.conf`
Windows - `wildfly\bin\standalone.conf.bat`

в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-queue-dmz, например:

v3

-Dpcservice.endpoint=http://localhost:8090/ws/PayControlServiceV3?wsdl

v5

-Dpc_url=http://localhost:8090/pc-api/

v6

pc:
  external:
    server:
      url: http://localhost:8090/pc-api/

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

Настройка PC Server

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

@@ Строка 1: / Строка 1: @@
 =Описание=
+Описание схемы встраивания, в которой используются очереди, доступно по ссылке:
+https://repo.paycontrol.org/server/doc/latest/pc-handbook/ru/#использование-очередей-для-ограничения-соединений-от-pce-к-pcs.
+Экземпляр RabbitMQ, в котором будут автоматически созданы две очереди, загружается и разворачивается заказчиком.
+Загрузить RabbitMQ можно на сайте: https://www.rabbitmq.com
+Для корректной работы с очередями нужно создать админ-пользователя помимо guest и настроить подключение через этого нового пользователя.
 Приложение состоит из двух модулей:
-* для зоны DMZ - ''pc-dmz-queue-1.0.jar'';
+* для зоны DMZ - ''pc-queue-dmz-1.0.jar'';
 * для внутренней сети ''pc-queue-lan-1.0.jar''.
@@ Строка 25: / Строка 37: @@
 В командной строке выполните следующие команды
 <source lang="cmd">
-cd C:\pc-dmz-queue\
+cd C:\pc-queue-dmz\
-winsw.exe install pc-dmz-queue-1.0.jar
+winsw.exe install pc-queue-dmz-1.0.jar
 </source>
-Логи пишутся в ''C:\pc-dmz-queue\''.
+Логи пишутся в ''C:\pc-queue-dmz\''.
-Созданной службой можно усправлять из приложения Службы(Services).
+Созданной службой можно управлять из приложения Службы(Services).
 Настройка подключений производится в ''application.yml''.
@@ Строка 38: / Строка 50: @@
 Создать папку
 <source lang="bash">
-mkdir /opt/pc-dmz-queue
+mkdir /opt/pc-queue-dmz
 </source>
 В настройках файлов `.service` указать пользователя wildfly или создать нового, с аналогичными параметрами.
 <source lang="bash">
 groupadd -r username
-useradd -r -g username -d /opt/pc-dmz-queue -s /sbin/nologin username
+useradd -r -g username -d /opt/pc-queue-dmz -s /sbin/nologin username
 </source>
 Предоставить доступ на запуск файлу start.sh
@@ Строка 52: / Строка 64: @@
 <source lang="bash">
 sudo cp -v pc-dmz-queue.service /etc/systemd/system/
-sudo systemctl enable pc-dmz-queue.service
+sudo systemctl enable pc-queue-dmz.service
-sudo systemctl start pc-dmz-queue.service
+sudo systemctl start pc-queue-dmz.service
 </source>
 Для просмотра журнала работы сервиса необходимо использовать
 <source lang="bash">
-journalctl -u pc-dmz-queue.service
+journalctl -u pc-queue-dmz.service
 </source>
@@ Строка 123: / Строка 135: @@
 spring:
    rabbitmq:
-     username: user
+     username: exampleuser
-     password: pass
+     password: examplepass
      virtual-host: /
-     host: rabbit.loc
+     host: example.rabbit.loc
      port: 5672
 </source>
@@ Строка 133: / Строка 145: @@
 Адрес и порт сервера PCS:
 <source lang="yml">
-* paycontrol:
+paycontrol:
-   * url: pcs.loc
+   url: example.pcs.loc
-   * port: 8080
+   port: 8080
 </source>
@@ Строка 143: / Строка 155: @@
 * Linux - `/opt/wildfly/bin/standalone.conf`
 * Windows - `wildfly\bin\standalone.conf.bat`
-в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-dmz-queue, например:
+в параметрах переменных окружения, вместо адреса сервера PCS задать адрес модуля pc-queue-dmz, например:
 ===v3===
@@ Строка 152: / Строка 164: @@
 <source lang="bash">
 -Dpc_url=http://localhost:8090/pc-api/
+</source>
+===v6===
+<source lang="yml">
+pc:
+  external:
+    server:
+      url: http://localhost:8090/pc-api/
 </source>