| Status | ||||
|---|---|---|---|---|
|
iQChannels IQChannels поддерживает работу в режиме кластера для обеспечения отказоустойчивости и горизонтальной масштабируемости сервера приложений.
Особенности кластера:
- В кластере может быть несколько нод с серверным приложением IQChannels iQChannels (рекомендуется до 3–5).
- Все ноды в кластере равноправны, нет Single Point of Failure.
- База данных iQChannels работает в режиме standby.
- Балансировка входящих подключений между нодами, как со стороны клиентов, так и со стороны операторов, происходит с помощью Nginx или любого другого прокси-сервера.
- Ноды взаимодействуют между собой по внутреннему Cluster API, построенному поверх ZeroMQ и работающему на порте
:3010через Redis Sentinel. - В случае выхода из строя одной или нескольких нод Nginx автоматически распределяет подключения между работающими нодами.
- Конфигурация нод должна быть одинаковой, в конфигурации каждой ноды должны быть указаны адреса всех нод кластера.
Пример развертывания кластера:
Конфигурации оборудования:
https://wiki.iqstore.ru/pages/viewpage.action?pageId=2950032
Запуск iQChannels в режиме кластера:
1. Создать файл docker-compose.yml, в котором запускаются docker-образ iQChannels и Redis c поддержкой кластеризации. Пример такого файла docker-compose (2).yaml
2. В docker-compose прописать через volumes путь до файла с конфигом и папки, где будут хранится логи.
| Code Block | ||
|---|---|---|
| ||
volumes:
- /путь до файла на Вашем компьютере/config.yaml:/iqchannels/config/config.yaml
- /папка на Вашем компьютере:/iqchannels/var/log/ |
3. Контейнеры будут брать за основу config.yaml на вашем сервер из пункта 2. В config.yaml есть отдельный раздел - Clusterization. Для включения режима кластера пропишите:
| Code Block | ||
|---|---|---|
| ||
cluster_mode: # cluster mode is disabled by default
enabled: true # to enable clusterization you also need to provide redis settings bellow |
Для работы в кластерном режиме iQChannels использует Redis. Redis обязателен для работы кластеров. Redis может работать в трех режимах: single,cluster,sentinel. Примеры для настройки всех 3 режимов:
Single:
| Code Block | ||
|---|---|---|
| ||
redis:
mode: single # single, sentinel or cluster
network: tcp # The network type, either tcp or unix. Default is tcp.
addr: localhost:49153 # host:port address. Addr string for single or sentinel instance
db: 1 # Database to be selected after connecting to the server.
user: default # user from redis instance
password: redispw # pass
cluster_addrs: # list of cluster nodes in format host:port, only for cluster mode
max_retries: 3 # // Maximum number of retries before giving up. Default is 3 retries; -1 (not 0) disables retries.
dial_timeout: 5 # default 5 seconds
min_idle_conns: 1 # default 0
max_idle_conns: 10 # default 0
min_retry_backoff: 8 #Minimum backoff between each retry in milliseconds. Default is 8 milliseconds; -1 disables backoff.
max_retry_backoff: 512 #Maximum backoff between each retry. Default is 512 milliseconds; -1 disables backoff.
pool_fifo: true # Type of connection pool. true for FIFO pool, false for LIFO pool. Note that FIFO has slightly higher
#overhead compared to LIFO,but it helps closing idle connections faster reducing the pool size.
pool_size: 10 # Maximum number of socket connections. Default is 10 connections per every available CPU as reported by runtime.GOMAXPROCS. |
Sentinel:
| Code Block | ||
|---|---|---|
| ||
redis:
mode: sentinel
master_name: master # The master name.
sentinel_addrs: # A seed list of host:port addresses of sentinel nodes.
-
-
client_name: client # ClientName will execute the `CLIENT SETNAME ClientName` command for each conn.
sentinel_username: sentinel # // If specified with SentinelPassword, enables ACL-based authentication (via AUTH <user> <pass>)
sentinel_password: pass # // Sentinel password from "requirepass <password>" (if enabled) in Sentinel configuration, or, if SentinelUsername is also supplied, used for ACL-based authentication.
route_randomly: false # Allows routing read-only commands to the random master or replica node.
route_by_latency: true # Allows routing read-only commands to the closest master or replica node.
replica_only: false #Route all commands to replica read-only nodes.
min_retry_backoff: 8 #Minimum backoff between each retry in milliseconds. Default is 8 milliseconds; -1 disables backoff.
max_retry_backoff: 512 #Maximum backoff between each retry. Default is 512 milliseconds; -1 disables backoff.
db: 1 # Database to be selected after connecting to the server.
user: default # user from redis instance
password: redispw # pass
max_retries: 3 # // Maximum number of retries before giving up. Default is 3 retries; -1 (not 0) disables retries.
dial_timeout: 5 # default 5 seconds
min_idle_conns: 1 # default 0
max_idle_conns: 10 # default 0
pool_fifo: true # Type of connection pool. true for FIFO pool, false for LIFO pool. Note that FIFO has slightly higher
# #overhead compared to LIFO,but it helps closing idle connections faster reducing the pool size.
pool_size: 10 # Maximum number of socket connections. Default is 10 connections per every available CPU as reported by runtime.GOMAXPROCS. |
Cluster:
| Code Block | ||
|---|---|---|
| ||
redis: mode: cluster network: tcp # The network type, either tcp or unix. Default is tcp. addr: localhost:49153 # host:port address db: 1 # Database to be selected after connecting to the server. user: default # user from redis instance password: redispw # pass cluster_addrs: # list of cluster nodes in format host:port, only for cluster mode # - # - max_retries: 3 # // Maximum number of retries before giving up. Default is 3 retries; -1 (not 0) disables retries. dial_timeout: 5 # default 5 seconds min_idle_conns: 1 # default 0 max_idle_conns: 10 # default 0 min_retry_backoff: 8 #Minimum backoff between each retry in milliseconds. Default is 8 milliseconds; -1 disables backoff. max_retry_backoff: 512 #Maximum backoff between each retry. Default is 512 milliseconds; -1 disables backoff. pool_fifo: true # Type of connection pool. true for FIFO pool, false for LIFO pool. Note that FIFO has slightly higher ## #overhead compared to LIFO,but it helps closing idle connections faster reducing the pool size. pool_size: 10 # Maximum number of socket connections. Default is 10 connections per every available CPU as reported by runtime.GOMAXPROCS. |
4. Пропишите нужное кол-во сервисов iQChannels и Redis через docker-compose или командную строку docker и запустите. 