Настройка

Извлекаемые переменные 

Перечень переменных с их методами извлечения доступны в приложении:

variables.txt

Пример переменной:

AUTH_URL
Variable default value: http://localhost:5000
Variable extraction sequence: OS_AUTH_URL

где:

AUTH_URL - внутреннее название переменной;
http://localhost:5000 - значение по умолчанию для переменной, если ни в одном из методов извлечения не нашлась переменная по последовательности извлечения;
OS_AUTH_URL - это название переменной, из которой будет извлекаться значение для указанной внутренней переменной.

Переменные модулей 

Для того, чтобы задавать параметры конкретному модулю, используйте соответствующий префикс. Префиксы модулей:

Dashboard - DASH;
Monitor - MONITOR;
CloudManager - CLOUD_MANAGER;
Scheduler - SCHEDULER;
Journal - JOURNAL;
RSserver - RS.

Пример:

Допустим, имеются следующие переменные в глобальном окружении:

DB_SUPERUSER_PASSWORD="123456"
CLOUD_MANAGER_DB_SUPERUSER_PASSWORD="cloud_pass"

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

В этом случае для всех модулей, кроме CloudManager, пароль доступа к базе данных будет - 123456, а для модуля CloudManager пароль будет - cloud_pass.

Методы извлечения 

Управление настройками продуктов осуществляется следующими способами:

Через переменные окружения операционной системы;
Считывание существующих файлов конфигурации модулей (будет произведено при указании аргумента утилиты --overwrite-configs);
Передача параметров в аргументы скрипта autosetup;
Через аргумент скрипта autosetup (параметр config_file), указав конфигурационный файл.

Порядок методов определяет извлечение переменной.

Каждый следующий перебивает значение извлеченное ранее, этим обеспечивается приоритет извлечения.

Настройка автоматической установки 

Системные аргументы, передаваемые утилите 

Аргументы управления поведением утилиты 

Наименование	Описание	Значение по умолчанию
`--config-file`	Файл конфигурации, содержащий параметры переменных. Описание использования представлено в подразделе «Использование конфигурационного файла».
`--generate-config-file`	Запуск опросника для формирования файла конфигурации с необходимыми для работы автоустановки переменными. Критичные переменные выделены красным цветом.
`--all-variables`	Запуск опросника в режиме запроса подтверждения значения для всех переменных. Если аргумент не указан, будут запрашиваться значения только для необходимых переменных.
`--packages`	Перечень устанавливаемых пакетов, по умолчанию все доступные. Названия модулей указываются через пробел, например: aos-autosetup --packages cloudmanager dashboard Доступные пакеты: dashboard monitor cloudmanager scheduler journal rs_server
`--no-check-connection`	Пропуск проверки доступности используемых по указанным параметрам сервисов, необходимых для работы модулей.
`--cloud-domain-policy`	При указании данного аргумента будет произведено конфигурирование OpenStack и модулей для работы функций управления доменами. При использовании с параметром `--delete` настройки будут отменены. Подробная информация доступна по ссылке.
`--update`	Обновление установленных пакетов.	`False`
`--delete`	Удаление установленных пакетов и добавление постфикса `.d` в названиях конфигурационных файлов.	`False`
`--rollback`	При указании данного аргумента будет произведён откат окружения pip.	`False`
`--file-path`	При использовании с аргументом `--rollback` задаёт путь до файла, содержащего версии пакетов, до которых нужно произвести откат окружения pip.
`--force`	При использовании с параметром `--delete` позволяет, игнорируя ошибки подключения к сервисам, удалить дополнительно: все созданное в базе данных, конфигурационные файлы, установленные лицензии, каталог логов, пользователя RabbitMQ, виртуальные хосты RabbitMQ.
`--verbose`	Включение подробного вывода. При указании данного аргумента будет установлен уровень логирования `DEBUG`. Подробное описание доступно в разделе Уровни логирования.
`--overwrite-configs`	При указании данного аргумента будет произведено обновление существующих конфигурационных файлов.
`--incompatible-pkg`	При указании данного атрибута пользователю не будет предлагаться ввести подтверждение при отличных версиях устанавливаемых пакетов.
`--package-version`	Версия устанавливаемых пакетов. Игнорируется при использовании аргументов `--update` и `--delete`. Примеры возможных значений: `1.12.1.dev2` - Установка версии `1.12.1.dev2`; `1.12.1` - Установка последней доступной в рамках версии `1.12.1`; `1.12` - Установка последнего доступного патча для версии `1.12`, например `1.12.2`; `last` - Установка последней доступной версии.
`--source`	Способ установки пакетов. Возможные значения: `pip`; `apt-get`.	`pip`
`--use-ldap`	При указании данного аргумента при установке и обновлении модулей стандартный драйвер LDAP, используемый в Keystone, будет заменен в конфигурационных файлах доменов на обновленный драйвер. При использовании этого аргумента при полном удалении модулей драйвер будет возвращен на стандартный.
`--lic`	Путь до файла лицензии. Может быть указан как путь до файла на диске, так и URL.
`--theme-name`	Название темы для установки. Если тема не указана, будут установлены все темы. Возможные значения: `Dashboard`; `Ocean`.

Аргументы, определяющие параметры устанавливаемых модулей 

Наименование	Описание	Значение по умолчанию
`--system-username`	Имя пользователя.	`aos`
`--log-level`	Переменная для уровня логирования.	`INFO`
`--os-auth-url`	Адрес для авторизации службы Keystone, значение параметра извлекается в переменную `AUTH_URL`.	`http://localhost:5000`
`--os-username`	Имя пользователя службы Keystone, значение параметра извлекается в переменную `AUTH_USERNAME`.	`admin`
`--os-password`	Пароль пользователя службы Keystone, значение параметра извлекается в переменную `AUTH_PASSWORD` и `SERVICE_PASSWORD`, также может извлекаться в переменные `DB_USER_PASSWORD`, `DB_SUPERUSER_PASSWORD` и, тем самым, служить паролем пользователя к базе данных.
`--os-project-name`, `--OS_TENANT_NAME`	Наименование проекта OpenStack, значение параметра извлекается в переменную `PROJECT_NAME`.	`admin`
`--os-project-domain-name`	Доменное имя проекта OpenStack, значение параметра извлекается в переменную `PROJECT_DOMAIN_NAME`.	`default`
`--os-user-domain-name`	Доменное имя пользователя OpenStack, значение параметра извлекается в переменную `USER_DOMAIN_NAME`.	`default`
`--compute-service-name`	Тип службы Nova.	`compute`
`--volume-service-name`	Тип службы Cinder.	`volumev3`
`--gnocchi-service-name`	Тип службы Gnocchi.	`metric`
`--network-service-name`	Тип службы Neutron.	`network`
`--os-volume-api-version`	Версия REST API службы Cinder, значение параметра извлекается в переменную `VOLUME_API_VERSION`.	`3.50`
`--os-network-api-version`	Версия REST API службы Neutron, значение параметра извлекается в переменную `NETWORK_API_VERSION`.	`2`
`--db-superuser-name`	Суперпользователь базы данных.	`root`
`--db-username`	Пользователь базы данных.	`aos`
`--db-engine`	Тип базы данных.	`mysql+pymysql`
`--db-host`	Хост, на котором расположена база данных.	`controller`
`--db-port`	Порт подключения к базе данных.	`3306`
`--broker-type`	Тип брокера службы RabbitMQ.	AMQP
`--rabbit-host`	Хост, на котором расположена служба RabbitMQ.	`controller`
`--rabbit-port`	Порт для подключения к службе RabbitMQ.	`5672`
`--rabbit-username`	Имя пользователя RabbitMQ.	`aos`
`--rabbit-password`	Пароль пользователя RabbitMQ.	`password`
`--rabbit-virthost`	Виртуальный хост RabbitMQ.	`aos`
`--db-superuser-password`	Пароль к базе данных, значение параметра извлекается в переменную `DB_SUPERUSER_PASSWORD`.
`--db-user-password`	Пароль к базе данных, значение параметра извлекается в переменную `DB_USER_PASSWORD`.
`--db-allowed-hosts`	Список хостов, с которых разрешено подключение к базе данных.	`%` - доступ разрешен для всех хостов. Наименования хостов указываются через запятую.
`--pypi-host`	Адрес сервера pypi, используемый для установки пакетов.	Значение берется в зависимости от установленной версии OpenStack.
`--pip-args`	Дополнительные аргументы pip, необходимые при установке или обновлении модулей.
`--pkg-version`	Версия устанавливаемых пакетов.
`--source`	Способ установки пакетов (pip, apt-get, yum).	`pip`
`--admin-domain-id`	Идентификатор домена пользователя с правами администратора.
`--domain-user`	Пользователь домена с правами администратора .	`admin`
`--memcache-location`	URL адрес для доступа к системе кэширования.	`localhost:11211`
`--nova-rabbit-vhost`	Виртуальный хост RabbitMQ службы Nova.	`/`
`--keystone-rabbit-vhost`	Виртуальный хост RabbitMQ службы Keystone.	`/`
`--sentry-enabled`	Параметр, отвечающий за логирование ошибок в Sentry.	`False`
`--sentry-dsn`	Адрес сервера Sentry, содержит ключ пользователя и идентификатор проекта.	Уникальна для каждого модуля.
`--sentry-log-level`	Уровень логирования Sentry.	`CRITICAL`
`--service-user`	Имя сервисного пользователя.	`aos`
`--service-password`	Пароль сервисного пользователя.
`--service-project`	Наименование проекта OpenStack сервисного пользователя.	`service`
`--service-user-domain-name`	Доменное имя пользователя OpenStack сервисного пользователя.	`default`
`--service-project-domain-name`	Доменное имя проекта OpenStack сервисного пользователя.	`default`
`--service-host`	Хост, на котором расположена служба модуля	`localhost`
`--redis-host`	Хост, на котором расположена служба Redis.	`localhost`
`--redis-port`	Порт для подключения к службе Redis.	`6379`
`--redis-password`	Пароль для подключения к службе Redis.	`password`
`--journal-db-name`	Имя базы данных модуля Journal.	`journal`
`--journal-service-name`	Имя службы модуля Journal.	`journal`
`--journal-service-port`	Порт службы модуля Journal.	`9360`
`--journal-service-host`	Хост службы модуля Journal.	localhost
`--dash-db-name`	Имя базы данных модуля Dashboard.	`dashboard`
`--monitor-db-name`	Имя базы данных модуля Monitor.	`monitor`
`--monitor-service-name`	Имя службы модуля Monitor.	`monitor`
`--monitor-service-port`	Порт службы модуля Monitor.	`9363`
`--monitor-service-host`	Хост службы модуля Monitor.	`localhost`
`--monitor-zabbix-host-group`	Имя группы хостов, в которой по умолчанию будет осуществляться поиск шаблонов в Zabbix.	`aos`
`--monitor-zabbix-host`	Путь к сервису Zabbix.	`localhost`
`--monitor-zabbix-password`	Пароль пользователя с правами администратора в Zabbix.	`zabbix`
`--monitor-zabbix-username`	Имя пользователя с правами администратора в Zabbix.	`Admin`
`--cloud-manager-db-name`	Имя базы данных модуля CloudManager.	`cloud_manager`
`--cloud-manager-service-name`	Имя службы модуля CloudManager.	`cloud-manager`
`--cloud-manager-service-port`	Порт службы модуля CloudManager.	`9362`
`--cloud-manager-service-host`	Хост службы модуля CloudManager.	`localhost`
`--scheduler-db-name`	Имя базы данных модуля Scheduler.	`scheduler`
`--scheduler-service-name`	Имя службы модуля Scheduler.	`scheduler`
`--scheduler-service-port`	Порт службы модуля Scheduler.	`10001`
`--scheduler-service-host`	Хост службы модуля Scheduler.	`localhost`
`--rs-db-name`	Имя базы данных модуля RSserver.	`rs_server`
`--rs-service-name`	Имя службы модуля RSserver.	`rs-server`
`--rs-service-port`	Порт службы модуля RSserver.	`9364`
`--rs-service-host`	Хост службы модуля RSserver.	`localhost`
`--rs-memcache-location`	URL адрес для доступа к системе кэширования.	`localhost:11211`

Извлекаются по имени из системных переменных окружения. Используются только те, которые есть в перечне извлекаемых переменных. Если не указана переменная окружения LC_ALL, то она создается, значение для нее используется из переменной LANG.

Настройка автоматической установки при помощи скрипта 

Использование консольной утилиты модуля 

Переменные можно указать в параметрах скрипта, передавая их в следующем виде:

aos-autosetup --os-auth-url "http://controller:5000" --os-username root
aos-autosetup --help - выводит список по порядку всех доступных аргументов

Использование конфигурационного файла 

Указывается через параметр скрипта config-file:

aos-autosetup --config-file ~/adm

Пример конфигурационного файла:

export OS_AUTH_URL="http://controller:5000"
export OS_USERNAME=root

Также имеется возможность инициализировать переменные, используя существующие конфигурационные файлы модулей. Для этого необходимо указать аргумент --overwrite-configs:

aos-autosetup --overwrite-configs

Использование консольной утилиты и аргументы pip 

Указываются через параметр скрипта pip-args.

Пример:

aos-autosetup --pip-args="--no-deps"
aos-autosetup --pip-args="--pre --no-deps"

Установка модулей без доступа к сети интернет:

aos-autosetup --pip-args="--no-index --find-links ./packages"

где packages - директория с пакетами и их зависимостями.