Файлы конфигурации¶
Файлы конфигурации позволяют настраивать работу модулей.
Конфигурационные файлы описывают авторизационные данные для подключения к службам (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/. Название файла соответствует названию модуля.
Подробные описания конфигурационных файлов доступны в соответствующих разделах документации о модулях:
- Agent;
- AppLevel;
- CloudManager;
- Clouds;
- Dashboard;
- FirstBoot;
- Journal;
- Monitor;
- OTPsender;
- Scheduler;
- RSserver;
- RemoteApp.
Примечание
В случае, если в конфигурационном файле модуля не указаны путь и имена файлов для сбора логов, то логирование действий производится средствами системы, например, journalctl.