...
| Переменная | Значение по умолчанию | Описание |
|---|---|---|
COMPOSE_PROJECT_NAME | postgres | Название проекта в docker-compose (используется для идентификации, в случае если на сервере запущено несколько проектов) |
POSTGRES_TAG | 2.6 | Версия образа контейнера postgres |
POSTGRES_REGISTRY | hub.eltex-co.ru | Адрес docker-registry, с которого будет выполняться получение образа postgres. Если используется локальное зеркало, то можно указать его адрес |
ECCM_NETWORK_MODE | standalone | Режим работы ЕССМ. Доступные значения: cluster, standalone. Если переменная не задана, значение будет установлено в standalone автоматически при запускезапуске compose-tools.sh без флага "--cluster". |
KEEPALIVE_INTERVAL | 5 | Интервал секундах, в течение которого keepalived будет ожидать ответа от нодыозначающий проверку доступности узла кластера. При истечении времени, если ответа не последовало, keepalived переключится на другую доступную ноду. |
ROOT_POSTGRES_USER | Параметр, позволяющий переопределить логин суперпользователя для доступа и конфигурирования базы данных | |
ROOT_POSTGRES_PASSWORD | Параметр, позволяющий переопределить пароль суперпользователя для доступа и конфигурирования базы данных | |
ECCM_DATABASE | eccm | Название базы данных стека сервисов eccm |
POSTGRES_TIMEZONE | Asia/Novosibirsk | Временной пояс, в котором работает система (указывается в соответствии с tz database, например "Asia/Novosibirsk") |
POSTGRES_SHM_SIZE | 2gb | Ограничение выделенной оперативной памяти для работы с БД PostgreSQL |
POSTGRES_PRIVILEGED_MODE | false | Запуск контейнера в привилегированном режиме |
|
| Внешний адрес БД PostgreSQL |
| 5432 | Порт, на котором доступна БД PostgreSQL |
|
| Максимальное количество лог-файлов контейнеров |
| 50M | Максимальный размер лог-файлов контейнеров |
| true | Разрешение сжатия лог-файлов контейнеров |
|
| Версия образа контейнера postgres-configurator |
| true | Активация запуска контейнера postgres-configurator при старте системы |
...
Якорь Cluster Cluster
.env.cluster
| Cluster | |
| Cluster |
В файле .env.cluster находятся переменные, определяющие поведение кластера при инсталяции ЕССМ в отказоустойчивой системе. В таблице ниже представлено описание данных переменных:
| Переменная | Значение по умолчанию | Описание | ||
|---|---|---|---|---|
ECCM_NETWORK_MODE | cluster | Режим работы ЕССМ. Доступные значения: cluster, standalone
| ||
| false | Использование перезапуска кластераИспользование перезапуска кластера с принудительным назначением ролей БД. Используется в случаях разрушения кластера или необходимости обновления | ||
| MASTER | Роль ноды. Не заполняется, если не используется внешная база данных PostgreSQLвнешней базы данных при развертывании кластера. Используется только при инсталляции ЕССМ в отказоустойчивой системе с разделением приложения и БД | ||
| IP-адрес подключения к внешней базе базы данных PostgreSQL, установленной на другом хосте. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL | |||
| 5432 | Порт подключения к внешней базе данных PostgreSQL, установленной на другом хосте. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL | ||
| IP-адерс адрес подключения к внешней бэкап-slave базе данных PostgreSQL, установленной на другом хосте. Использовать при развертывании отказоустойчивой системы с разделением на приложение и БД | |||
| 5432 | Порт подключения к внешней бэкап-slave базе данных PostgreSQL, установленной на другом хосте. Использовать при развертывании отказоустойчивой системы с разделением на приложение и БД | ||
| repmgr | Наименование служебной базы данных, которая используется для отслеживания состояния баз данных в кластере | ||
| repmgr | Имя пользователя, созданного для управления работой и связью между серверами баз данных в кластере | ||
| repmgr | Пароль, обеспечивающий безопасный доступ к служебной базе данных для пользователя REPMGR_USER | ||
| 5 | Время в секундах, в течение которого система будет ожидать ответа при подключении к базе данных master-нодыPostgreSQL | ||
| 2 | Интервал в секундах, с которым система проверяет состояние и доступность всех серверов в кластере | ||
| 3 | Количество повторных попыток для установления соединения с другим сервером в случае сбоя. Каждая Каждая попытка выполняется в течение REPMGR_RECONNECT_INTERVAL | ||
| 3 | Время в секундах между повторными попытками соединения с сервером после неудачи | ||
| Разрешенные хосты для подключения в кластер. Указываются все IP-адреса нод, составляющих кластер: master-нода, slave-ноды и witness-нода | |||
| IP-адрес master-ноды. При неуказанном значении переменная автоматически заполнится именем хоста сервера, с которого происходит запуск мастер-ноды | |||
| master | Наименование master-ноды внутри базы данных ECCM | ||
| 1 | Уникальный идентификатор master-ноды | ||
| IP-адрес slave-ноды. При неуказанном значении переменная автоматически заполнится именем хоста сервера, с которого происходит запуск -адрес slave-ноды | |||
| slave | Наименование slave-ноды внутри базы данных ECCM | ||
| 2 | Уникальный идентификатор slave-ноды | ||
| IP-адрес witness-ноды. При неуказанном значении переменная автоматически заполнится именем хоста сервера, с которого происходит запуск witness-ноды | |||
| witness | Наименование witness-ноды внутри базы данных ECCM | ||
| 100 | Уникальный идентификатор witness-ноды | ||
| Внутренний адрес сервера, используемый Redis Sentinel для связи внутри кластера. Если переменная не задана, значение будет определено автоматически при запуске | |||
| Уникальное имя, присваиваемое кластеру баз данных для их мониторинга | |||
| Пароль, используемый службой мониторинга для подключения к кластеру баз данных и получения информации о состоянии серверов | |||
| 1 | Количество нод, используемых в репликации. Учитывается только количество slave-нод | ||
| 5000 | Время в миллисекундах после которого служба мониторинга считает ноду недоступной | ||
| 10000 | Максимальное время в миллисекундах, в течение которого система мониторинга пытается завершить процесс автоматического переключения мастерства между нодами | ||
| 0.0.0.0 | Сетевые адреса, на которых сервер ожидает входящие подключения для репликации
| ||
| eccm | Имя основной базы данных ЕССМ. Дублируется имя базы данных из postgres/.env | ||
| 5 | Время в секундах между последовательными попытками проверки готовности базы данных принимать подключения |
...
| Опция | Описание | ||
|---|---|---|---|
| --clean, -c | Очистка всех контейнеров, томов и сетей | ||
| --delete-containers | Удаление контейнеров без удаления томов и сетей | ||
| --dhcp | Активация DHCP-сервера с поддержкой функциональности Zero Touch Provisioning (ZTP), автоматически добавляющей устройства в систему | ||
| --database-host <HOST> | IP-адрес подключения к внешней базе данных PostgreSQL, установленной на другом хосте. Для отказоустойчивой системы с разделением на приложение и БД указывается IP-адрес master-БД. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL. | ||
| --database-port <PORT> | Порт подключения к внешней базе данных PostgreSQL, установленной на другом хосте. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL | ||
| --backup-database-host <HOST> | IP-адерс подключения к внешней бэкап-базе адрес slave-базы данных PostgreSQL, установленной на другом хосте. . Используется при запуске отказоустойчивой системы с разделением на приложение и БД. | ||
| --backup-database-port <PORT> | Порт подключения к внешней бэкапslave-базе данных PostgreSQL, установленной на другом хосте. | ||
| --help, -h | Вызов справочной информации | ||
| --https | Активация режима поддержки https. Требует наличия сертификата | ||
| --install | Установка Docker и Docker-compose на хост | ||
| --interactive, -i | Запуск системы в интерактивном режиме. Использовать с ключом --start | ||
| --load | Загрузить все доступные архивы .tar.gz из директории с образами в docker | ||
| --logging, -l <LEVEL> | Задание уровня логирования для проекта ЕССМ. Доступные значения: DEBUG, INFO | ||
| --logging-aspect | Включение логирования через аспекты сервисов. Аспект логирует все входы и выходы из методов, их параметры, а также возвращаемые значения. Не рекомендуется включать этот параметр при штатной работе системы | ||
| --peeper | Запуск системы в интеграции с мониторинговым сервисом Peeper | ||
| --pull, -p | Скачивание/обновление образов перед запуском системы | ||
| --rootlog <LEVEL> | Задание уровня логирования для всех проектов. Доступные значения: DEBUG, INFO | ||
| --save | Сохранение всех docker-образов в архивы .tar.gz | ||
| --start, -s <ADDRESS> | Запуск системы с IP-адресом, по которому будет выполняться подключение к серверу | ||
| --stop | Остановка системы | ||
| --storage <ADDRESS> | Адрес ECCM в сети управления устройствами (backbone). Используется для хранения прошивок устройств | ||
| --tracing, -t <ADDRESS> | Активация сервиса трассировок Jaeger OpenTracing. Необходимо указать IP-адрес Jaeger-сервера | ||
| --show-containers | Показать все контейнеры на сервере | ||
| --show-images | Показать все образы на сервере | ||
| --recreate-service <SERVICE> | Пересоздать контейнер с новыми параметрами
| ||
| --cluster <NODE_ROLE> | Запуск системы в режиме кластера с определенной ролью. Доступные значения: MASTER, SLAVE, WITNESS |
...