Настройка¶
Извлекаемые переменные¶
Перечень переменных с их методами извлечения доступны в приложении:
Пример переменной:
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 - директория с пакетами и их зависимостями.