Конфигурация RPC

Данный документ описывает конфигурацию RPC в системе Zero. Вы можете настроить текущий экземпляр Zero как две роли RPC: Сервер/Клиент. RPC требует микросервисной среды вместо автономной, это означает, что вы должны сначала прочитать этот документ: 2.3 — Микросервисная среда.

1. Сервер RPC

Вы можете настроить сервер RPC непосредственно в vertx-server.yml, нет необходимости создавать новые файлы конфигурации.

- name: ipc-cronus
  type: ipc
  config:
    port: 6883
    host: 0.0.0.0
    ssl: false
    type: PEM

Можно добавить новый узел типа ipc (IPC — внутренний вызов процесса) вместо http. Вот дополнительная информация о конфигурации RPC для включения SSL.

• ssl: Включение SSL-соединения с RPC.
• type: Здесь представлены три типа SSL, пожалуйста, обратитесь к документации gRpc/vertx для получения более подробной информации о типах:
  • JKS
  • PKCS12
  • PEM.

2. Клиент RPC

Конфигурацию клиента RPC необходимо настраивать отдельно. Вот комментарии:

В вашей конфигурации vertx.yml up.god.file вы должны расширить другой узел lime следующим образом:

zero:
  lime: etcd3, rpc

Затем вы должны создать новый файл up.god.file vertx-rpc.yml со следующим содержимым:

rpc:
  ssl: false
  uniform:
    type: PEM
  extension:
    {name}:
      type: XXX

Обратите внимание на атрибуты uniform и extension: они одинаковы, за исключением следующего:

• Система будет сканировать всю конфигурацию клиента под расширением по имени, установленному первым. Например, целевая имя — up-ceous, вы должны установить {name} в up-ceous. Тогда при текущем взаимодействии сервиса с сервисом up-ceous конфигурация клиента будет использоваться под extension, а не uniform.
• Если нет конфигурации под расширением, будет использоваться конфигурация uniform. Uniform — это просто конфигурация клиента по умолчанию.

Эта конфигурация up.god.file используется только в режиме SSL.

3. Конфигурация SSL (примеры)

Вот несколько примеров конфигурации SSL для RPC.

## vertx-server.yml
# Сервер RPC с PEM (OpenSSLEngine)
- name: ipc-cronus
  type: ipc
  config:
    port: 6883
    host: 0.0.0.0
    ssl: true
    type: PEM
    cert: tlk/server-cert.pem
    key: tlk/server-key.pem

# Сервер RPC с Jsk (JSKEngine)
- name: ipc-cronus
  type: ipc
  config:
    port: 6883
    host: 0.0.0.0
    ssl: true
    type: JKS
    jsk: tlk/server-key.jks
    password: wibble

## vertx-rpc.yml (имя зависит от lime)
# Клиент RPC использует значение по умолчанию
rpc:
  ssl: true
  uniform:
    type: PEM
    cert: tlk/server-cert.pem
    key: tlk/server-key.pem

# Клиент RPC со специальной службой

rpc:
  ssl: true
  uniform:
    type: PEM
    cert: tlk/server-cert.pem
    key: tlk/server-key.pem
  extension:
    up-cerous:
      type: JKS
      jsk: tlk/server-key.jks
      password: wibble