﻿# Изменение параметров ELMA365 Enterprise

> [HTML Version](change-settings-enterprise.html)

В процессе эксплуатации ELMA365 Enterprise может потребоваться изменить или перенастроить тот или иной компонент приложения. Например, нужно изменить настройки сервисов (изменить настройки почтового сервера), параметры подключения к приложению, настроить дополнительный функционал и т. д. 

Процесс изменения параметров приложения состоит из двух этапов:

1. [Внесение изменений в конфигурационный файл](#changes-config-file).

2. [Применение новых параметров для ELMA365 Enterprise](#apply-new-parameters).

## Шаг 1. Внесение изменений в конфигурационный файл values-elma365.yaml

Изменения вносятся в конфигурационный файл \[OBJECT\], заполненный при установке ELMA365 Enterprise.

````
Начало внимание

````
Перед редактированием файла \[OBJECT\] создайте его резервную копию, поскольку некорректная настройка параметров может привести к сбоям в работе приложения ELMA365 Enterprise.

````
Конец внимание

1. ````
Для скачивания актуального (latest) файла параметров выполните:

````
helm repo update  
helm show values elma365/elma365 > values-elma365-new.yaml

````
В результате выполнения команды скачается файл \[OBJECT\] с параметрами актуальной (latest) версии.

2. Чтобы скачать параметры определённой версии системы, в команду \[OBJECT\] добавьте флаг \[OBJECT\]:

````
helm repo update  
helm show values elma365/elma365 --version <elma365-chart-version> > values-elma365-new.yaml

````
Где \[OBJECT\] — нужная версия системы.

В результате выполнения команды скачается файл \[OBJECT\] с параметрами заданной версии.

3. Для считывания файла параметров, с помощью которого была произведена установка ELMA365, выполните:

````
helm \[-n namespace\] list  
helm \[-n namespace\] get values elma365 > values-elma365-installed.yaml

4. ````
Раскомментируйте и внесите правки в нужные параметры конфигурационного файла \[OBJECT\] и сохраните изменения.

## Описание параметров конфигурационного файла values-elma365.yaml

````
начало примечание

````
**Примечание**

Для паролей разрешается применять следующие символы:

- заглавные латинские буквы: от A до Z;

- строчные латинские буквы: от a до z;

- цифры от 0 до 9;

- символы:  -\_.

Зарезервированные (недопустимые) символы:

\! \* ' ( ) ; : @ \& = + \$ , / ? % # \[ \] \{ \}

````
конец примечание

### ````
Параметры платформы

| | |
|------|------|
| **Наименование** | **Описание** |
| \[OBJECT\] | Домен (FQDN) или IP-адрес, по которому будет доступна система.<br>При установке системы с указанием доменного имени необходимо в DNS-сервер внести соответствующую А-запись: \[OBJECT\]. Обратите внимание, имя домена вводится строчными буквами. <br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Устанавливаемая редакция приложения ELMA365.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включение \[OBJECT\] в ingress (значение берётся из \[OBJECT\]), если включена поддержка TLS значение автоматически выставляется \[OBJECT\].<br>**Важно**: если не включена поддержка TLS, рекомендуется ее включить. Также планируется использовать домен (FQDN) для доступа к хранилищу S3 minio, установленному в Kubernetes-кластер чартами \[OBJECT\].<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Аннотации для Ingress.<br>\[OBJECT\]. |
| `elma365.global.ingress.timeoutSeconds` | Максимальное время ожидания отправки и получения ответа от сервера в секундах для Ingress-контроллера. |
| `elma365.global.gatewayAPI.enabled` | Включает [использование Gateway API](gateway-api.md) (HTTPRoute) для публикации сервисов ELMA365 через внешний Gateway.   <br>  <br>Если параметр включён, маршрутизация трафика осуществляется через Gateway API вместо Ingress.  <br>  <br>Значение по умолчанию: `false`.<br>Доступные варианты: `true`, `false`.<br> |
| `elma365.global.gatewayAPI.parentRefs` | Ссылка на Gateway, через который будет осуществляться публикация ELMA365.  <br>  <br>Параметр должен соответствовать ранее созданному ресурсу Gateway в Kubernetes-кластере.<br>Формат:<br>````<br>\- name: <gateway-name>  <br>   namespace: <gateway-namespace><br>````<br>Где:<br>- `<gateway-name>` — имя ресурса Gateway;<br>- `<gateway-namespace>` — пространство имён, в котором создан Gateway.<br>Пример:<br>````<br>\- name: main-gateway  <br>   namespace: istio-system<br>````<br> |
| `elma365.global.gatewayAPI.envoyFilter.enabled` | Включает применение EnvoyFilter для корректной работы маршрутизации через Gateway API.<br>Значение по умолчанию: `true`.<br>Доступные варианты: `true`, `false`.<br> |
| `elma365.global.gatewayAPI.envoyFilter.namespace` | Пространство имён, в котором установлен Gateway, например, Istio Gateway.<br>Значение по умолчанию: `istio-system`.<br> |
| `elma365.global.gatewayAPI.envoyFilter.workloadSelector` | Селектор, определяющий, к каким компонентам Gateway применяется EnvoyFilter.<br>Используется для привязки настроек к контроллеру Gateway.<br>Пример: `gateway.istio.io/managed: istio.io-gateway-controller`.<br> |
| \[OBJECT\] | Переопределить версию Kubernetes. |
| \[OBJECT\] | Включение поддержки HAProxy Ingress для работы на платформе OpenShift.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает проверку подключения к БД при установке или обновлении приложения ELMA365.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| `global.nosqlUsesPostgres` | Позволяет отключить использование MongoDB при первичной установке системы, начиная с версии 2026.2. Тогда неструктурированные системные настройки, данные #ленты и чатов будут сохраняться в базе данных PostgreSQL.  <br>  <br>Значение по умолчанию: `false`. Чтобы отключить использование MongoDB, установите значение `true`.  <br>  <br>**Важно**: возможность работы без MongoDB доступна только для новых компаний и не применяется для уже существующих.<br> |


### Параметры для настройки прокси-сервера

| | |
|------|------|
| `elma365.global.proxy.enabled` | Включает использование прокси-сервера для исходящих соединений приложения. <br>Значение по умолчанию: `false`. <br>Доступные варианты: `true`, `false`.<br> |
| `elma365.global.proxy.httpsProxyCaps` | Адрес HTTPS-прокси в верхнем регистре переменной окружения (`HTTPS\_PROXY`). Используйте для работы некоторых приложений и библиотек, чувствительных к регистру. <br>Формат значения: `https://<user>:<password>@<host>:<port>/`.` `<br>Пример: `https://proxy\_user:proxy\_pass@host:port/`. <br>Значение по умолчанию не задано.<br> |
| `elma365.global.proxy.httpProxyCaps` | Адрес HTTP-прокси в верхнем регистре переменной окружения (`HTTP\_PROXY`). <br>Формат значения: `http://<user>:<password>@<host>:<port>/`.<br>Пример: `http://proxy\_user:proxy\_pass@host:port/`.<br>Значение по умолчанию не задано.<br> |
| `elma365.global.proxy.httpsProxy` | Адрес HTTPS-прокси в нижнем регистре переменной окружения (`https\_proxy`). Используйте для работы большинства Linux-приложений. <br>Формат значения: `https://<user>:<password>@<host>:<port>/`.<br>Пример: `https://proxy\_user:proxy\_pass@host:port/`.<br>Значение по умолчанию не задано.<br> |
| `elma365.global.proxy.httpProxy` | Адрес HTTP-прокси в нижнем регистре переменной окружения (`http\_proxy`). <br>Формат значения: `http://<user>:<password>@<host>:<port>/`.<br>Пример: `http://proxy\_user:proxy\_pass@host:port/`. <br>Значение по умолчанию не задано.<br> |
| `elma365.global.proxy.noProxyCaps` | Список адресов и подсетей в верхнем регистре (`NO\_PROXY`), для которых прокси не используется. Укажите их через запятую:<br>- домены — например, `example.com`;<br>- IP-адреса подсети в формате CIDR — например, `192.168.0.0/16`; <br>- служебные имена — например, `localhost`. <br>Пример: `localhost,example.com,127.0.0.0/8,cluster.local,linkerd.svc`.<br>Значение по умолчанию не задано.<br> |
| `elma365.global.proxy.noProxy` | Аналог параметра `elma365.global.proxy.noProxyCaps` в нижнем регистре переменной окружения (`no\_proxy`). Используйте для работы большинства приложений в Linux- или Unix-среде. <br>Формат и пример аналогичны параметру `noProxyCaps`. <br>Значение по умолчанию не задано.<br> |


### Параметры TLS-шифрования

| | |
|------|------|
| \[OBJECT\] | Включение поддержки TLS (Включение HTTPS).<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Наименование секрета с сертификатами для работы HTTPS.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Включение сертификата корневого CA для работы HTTPS с самоподписанным сертификатом.<br>**Важно**: перед включением необходимо установить компоненты дополнений.<br>Подробнее читайте в статье [«Включение Network Encryption (TLS) в ELMA365 Enterprise»](enable-tls-enterprise.md).<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Наименование конфигмапа с сертификатом корневого CA для работы HTTPS с самоподписанным сертификатом.<br>Значение по умолчанию: \[OBJECT\]. |


### Параметры мониторинга

| | |
|------|------|
| \[OBJECT\] | Включает поддержку мониторинга на стороне приложения ELMA365.<br>**Важно**: перед включением мониторинга сервисов необходимо установить компоненты дополнений. Подробнее читайте в статье [«Включение параметров мониторинга в ELMA365 Enterprise»](enable-monitoring-enterprise.md).<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает установку ServiceMonitor в Kubernetes-кластер для сервисов приложения ELMA365.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает предоставление значительно большего количества метрик в формате Prometheus сервисами приложения ELMA365. По умолчанию отключено, для предотвращения нарушения работы всего мониторинга слишком большим количеством метрик.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Настраивает поставляемые средства мониторинга под целевую платформу.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает установку Dashboards (ConfigMap) в Kubernetes-кластер для сервисов приложения ELMA365.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает установку PrometheusRule (CRD) в Kubernetes-кластер для сервисов приложения ELMA365.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включает отправку трейсов агенту Jaeger на указанный адрес.<br>Значение по умолчанию: \[OBJECT\] |
| \[OBJECT\] | Включает отправку трейсов напрямую в коллектор на указанный адрес. Имеет приоритет над \[OBJECT\]<br>Значение по умолчанию: \[OBJECT\] |
| \[OBJECT\] | Включает [экспорт метрик](export-monitoring-enterprise.md) \[OBJECT\], которые фиксируются в [отчёте о производительности](performance-report.md), в хранилище Prometheus для их визуализации с помощью Grafana.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| `elma365.global.monitoring.externalRmqMetrics` | Включить [использование метрики RabbitMQ](prometheus-adapter.md) для механизма автомасштабирования HPA — Horizontal pod autoscaler.<br>Доступные значения: `true`, `false`.<br> |
| `elma365.global.monitoring.rmqExporterVhost` | Укажите виртуальный хост (vhost), из которого собираются данные о накопленных сообщениях в очереди для компонента сбора метрик HPA.<br>Значение по умолчанию: `elma365`.<br> |


### Параметры для добавления меток и аннотаций в сервисы ELMA365

| | |
|------|------|
| `elma365.global.podLabels` | Метки — это внутренний инструмент навигации и группировки Kubernetes. Например, можно добавить в поды метки мониторинга, чтобы по ним находить нужные логи. <br><br>Метка представляет собой пару ключ-значение. Укажите их в этом параметре в формате: `key: value`.<br>Используйте, чтобы задать общие настройки и не дублировать их для каждого сервиса.<br> |
| `elma365.global.podAnnotations` | Аннотации — это инструмент Kubernetes для хранения вспомогательных данных, которые помогают настроить поведение внешних систем или оставить заметки.<br><br>Аннотация представляет собой пару ключ-значение. Укажите их в этом параметре в формате: `key: value`.<br>Используйте, чтобы задать общие настройки и не дублировать их для каждого сервиса.<br> |
| _Параметры для указания меток и аннотаций на уровне подов определённого сервиса ELMA365. Объединяются с глобальными параметрами. При конфликте приоритетнее глобальных._ | 
| `elma365.<service>.podLabels`,<br>где `<service>` — название сервиса.<br> | Метка представляет собой пару ключ-значение. Укажите их в этом параметре в формате: `key: value`. |
| `elma365.<service>.podAnnotations`,<br>где `<service>` — название сервиса.<br> | Аннотация представляет собой пару ключ-значение. Укажите их в этом параметре в формате: `key: value`. |


### Параметры переносимых сервисов

| | |
|------|------|
| \[OBJECT\] | Включает поддержку переносимых сервисов.  <br>Значение по умолчанию: \[OBJECT\].  <br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Наименования \[OBJECT\], где будут размещаться переносимые сервисы.  <br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Укажите систему хранения данных.  <br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Включает [использование ConfigMap](configmap.md) для настройки переносимых сервисов. Это позволяет устанавливать лимиты на распределение ресурсов, настраивать размещение подов микросервиса на узлах кластера и т. д.  <br>Значение по умолчанию: \[OBJECT\].  <br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |


### Параметры масштабирования сервисов

| | |
|------|------|
| \[OBJECT\] | Включает поддержку автомаcштабирования на стороне приложения ELMA365.<br>**Важно**: перед включением масштабирования сервисов необходимо установить компоненты дополнений. Подробнее читайте в статье [«Включение автомасштабирования сервисов в ELMA365 Enterprise»](autoscaling-service-enterprise.md).<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Выбор метода автомасштабирования.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\].<br>Где:<br>- `keda` — Kubernetes Event-driven Autoscaling;<br>- `hpa` — Horizontal Pod Autoscaler. |
| \[OBJECT\] | Настраивает минимальное количество реплик.<br>Значение по умолчанию: `1`. |
| \[OBJECT\] | Настраивает максимальное количество реплик.<br>Значение по умолчанию: `9`. |
| `elma365.global.autoscaling.rabbitmqQueueLength` | Если вы [включили использование метрики RabbitMQ](#rmqmetrics) для механизма HPA, задайте максимальное количество сообщений в очереди RabbitMQ. При превышении этого числа активируется автоматическое масштабирование подов.<br>Значение по умолчанию: `500`.<br> |


### Параметры подключения к приватному хранилищу образов контейнеров

| | |
|------|------|
| \[OBJECT\] | Строка подключения к приватному registry.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — IP или доменное имя приватного registry;<br>- \[OBJECT\] — порт для подключения;<br>- \[OBJECT\] — путь до каталога.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Наименование секрета с правами доступа к приватному registry (должен быть создан вручную, зашифрован в Base64).<br>Значение по умолчанию: \[OBJECT\]. |


### Дополнительные параметры в блоке Global

| | |
|------|------|
| **Наименование** | **Описание** |
| \[OBJECT\] | Максимальное количество подключений к главному узлу PostgreSQL в пуле незанятых подключений.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное количество открытых подключений к главному узлу PostgreSQL из пула.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное время жизни подключения к главному узлу PostgreSQL из пула.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное количество подключений к репликам PostgreSQL в пуле незанятых подключений.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное количество открытых подключений к репликам PostgreSQL из пула.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное время жизни подключения к репликам PostgreSQL из пула.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальный размер ответов.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальная задержка между попытками установки GRPC соединения.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Количество секунд, которое отводится всему Job на выполнение.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Количество попыток миграции при обновлении ELMA365.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Максимальное время ожидания для завершения обработки скрипта сервисом **worker**. |
| \[OBJECT\] | Время ожидания для завершения обработки скрипта по умолчанию. Параметр применится, если превышено время ожидания, заданное в \[OBJECT\]. |
| \[OBJECT\] | Позволяет установить лимит на кеширование схем исполнения серверных скриптов в сервисе **worker**.  |
| \[OBJECT\] | Позволяет установить допустимый объём загружаемых в систему файлов. |




### Параметры подключения к базам данных, SMTP и других настроек

| | |
|------|------|
| **Параметры отладки платформы** | 
| \[OBJECT\] | Включает режим отладки платформы. Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |




| | |
|------|------|
| **Параметры компании** | 
| \[OBJECT\] | Указывается электронный адрес. Электронный адрес будет являться логином для входа главного администратора.<br>**Важно**: используется при создании компании в момент установки ELMA365, изменение \[OBJECT\] делает невозможным применении новых параметров или обновление ELMA365.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Пароль для входа главного администратора. Используйте [допустимые символы](#permitted-symbols).<br>**Важно**: применяется при создании компании в момент установки ELMA365.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Язык интерфейса компании.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\]. |




| | |
|------|------|
| **Параметры языка платформы** | 
| \[OBJECT\] | Язык установленной платформы. Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\]. |




| | |
|------|------|
| **Параметры подключения к базам данных** | 
| \[OBJECT\] | Строка подключения к PostgreSQL для операций записи и чтения.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя PostgreSQL имеющего права на базу данных databaseName<br>- \[OBJECT\] — пароль для пользователя PostgreSQL. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера PostgreSQL;<br>- \[OBJECT\] — порт для подключения к PostgreSQL, стандартный порт: 5432;<br>- \[OBJECT\] — наименование базы данных;<br>- \[OBJECT\] — использование защищённого соединения. |
| \[OBJECT\] | Включает возможность использовать внешние секреты для подключения к БД (\[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\]).<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Наименование секрета с подключением к PostgreSQL для операций чтения (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к PostgreSQL для операций чтения.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя PostgreSQL имеющего права на базу данных databaseName<br>- \[OBJECT\] — пароль для пользователя PostgreSQL. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера PostgreSQL;<br>- \[OBJECT\] — порт для подключения к PostgreSQL, стандартный порт: 5432;<br>- \[OBJECT\] — наименование базы данных;<br>- \[OBJECT\] — использование защищённого соединения. |
| \[OBJECT\] | Наименование секрета с подключением к PostgreSQL для операций чтения (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к MongoDB.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя MongoDB имеющего права на базу данных databaseName;<br>- \[OBJECT\] — пароль для пользователя MongoDB. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера MongoDB;<br>- \[OBJECT\] — порт для подключения к MongoDB, стандартный порт 27017;<br>- \[OBJECT\] — наименование базы данных;<br>- \[OBJECT\] — использование защищённого соединения;<br>- \[OBJECT\] — номер набора реплик;<br>- \[OBJECT\] — предпочтительный режим чтения. |
| \[OBJECT\] | Наименование секрета с подключением к MongoDB (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к MongoDB для сервера авторизации.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя MongoDB имеющего права на базу данных databaseName;<br>- \[OBJECT\] — пароль для пользователя MongoDB. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера MongoDB;<br>- \[OBJECT\] — порт для подключения к MongoDB, стандартный порт 27017;<br>- \[OBJECT\] — наименование базы данных;<br>- \[OBJECT\] — использование защищённого соединения;<br>- \[OBJECT\] — номер набора реплик;<br>- \[OBJECT\] — предпочтительный режим чтения. |
| \[OBJECT\] | Наименование секрета с подключением к MongoDB для сервера авторизации (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к Valkey.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя Valkey имеющего права на базу данных \[OBJECT\];<br>- \[OBJECT\] — пароль для пользователя Valkey. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера Valkey;<br>- \[OBJECT\] — порт для подключения к Valkey, стандартный порт 6379;<br>- \[OBJECT\] — наименование базы данных.<br>Если у вас настроена СУБД Redis, используйте эту же строку в указанном выше формате. |
| \[OBJECT\] | Наименование секрета с подключением к Valkey (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>Если у вас настроена СУБД Redis, используйте этот же ключ.<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к RabbitMQ.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — имя пользователя RabbitMQ имеющего права на vhost;<br>- \[OBJECT\] — пароль для пользователя RabbitMQ. Используйте [допустимые символы](#permitted-symbols);<br>- \[OBJECT\] — IP или доменное имя сервера RabbitMQ;<br>- \[OBJECT\] — порт для подключения к RabbitMQ, стандартный порт 5672;<br>- \[OBJECT\] — наименование базы данных. |
| \[OBJECT\] | Наименование секрета с подключением к RabbitMQ (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключ \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметр \[OBJECT\]. |




| | |
|------|------|
| **Параметры подключение к S3-хранилищу файлов** | 
| \[OBJECT\] | Метод загрузки файлов в S3.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Логин пользователя для подключения к серверу S3. |
| \[OBJECT\] | Пароль пользователя для подключения к серверу S3. Используйте [допустимые символы](#permitted-symbols). |
| \[OBJECT\] | Наименование бакета в S3.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Строка подключения к S3.<br>Формат: \[OBJECT\].<br>Где:<br>- \[OBJECT\] — IP или доменное имя сервера S3;<br>- \[OBJECT\] — порт для подключения к S3, стандартный порт S3 9000.<br>Если порт не задан:<br>- \[OBJECT\] — выбирается порт 80;<br>- \[OBJECT\] — выбирается порт 443. |
| \[OBJECT\] | Регион расположения сервера S3. |
| \[OBJECT\] | Использование TLS шифрования сервером S3.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Включение режима Virtual-hosted style для S3. В этом режиме имя бакета является частью имени домена в URL‑адресе, например: \[OBJECT\].<br>Если параметр отключен, используется модель адресации Path‑style.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\]. |
| \[OBJECT\] | Адрес сервера S3 для резервного копирования скриптом \[OBJECT\].<br>Формат: <br>- для S3 в Kubernetes-кластере — \[OBJECT\]; <br>- для внешнего S3 — \[OBJECT\].  |
| \[OBJECT\] | Наименование секрета с подключением к S3 хранилищу (должен быть создан вручную, зашифрован в Base64).<br>Должен содержать ключи \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\], \[OBJECT\].<br>**Важно**: включение \[OBJECT\] отключает параметры:<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\];<br>- \[OBJECT\].<br>Значение по умолчанию: \[OBJECT\]. |




| | |
|------|------|
| **Параметры подключения к SMTP-серверу**<br>_Это соединение используется для отправки приглашений новым пользователям, восстановления паролей, отправки уведомлений о новых задачах_ | 
| \[OBJECT\] | IP или URL‑адрес для подключения к SMTP‑серверу.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Порт для подключения к SMTP-серверу.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Email-адрес (наименование почтового ящика), от имени которого происходит отправка сообщений.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Логин пользователя для подключения к SMTP‑серверу.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Пароль пользователя для подключения к SMTP‑серверу. Используйте [допустимые символы](#permitted-symbols).<br>Значение по умолчанию: \[OBJECT\].<br>Отключается при активации параметра \[OBJECT\]. |
| \[OBJECT\] | Определяет применение TLS‑шифрования SMTP‑сервером.<br>Значение по умолчанию: \[OBJECT\].<br>Доступные варианты: \[OBJECT\], \[OBJECT\].<br>  <br>Начиная с версии 2025.10.12 для настройки способа TLS‑шифрования SMTP‑сервером используйте параметр `elma365.mailer.smtp.tls`. Для параметра  `elma365.mailer.smtp.needTLS` оставьте значение `false`. |
| \[OBJECT\] | Параметр доступен начиная с версии 2025.10.12. Определяет способ TLS‑шифрования SMTP‑сервером.<br>Установите один из вариантов:<br>- `notls` — для незащищённого соединения;<br>- `tls` — для соединения с шифрованием TLS;<br>- `starttls` — для соединения с шифрованием STARTTLS.<br> |
| \[OBJECT\] | Наименование секрета с паролем для авторизации на SMTP‑сервере. <br>Секрет создаётся вручную и шифруется в Base64. Должен содержать ключ \[OBJECT\].<br>  <br>**Важно**: активация \[OBJECT\] отключает параметр \[OBJECT\]. |




| | |
|------|------|
| **Параметры управления настройками двухфакторной аутентификации при входе в систему и на внешний портал** | 
| \[OBJECT\] | Максимальное количество попыток ввода кода подтверждения. При превышении лимита пользователь запрашивает код повторно.<br>Значение по умолчанию: \[OBJECT\] |
| \[OBJECT\] | Длина цифрового кода подтверждения, который получает пользователь.<br>Значение по умолчанию: \[OBJECT\] |
| \[OBJECT\] | Срок действия кода в минутах. <br>Значение по умолчанию: \[OBJECT\] |




| | |
|------|------|
| **Параметры исполнения серверных скриптов** | 
| \[OBJECT\] | Задаёт ограничение в МБ для памяти, используемой одним форком исполнения внутри одной реплики сервиса worker.<br>Если значение параметра не задано или равно **0**, работа сервиса worker остаётся без изменений. |




| | |
|------|------|
| **Настройка периодического перезапуска экземпляров бизнес-процессов** | 
| \[OBJECT\] | Параметр определяет интервал между циклами перезапуска активных экземпляров бизнес-процессов с неполадками, например, с продолжительным выполнением автоматического действия — скрипта, запроса в сторонний сервис и т. д.<br>Значение по умолчанию: \[OBJECT\]. |
| \[OBJECT\] | Продолжительность одного цикла в минутах, в течение которого перезапускаются накопившиеся в очереди активные экземпляры бизнес‑процессов с неполадками. <br>Значение по умолчанию: \[OBJECT\].<br>Если все экземпляры не успели перезапуститься, оставшиеся — обрабатываются в следующем цикле. Чтобы экземпляры не накапливались в очереди на перезапуск, вы можете увеличить продолжительность цикла или уменьшить интервал между циклами в предыдущем параметре. |




| | |
|------|------|
| **Параметр для максимального размера вложений в письмах** | 
| \[OBJECT\] | Позволяет установить максимальный размер вложений в [отправляемых письмах](send-email.md#attachment). Это значение не должно превышать лимит, заданный в параметре \[OBJECT\]. Перед внесением изменений предусмотрите на вашем сервере свободное дисковое пространство для хранения возросших объёмов данных. |




| | |
|------|------|
| **Параметры параллельной обработки переменных/функций** | 
| \[OBJECT\] | Настраивается после включения фича-флага \[OBJECT\] и задаёт количество параллельных экземпляров worker внутри сервиса для обработки переменных.<br>Удобно, если при генерации шаблона документа используется много [пользовательских переменных](360027003711.md).<br>Значение по умолчанию 5. |




| | |
|------|------|
| **Включение фича-флагов** | 
| \[OBJECT\] | Чтобы включить фича-флаг, введите его наименование с новой строки, поставив тире и пробел перед наименованием. Все включённые фича-флаги представлены в разделе в виде списка.  |


### Необязательные переменные окружения

В файле `values-elma365.yaml` вы можете управлять некоторыми функциональными возможностями приложения ELMA365, например, адресом сервиса Jaeger для отправки трассировки, сроком действия ссылок на загрузку объектов в S3 и т. д. 

Для этого используются переменные окружения, которые задаются в параметрах:

- `elma365.global.extraEnv` — чтобы настройки переменных применялись для всех сервисов системы;

- `elma365.<service>.extraEnv` — чтобы настройки переменных применялись для определённого сервиса. Вместо `<service> `указывается имя сервиса.

Если переменная окружения задана глобально и в блоке определённого сервиса, то используется значение из `elma365.<service>.extraEnv`.

Пример настройки параметра ELMA365\_JAEGER\_ENDPOINT

1. Глобальный параметр:

````
global:  
  extraEnv:  
    ELMA365\_JAEGER\_ENDPOINT: "jaeger.monitoring.svc"

2. ````
Параметр сервиса **worker**:

````
worker:  
  extraEnv:  
    ELMA365\_JAEGER\_ENDPOINT: "jaeger.loadtest.svc"

````
Если для сервиса вы не задали индивидуальное значение переменной `ELMA365\_JAEGER\_ENDPOINT`, то используется глобальное значение, и трассировка отправляется в пространство имён **monitoring**. Для сервиса **worker** задано значение `jaeger.loadtest.svc`, поэтому его трассировка направляется в пространство имён **loadtest**.

Список доступных переменных окружения, которые можно настраивать с помощью параметра `extraEnv`, смотрите в таблице ниже.



| | |
|------|------|
| **Наименование** | **Описание** |
| `ELMA365\_JAEGER\_ENDPOINT` | Адрес (endpoint) сервиса Jaeger, в который отправляются данные трассировки. |
| `UPLOAD\_LINK\_DURATION` | Срок действия технических API-ссылок на загрузку объектов в S3. Используются микросервисами для передачи файлов в хранилище.<br>Значение по умолчанию: `120m`.<br>Значение можно указать в минутах или часах.<br> |
| `DOWNLOAD\_LINK\_DURATION` | Срок действия технических API-ссылок на скачивание объектов из S3. Используются микросервисами для получения файлов из хранилища.<br>Значение по умолчанию: `480m`. <br>Значение можно указать в минутах или часах.   <br>  <br>Изменение стандартного срока действия S3-ссылок может потребоваться, если вы работаете с файлами через интеграции с внешними сервисами. Новое значение устанавливается, чтобы загрузка или скачивание файлов выполнились до того, как ссылка устареет.<br> |
| **Параметры обновления шрифтов** | 
| `ELMA365\_ASPOSEACTIONS\_FONT\_UPDATE\_ENABLE` | Включите загрузку и обновление шрифтов. <br> |
| Значение задаётся следующим образом:<br>````<br>global:  <br>  extraEnv:  <br>    ELMA365\_ASPOSEACTIONS\_FONT\_UPDATE\_ENABLE: "true"<br>```` | 
| ````<br>`ELMA365\_ASPOSEACTIONS\_FONT\_UPDATE\_PERIOD\_IN\_MINUTES` | Задайте периодичность обновления шрифтов, значение по умолчанию — `30m`.<br> |
| Значение задаётся следующим образом:<br>````<br>global:  <br>  extraEnv:  <br>    ELMA365\_ASPOSEACTIONS\_FONT\_UPDATE\_PERIOD\_IN\_MINUTES: 30m<br>```` | 

## ````
Шаг 2. Применение новых параметров для ELMA365 Enterprise

Вы можете обновить параметры для ELMA365 Enterprise двумя способами: через интернет или [без доступа к сети](#offline-update).

### Обновление параметров через интернет

1. Определите версию чарта, с помощью которого было установлено или обновлено приложение ELMA365:

````
helm list \[-n namespace\]

````
Пример выполнения команды:

(change-settings-enterprise-1.png)

В результате выполнения команды информация о версии чарта будет указана в \[OBJECT\]. Сохраните это значение для выполнения следующего шага.

2. Обновите параметры приложения ELMA365 с применением конфигурационного файла \[OBJECT\]. Для этого используйте следующую команду, указав в ней для флага \[OBJECT\] установленную версию чарта вместо \[OBJECT\]:

````
helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --version <elma365-chart-version> --timeout=30m --wait \[-n namespace\]

### ````
Обновление параметров без доступа в интернет

Перейдите в каталог с чартом, с помощью которого было установлено или обновлено приложение ELMA365 и выполните команду:

````
helm upgrade --install elma365 ./elma365 -f values-elma365.yaml --timeout=30m --wait \[-n namespace\]

````
Обновление параметров занимает 10–30 минут. Дождитесь его завершения.