Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Информация

Ниже приведена инструкция по выполнению однохостовой установки.

Инструкция по установке с резервированием системы приведена в статье v0.8_ru_3.6 Резервирование.

Установка Ansible

Для запуска плейбуков необходимо установить Ansible на хост, с которого есть доступ по SSH до целевого хоста.

...

Рекомендуемая ОС хоста для запуска плейбука - Ubuntu 2224.04 Jammy и новее.

Минимальная версия Ansible для корректной работы плейбуков установки 2.10.816.3.

Предупреждение

Для корректной установки на ОС Astra Linux 1.7.5 / 1.7.6 требуется версия Ansible не выше 2.16.3.

Официальная документация по установке Ansible.

...

Раскрыть
titleПриложение A. Значение переменных окружения из .env - развернуть

Условные обозначения:

  • (предупреждение) - не рекомендуется к редактированию.
ПеременнаяЗначение по умолчаниюОписание

Переменные для дистрибуции (предупреждение)

BACKEND_VERSION_TAG

0.8Версия сервисов бэкенда (naice-gavia, naice-lemmus, naice-ovis, naice-ursus).

FRONTEND_VERSION_TAG

0.8Версия сервиса фронтенда (naice-web, известный как larus).
POSTGRES_VERSION_TAG0.8.4Версия контейнерезированного образа БД postgres.
RADIUS_VERSION_TAG0.8Версия контейнерезированного образа FreeRadius.
NATS_VERSION_TAG0.7.1Версия контейнерезированного образа NATS.
ELTEX_HUBhub.eltex-co.ru/naiceВнешний репозиторий со стабильными версиями сборок ПО.

BACKEND_HUB

ELTEX_HUBПеременная, хранящая текущий выбранный репозиторий для загрузки сервисов бэкенда.

FRONTEND_HUB

ELTEX_HUBПеременная, хранящая текущий выбранный репозиторий для загрузки сервиса фронтенда.
RADIUS_HUBELTEX_HUBПеременная, хранящая текущий выбранный репозиторий для загрузки контейнера с FreeRADIUS.
CI_HUBhub.eltex-co.ruВнешний репозиторий для сборок сопутствующих продуктов (PostgreSQL).
HOSTNAMEБерется значение имени хоста из /etc/hostname при установке плейбуком ansibleИмя хоста, на котором развернута система NAICE. Необходимо для лицензирования. Менять его после активации лицензии запрещено.

Переменные Gavia

GAVIA_PORT8080Порт, на котором работает сервис внутри контейнера. (предупреждение)
GAVIA_HOST_PORT8080Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.

Переменные Ursus

URSUS_PORT

8081Порт, на котором работает сервис внутри контейнера. (предупреждение)

URSUS_HOST_PORT

8081Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.

URSUS_GRPC_PORT

8082Порт, на котором работает GRPC для сервиса внутри контейнера. (предупреждение)

URSUS_GRPC_HOST_PORT

8082Порт, в который пробрасывается порт GRPC для сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.

URSUS_POSTGRES_USERNAME

ursusПользователь для доступа сервиса в СУБД PostgreSQL.

URSUS_POSTGRES_PASSWORD

ursusПароль пользователя для доступа сервиса в СУБД PostgreSQL.
URSUS_POSTGRES_DBursusНаименование БД, используемой сервисом.

URSUS_POSTGRES_JDBC_URL

jdbc:postgresql://{{ ansible_host }}:5432/ursusURL для взаимодействия с БД с помощью JDBC.
URSUS_GRPC_ADMIN_SERVICE_ADDRESSdns:/naice-ursus:8082Адрес GRPC-сервера сервиса naice-ursus. По этому адресу происходит взаимодействие naice-gavia и naice-ursus.
URSUS_OUI_UPDATE_TIME_S86400Периодичность обновления списка MAC OUI, с.
URSUS_OUI_UPDATETrueВключить/выключить обновление списка MAC OUI.
URSUS_OUI_UPLOAD_FILE_URLhttps://standards-oui.ieee.org/oui/oui.csvАдрес списка MAC OUI, который используется для обновления.
URSUS_DEFAULTEVENTS_EVENTCLEAN_LOG_LOCALEruЯзык журнала событий, может принимать значения ru, en.

Переменные Lemmus

CRON0 0 3 * * *Настройка интервала очистки таблицы событий в БД, по умолчанию раз в сутки в 3 часа.
URSUS_EVENTS_TO_DELETE_DAYS14Количество дней, в течении которых события храняться в БД.
URSUS_DEFAULT_EVENT_LOG_LOCALEruЯзык журнала событий, может принимать значения ru, en.

Переменные Lemmus

LEMMUS_PORT8083Порт, LEMMUS_PORT8083Порт, на котором работает сервис внутри контейнера. (предупреждение)
LEMMUS_HOST_PORT8083Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
LEMMUS_POSTGRES_USERNAMEursusПользователь для доступа сервиса в СУБД PostgreSQL.
LEMMUS_POSTGRES_PASSWORDursusПароль пользователя для доступа сервиса в СУБД PostgreSQL.
LEMMUS_ISSUER_URLhttps://{{ ansible_host }}:8083URL для запроса токена другими сервисами.
LEMMUS_REDIRECTShttps://{{ ansible_host }}:8080/actuator/health, https://{{ ansible_host }}:443/loginURL для перенаправления клиента после получения токена.
LEMMUS_ACCESS_TTL_S3600Время жизни токена в секундах.
LEMMUS_REFRESH_TTL_S7200Время в секундах, в течение которого токен можно продлить.

Переменные PostgreSQL

POSTGRES_USERpostgresПользователь, создаваемый при установке и настройке СУБД.
POSTGRES_PASSWORDpostgresПароль пользователя, создаваемый при установке и настройке СУБД.

Переменные Ovis

OVIS_PORT8084Порт, на котором работает сервис внутри контейнера. (предупреждение)
OVIS_HOST_PORT8084Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
OVIS_GRPC_PORT8085Порт, на котором работает GRPC для сервиса внутри контейнера. (предупреждение)
OVIS_GRPC_HOST_PORT8085Порт, в который пробрасывается порт GRPC для сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
OVIS_GRPC_SERVICE_ADDRESSdns:/naice-ovis:${OVIS_GRPC_PORT}Адрес, на который выполняется запрос о состоянии сервиса.
OVIS_CACHE_TTL_S86400

Время жизни кэша naice-ovis в секундах, в течение которого он хранит настройки аутентификации и авторизации. По истечении этого времени настройки перечитываются.

OVIS_SESSION_IDLE_S86400Время жизни неактивных сессии пользователей, с.
OVIS_POSTGRES_JDBC_URLjdbc:postgresql://{{ ansible_host }}:5432/ursusАдрес подключения к БД.
OVIS_POSTGRES_USERNAMEovisЛогин подключения к БД.
OVIS_POSTGRES_PASSWORDovisПароль подключения к БД.
OVIS_LDAP_ENABLE_CACHEtrueВключить кэширование атрибутов пользователя при обращении к внешнему источнику идентификации по протоколу LDAP.
OVIS_LDAP_CACHE_TTL_S10Время хранения в кэше информации об атрибутах пользователя, с.
OVIS_LDAP_CONNECT_TIMEOUT_MS3000Таймаут подключения к внешнему источнику идентификации по протоколу LDAP, мс.
OVIS_LDAP_READ_TIMEOUT_MS7000Таймаут чтения данных из внешнего источника идентификации по протоколу LDAP, мс.
OVIS_LDAP_REFERRAL_VALUEignore

Возможность перехода по реферальным ссылкам полученным от LDAP. 

Возможные значения: ignore - не следовать, follow - следовать.

OVIS_LDAP_POOL_SIZE10Размер пула коннектов к внешнему источнику идентификации типа LDAP.
OVIS_LDAP_POOL_MAX_SIZE10Максимально допустимое количество коннектов к внешнему источнику идентификаций типа LDAP.
OVIS_NODE_INTERFACE{{ ansible_host }}IP-адрес/DNS-имя интерфейса для взаимодействие с соседним инстансом при работе в схеме с резервированием.
OVIS_NODE_MEMBERS127.0.0.1IP-адреса/DNS-имена инстансов участвующих в резервировании.
OVIS_NODE_PORT5701Порт для взаимодействия с соседним инстансов при работе в схеме с резервирвоанием.
OVIS_NETLOGON_LIB_SOCKET_TIMEOUT_MS5000Таймаут обмена данными с внешним источником идентификации (типа Active Directory) по протоколу netlogon, мс.
OVIS_NETLOGON_LIB_CONNECT_TIMEOUT_MS5000Таймаут подключения к внешнему источнику идентификации (типа Active Directory) по протоколу netlogon, мс.
OVIS_NETLOGON_LIB_CLIENT_CACHE_ENABLEDtrueВключить кэширование сессии компьютера  при обращении к внешнему источнику идентификации (типа Active Directory) по протоколу netlogon, мс.
OVIS_NETLOGON_LIB_CLIENT_CACHE_TTL_S1800Время хранения в кэше сессии компьютера, с.
OVIS_NETLOGON_LIB_CLIENT_CACHE_PERIOD_S180Интервал проверки наличия в кэше сессии компьютера, с.
OVIS_NETLOGON_LIB_DNS_CACHE_TTL_S3600Время хранения в кэше информации о контроллерах домена после выполнения DNS-запроса типа SRV, с.
OVIS_NETLOGON_LIB_DNS_CACHE_PERIOD_S360Интервал проверки наличия в кэше информации о контроллерах домена после выполнения DNS-запроса типа SRV, с.

Переменные Larus (WEB)

LARUS_PORT4200Порт, на котором работает сервис внутри контейнера. (предупреждение)
LARUS_HOST_PORT80Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
FRONTEND_API_URLhttps://{{ ansible_host }}:8080/api/v1URL для взаимодействия с сервисом naice-gavia.
FRONTEND_AUTHORIZATION_URLhttps://{{ ansible_host }}:8083URL для редиректа на страницу авторизации.
FRONTEND_WEB_URLhttps://{{ ansible_host }}:443URL на котором работает WEB-интерфейс.

Переменные NATS

NATS_PORT4222Порт, на котором работает сервис. (предупреждение)
NATS_MONITORING_PORT8222Порт, через который выполняется мониторинг сервиса.
NATS_EXPORTER_PORT7777Порт, через который сервис отдает метрики в формате prometheus.
NATS_ADDRESSnats://naice-nats:${NATS_PORT}Адрес, на котором работает сервис.
NATS_PROMETHEUS_EXPORTER_ARGS"-connz -varz -channelz -serverz -subz"Аргументы командной строки, которые используется при формировании метрик prometheus. (предупреждение)

NATS_CLUSTER_PORT

6222Порт для взаимодействия nats в кластере.

Переменные Vulpus

VULPUS_PORT8086Порт, на котором работает сервис внутри контейнера. (предупреждение)
VULPUS_HOST_PORT8086Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
VULPUS_GRPC_PORT8088Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия по gRpc.
VULPUS_POSTGRES_USERNAMEvulpusЛогин для подключения к БД.
VULPUS_POSTGRES_PASSWORDvulpusПароль для подключения к БД.
VULPUS_POSTGRES_JDBC_URLjdbc:postgresql://{{ ansible_host }}:5432/lepusАдрес БД для подключения.
VULPUS_GRPC_SERVICE_ADDRESSdns:/naice-vulpus:${VULPUS_GRPC_PORT}Порт, на котором внутри контейнера работает gRpc-сервер.

Переменные Lepus

LEPUS_PORT8087Порт, на котором работает сервис внутри контейнера. (предупреждение)
LEPUS_HOST_PORT8087Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
LEPUS_REPOSITORY_BATCH_SIZE500Размер пакета сохранения проб в БД (количество).
LEPUS_POSTGRES_USERNAMElepusЛогин для подключения к БД.
LEPUS_POSTGRES_PASSWORDlepusПароль для подключения к БД.
LEPUS_POSTGRES_JDBC_URLjdbc:postgresql://{{ ansible_host }}:5432/lepusАдрес БД для подключения.
LEPUS_DHCP_PROBE_ENABLEDtrueВключение/отключение сбора DHCP-проб.
LEPUS_DHCP_PROBE_PORT1024Внутренний порт в контейнере для сбора DHCP-проб. В него пробрасывается порт сервиса из контейнера на хостовую машину.
LEPUS_DHCP_PROBE_HOST_PORT67Внешний порт сервиса для сбора DHCP-проб.
LEPUS_DHCP_PROBE_SCHEDULE_CLEAR_PROBES_AFTER_DAYS30Время хранения DHCP-проб в БД.
LEPUS_DHCP_PROBE_SCHEDULE_CLEAN_EXPIRED_CRON0 0 * * * *Расписание для запуска задачи по очистке устаревших DHCP-проб в БД.

Переменные Gulo

GULO_PORT8089Порт, на котором работает сервис внутри контейнера. (предупреждение)
GULO_HOST_PORT8089Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
GULO_GRPC_PORT8090Порт, на котором работает GRPC для сервиса внутри контейнера. (предупреждение)
GULO_GRPC_HOST_PORT8090Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
GULO_GRPC_SERVICE_ADDRESSdns:/naice-gulo:${GULO_GRPC_PORT}Адрес, на который выполняется запрос о состоянии сервиса.
GULO_ELM_SERVER_URLhttps://elm.eltex-co.ru:8099URL до сервера ELM.
GULO_ELM_PROXY_HOST
Адрес HTTP-proxy сервера
GULO_ELM_PROXY_PORT
Порт HTTP-proxy сервера
GULO_ELM_PROXY_LOGIN
Логин для аутентификации на HTTP-proxy сервере
GULO_ELM_PROXY_PASSWORD
Пароль для аутентификации на HTTP-proxy сервере
GULO_EPG_URLhttps://epg-service:8100Адрес сервиса EPG

Переменные Aquila

AQUILA_PORT8091Порт, на котором работает сервис внутри контейнера. (предупреждение)
AQUILA_HOST_PORT8091Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.
AQUILA_TACACS_PORT49Порт для обработки входящих запросов по протоколу TACACS+.
AQUILA_GRPC_PORT8092Порт, на котором работает GRPC сервиса.
AQUILA_GRPC_SERVICE_ADDRESSdns:/naice-aquila:${AQUILA_GRPC_PORT}Адрес, на котором работает GRPC сервиса.
AQUILA_CACHE_TTL_S300Время жизни кэша naice-ovis в секундах, в течение которого он хранит настройки аутентификации и авторизации. По истечении этого времени настройки перечитываются.
AQUILA_POSTGRES_JDBC_URLjdbc:postgresql://{{ ansible_host }}:5432/aquilaАдрес БД для подключения.
AQUILA_POSTGRES_USERNAMEaquilaЛогин для подключения к БД.
AQUILA_POSTGRES_PASSWORDaquilaПароль для подключения к БД.
AQUILA_POSTGRES_DBaquilaИмя БД для подключения
AQUILA_DB_POOL_SIZE25Количество коннектов для подключения к БД.
AQUILA_DB_POOL_MIN_IDLE5Минимальное количество коннектов для подлючения БД в режиме ожидания.
AQUILA_DB_POOL_IDLE_TIMEOUT60000Время ожидания ответа при подключении к БД, мс.
AQUILA_DB_POOL_CONNECTION_LIFETIME1800000Время жизни соединения к БД, с.
AQUILA_FLUSH_SEC60

Интервал сохранения сессий и аккаунтинга в БД, с.

AQUILA_SESSIONS_CLEAN_CRON0 0 * * * *Интервал очистки сессий и аккаунтинга из БД, по умолчанию каждый час.
AQUILA_SESSION_TO_DELETE_DAYS31Срок хранения информации о сессиях в БД.
AQUILA_ACCOUNTING_TO_DELETE_DAYS31Срок хранения информации об аккаунтинге в БД.

Переменные EPG

EPG_TAG

1.0-1 

Версия сервиса EPG
EPG_LOG_FILE_MAX_SIZE

10

Максимальный размер одного log файла в МБ
EPG_LOG_FILE_MAX_COUNT

4

Максимальное количество log файлов в ротации
EPG_KERNEL_LOG_LEVEL

info

Уровень логирования для логов типа "kernel" сервиса EPG
EPG_DEBUG_LOG_LEVEL

off

Уровень логирования для логов типа "debug" сервиса EPG
EPG_NETWORKING_LOG_LEVEL

info

Уровень логирования для логов типа "networking" сервиса EPG
EPG_HOST_PORT

8100

Порт, в который пробрасывается порт сервиса из контейнера на хостовую машину. Используется для взаимодействия с сервисом.

Переменные для настройки сертификата для HTTPS

SSL_CERT/etc/docker-naice/https/server.crtПуть до файла сертификата.
SSL_CERT_KEY/etc/docker-naice/https/server.keyПуть до файла закрытого ключа сертификата.
SSL_CERT_PASS
Пароль от закрытого ключа; по умолчанию  без пароля.

Переменные RADIUS

Общие переменные
RADIUS_AUTH_PORT1812Порт аутентификации для обработки RADIUS-запросов аутентификации. (предупреждение)
RADIUS_ACCT_PORT1813Порт для обработки RADIUS-аккаунтинга. (предупреждение)
RADIUS_EXPORTER_PORT9812Порт, через который сервис отдает метрики в формате prometheus.
RADIUS_LOG_PATH/var/log/radiusФайл на хостовой машине для хранения логов работы сервиса.
RADIUS_REST_OVIS_IP{{ ansible_host }}IP-адрес для подключения к сервису NAICE-Ovis. (предупреждение)
RADIUS_REST_OVIS_PORT8084Порт для подключения к сервису NAICE-Ovis.
RADIUS_POSTGRES_DB_HOST{{ ansible_host }}IP-адрес подключения к БД.
RADIUS_POSTGRES_DB_PORT5432Порт подключения к БД.
RADIUS_POSTGRES_DB_LOGINradiusЛогин для подключения к БД.
RADIUS_POSTGRES_DB_PASSWORDradiusПароль для подключения к БД.
RADIUS_POSTGRES_DB_NAMEursusНаименование БД для подключения. (предупреждение)
Переменные для настройки авторизации по протоколу EAP-PEAP
RADIUS_CERTS_CA_CERT_FILEtrusted_server.crtНаименование файла внешнего сертификата CA.
RADIUS_CERTS_PRIVATE_KEY_FILEtrusted_server.kНаименование внешнего приватного ключа сертификата.
RADIUS_CERTS_PRIVATE_KEY_PASSWORDне заданоПароль к файлу приватного ключа сертификата сервера; оставьте пустым, если файл приватного ключа не запаролен.
RADIUS_CERTS_CERTIFICATE_FILEtrusted_server_chain.crtНаименование файла внешнего сертификата, который будет использовать FreeRADIUS.
Переменные для настройки авторизации по протоколу EAP-TLS
RADIUS_EAP_TLS_CERTS_CA_CERT_FILEtrusted_server.crtНаименование файла внешнего сертификата CA.
RADIUS_EAP_TLS_CERTS_PRIVATE_KEY_FILEtrusted_server.kИмя файла приватного ключа сертификата сервера.
RADIUS_EAP_TLS_CERTS_PRIVATE_KEY_PASSWORDне заданоПароль к файлу приватного ключа сертификата сервера; оставьте пустым, если файл приватного ключа не запаролен.
RADIUS_EAP_TLS_CERTS_CERTIFICATE_FILEtrusted_server_chain.crtНаименование файла внешнего сертификата, который будет использовать FreeRADIUS.
Переменные для работы с сервисом проверки статуса отозванных сертификатов (OCSP)
RADIUS_EAP_TLS_OCSP_ENABLEfalseВключение проверки статуса отзыва сертификата по протоколу OCSP.
RADIUS_EAP_TLS_OCSP_OVERRIDE_URLfalseИспользование URL сервиса OCSP из сертификата.
RADIUS_EAP_TLS_OCSP_URLhttp://127.0.0.1/ocspURL для обращения к сервису OCSP.
RADIUS_EAP_TLS_OCSP_SOFTFAILfalse"Мягкая" проверка доступа к серверу проверки OSCP - если сервер недоступен, процесс не завершится, а продолжится.
RADIUS_EAP_TLS_OCSP_TIMEOUT0Таймаут обращения к серверу OSCP.
RADIUS_EAP_TLS_OCSP_USE_NONCEtrueВключение одноразового кода в запрос - nonce, который может быть включен в соответствующий ответ.

Переменные уровня логирования сервисов

ROOT_LOGGING_LEVELDEBUGКорневой уровень логирования. Логи сервисов выше данного уровня не отображаются.
URSUS_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Ursus.
GAVIA_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Gavia.
LEMMUS_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Lemmus.
OVIS_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Ovis.
LEPUS_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Lepus.
VULPUS_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Vulpus.
GULO_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Gulo.
AQUILA_LOGGING_LEVELDEBUGУровень логирования сервиса NAICE-Aquila.

...