Файлы конфигурации
Файлы конфигурации позволяют настраивать работу модулей.
Конфигурационные файлы описывают авторизационные данные для подключения к службам (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.