7.2. Сетевое взаимодействие #

Сетевое взаимодействие между менеджером и агентом может инициироваться обеими сторонами:

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

  • Агенты могут отправлять менеджеру запросы на собственную регистрацию, регистрацию экземпляров СУБД, а также запросы на обновление состояния экземпляров. Менеджер, в свою очередь, должен отправить агенту ответ на запрос.

Для взаимодействия менеджер и агент используют протокол HTTPS. Менеджер по умолчанию использует порт tcp/8080 (без mTLS) или tcp/9443 (с mTLS), агент использует по умолчанию порт tcp/8081. Такое направление трафика следует учитывать при настройке правил сетевого доступа. Параметры адресов и портов указываются в файлах конфигурации менеджера ppem-manager.yml и агентов ppem-agent.yml.

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

Если PPEM применяется для управления кластерами, сервер менеджера должен уметь разрешать сетевые адреса всех серверов, на которых работают агенты. За подробной информацией обратитесь к Разделу 44.1.

7.2. Networking #

Networking between the manager and agent can be initiated by either side:

  • The manager can send control instructions to agents, and agents return the execution results in response.

  • Agents can send to the manager requests to register themselves and DBMS instances as well as to update the state of instances. The manager, in turn, sends a response to the agents’ requests.

The manager and agent use the HTTPS protocol for communication. By default, the manager uses the tcp/8080 (no mTLS) or tcp/9443 (mTLS) port, and the agent uses the tcp/8081 port. This traffic direction must be taken into account when configuring network access rules. The address and port are specified in the ppem-manager.yml manager and ppem-agent.yml agent configuration files.

For secure data transfer, TLS configuration is recommended. Also, to add an additional layer of security, you can configure mutual TLS on both the manager and agent sides.

If you use PPEM to manage clusters, the manager's server must be able to resolve network names of all servers where the agents are running. For more information, refer to Section 44.1.

FAQ