Файлы конфигурации

Файлы конфигурации позволяют настраивать работу модулей.

Конфигурационные файлы описывают авторизационные данные для подключения к службам (OpenStack, DB, RabbitMQ и др.), а также параметры работы модулей.

Файлы имеют формат .conf.

При установке модулей создаются образцы файлов конфигурации с расширением conf.example. Файлы содержат минимальный набор секций, необходимых для работы модулей. После внесения изменений в файл conf.example, в целях сохранения образца настроек следует сохранить их под другим именем.

Ключи в файлах конфигурации являются регистронезависимыми. Также не зависят от регистра значения булевых параметров (TRUE/FALSE) и уровни логирования, остальные параметры, включая названия секций, чувствительны к регистру.

Виды файлов конфигурации

Конфигурационные файлы продуктов AccentOS® делятся на два типа:

Начало работы всегда осуществляется с использования общего файла конфигурации, только затем считываются настройки с модульного файла. Файлы могут содержать одинаковые секции и параметры, при разных параметрах используются настройки модульного файла конфигурации. В случае отсутствия файлов конфигурации будут использоваться параметры по умолчанию из файлов conf.example.

Расположение файла конфигурации

При установке любого из модулей устанавливаются оба вида конфигурационных файлов: модульный и общий, с расширением .conf.example в директорию /etc/aos/.

Общий файл конфигурации

Данный вид файла конфигурации используется всеми модулями, что позволяет настроить сразу все модули в одном файле. Общий файл aos.conf находится в директории /etc/aos/. В файле aos.conf.example перечислены секции и их опции. Если в описании параметров не указано иное, значения параметров чувствительны к регистру.

Общий файл конфигурации появляется после установки одного из модулей: Dashboard, Journal, Monitor, CloudManager, RSserver, Scheduler.

Изменение параметров файла конфигурации описано в соответствующем разделе документации.

Содержание файла конфигурации

Файл конфигурации состоит из следующих секций:

Секция Описание
DEFAULT Секция по умолчанию для параметров, не включенных в другие секции.
keystone Настройки аутентификации в службе Keystone.
database Настройки подключения к базе данных.
messaging Настройки службы обмена сообщениями.
os_api Настройки точек доступа к сервисам OpenStack.
api_auth Настройки аутентификации служб AccentOS.

Секция DEFAULT

Состоит из следующих опций:

Опция Описание По умолчанию
log_level Указывает установленный уровень логирования. Подробное описание уровней доступно в разделе «Уровни логирования». info
log_rotation_type Указаывает установленный тип ротации логов. Подробное описание ротации доступно в разделе «Ротация логов». size
max_logfile_size_mb При установленном типе ротации size, указывает максимальный размер файлов логирования в MB. 512
max_logfile_count Максимальное количество файлов логирования после ротации. 10
log_rotate_interval_type При установленном типе ротации interval, указывает тип интервала ротации. Допустимые значения: Seconds, Minutes, Hours, Days, Weekday, Midnight. Day
log_rotate_interval При установленном типе ротации interval, указывает интервал ротации. 1

Секция keystone

Состоит из следующих опций:

Опция Описание По умолчанию
auth_url URL авторизации в службе Keystone. http://localhost:5000
username Имя пользователя. admin
password Пароль пользователя.  
project_name Название проекта OpenStack. admin
user_domain_name Название домена пользователя. default
project_domain_name Название домена проекта. default

Секция database

Состоит из следующих опций:

Опция Описание По умолчанию Возможные значения
max_pool_size Максимальное количество открытых подключений в пуле. 5 Любые неотрицательные числа, при значении 0 - количество подключений не ограничено.
max_overflow Число соединений, на которое можно превысить max_pool_size. 50 Любые неотрицательные числа, при значении -1 - количество соединений не ограничено.
pool_recycle Таймаут превышения соединения (в секундах) - интервал времени, по истечении которого открытое соединение удаляется из пула. 3600 Любые неотрицательные числа, при значении -1 - соединения не удаляются.
pool_timeout Максимальный интервал времени ожидания получения соединения из пула (в секундах). 30 Любые неотрицательные числа.
retry_interval Время ожидания между попытками соединения (в секундах). 2 Любые неотрицательные числа.
max_retries Максимальное количество попыток подключения. 5 Любые неотрицательные числа, при значении 0 - не осуществляются попытки переподключиться, при -1 - попытки подключения осуществляются бесконечно

Секция messaging

Состоит из следующих опций:

Опция Описание По умолчанию
url URL подключения к службе обмена сообщениями. amqp://aos:password@localhost:5672/aos

Секция redis

Состоит из следующих опций:

Опция Описание По умолчанию
url URL подключения к NoSQL базе данных Redis. redis://:password@localhost:6379/0

Секция os_api

Состоит из следующих опций:

Опция Описание По умолчанию
nova_api_version Версия API службы Nova. 2.60
cinder_api_version Версия API службы Cinder. 3.50
gnocchi_api_version Версия API службы Gnocchi. 1
glance_api_version Версия API службы Glance. 2
neutron_api_version Версия API службы Neutron. 2
compute_service_type Тип службы Nova. compute
image_service_type Тип службы Glance. image
network_service_type Тип службы Neutron. network
volume_service_type Тип службы Cinder. volumev3
gnocchi_service_type Тип службы Gnocchi. metric

Секция api_auth

Опция Описание По умолчанию
auth_url URL авторизации в службе Keystone.  
username Имя пользователя. aos
password Пароль пользователя.  
project_name Название проекта OpenStack. service
user_domain_name Название домена пользователя. default
project_domain_name Название домена проекта. default

Изменение параметров файла конфигурации

Важно

Сначала необходимо произвести настройку окружения. Все команды выполняются только от суперпользователя.

Скопируйте образец конфигурационного файла:

cp /etc/aos/aos.conf.example /etc/aos/aos.conf

После выполнения команды вы можете редактировать файл, его можно найти в директории /etc/aos/.

Для того, чтобы изменения в файле конфигурации вступили в силу, необходимо перезапустить веб-сервер и systemd службы модулей:

# Debian:
systemctl restart apache2
systemctl restart aos-*

Модульный файл конфигурации

Данный вид файлов используется конкретным модулем. Файл конфигурации находится в директории /etc/aos/. Название файла соответствует названию модуля.

Подробные описания конфигурационных файлов доступны в соответствующих разделах документации о модулях:

Примечание

В случае, если в конфигурационном файле модуля не указаны путь и имена файлов для сбора логов, то логирование действий производится средствами системы, например, journalctl.