Настройка

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

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

variables.txt

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

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

где:

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

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

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

Пример:

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

DB_SUPERUSER_PASSWORD="123456"
CLOUD_MANAGER_DB_SUPERUSER_PASSWORD="cloud_pass"

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

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

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

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

  1. Через переменные окружения операционной системы;
  2. Считывание существующих файлов конфигурации модулей (будет произведено при указании аргумента утилиты --overwrite-configs);
  3. Передача параметров в аргументы скрипта autosetup;
  4. Через аргумент скрипта 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 - директория с пакетами и их зависимостями.