Настройка¶
Извлекаемые переменные¶
Перечень переменных с их методами извлечения доступны в приложении:
Пример переменной:
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 |
Версия устанавливаемых пакетов. Игнорируется при использовании аргументов
|
|
--source |
Способ установки пакетов. Возможные значения:
|
pip |
--use-ldap |
При указании данного аргумента при установке и обновлении модулей стандартный драйвер LDAP, используемый в Keystone, будет заменен в конфигурационных файлах доменов на обновленный драйвер. При использовании этого аргумента при полном удалении модулей драйвер будет возвращен на стандартный. | |
--lic |
Путь до файла лицензии. Может быть указан как путь до файла на диске, так и URL. | |
--theme-name |
Название темы для установки. Если тема не указана, будут установлены все темы. Возможные значения:
|
Аргументы, определяющие параметры устанавливаемых модулей¶
Наименование | Описание | Значение по умолчанию |
---|---|---|
--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
- директория с пакетами и их зависимостями.