Установка узла развёртывания
Подключение установочного диска
Цель — загрузиться с образа undercloud.iso.
При старте сервера запустится псевдографическая установка операционной системы.
Если используется установка с флешки, то вставьте флешку в сервер и подключитесь к экрану физического сервера через консольный порт или подключённый дисплей.
Если используется установка через BMC, то подключитесь к виртуальной консоли BMC. Примонтируйте образ через виртуальную консоль BMC. В BIOS/UEFI укажите загрузку с виртуального CD/DVD.
Если используется установка в виртуальной машине, то создайте на используемом хосте ВМ (см. Установка узла развёртывания в виртуальной машине (Centos 7,8)) и подключитесь к виртуальной консоли виртуализации. Инсталлятор андерклауда не пробрасывается в серийную консоль, поэтому используйте для подключения virt-manager:
убедитесь, что на вашей локальной машине установлен X-сервер: в линуксах с любой графической оболочкой он есть по умолчанию, для Windows используйте VcXsrv, для MacOS — XQuartz;
подключитесь к хосту виртуализации по SSH с параметром -X для проброса X11;
запустите virt-manager и откройте консоль виртуальной машины.
Результат: запускается псевдографический установщик.
Установка операционной системы
Цель — установить ОС на сервер.
Подключитесь к консоли: через BMC или напрямую к серверу.
Выберите диск для установки.
Примечание
Минимум 100 ГБ, лучше SSD. Рабочий сценарий — 150 ГБ (см. Требования к оборудованию и ПО).
Выбор диска
Все данные на диске будут удалены. Подтвердите действие.
Подтверждение удаления
Дождитесь проверки образа
undercloud.raw. Это может занять несколько минут.
Результат: установленная ОС на узле развёртывания.
Первичная настройка узла
Цель — задать сеть управления и запустить настройку сервисов узла управления.
Залогиньтесь в систему под пользователем stack с паролем по умолчанию (обратитесь в поддержку для получения пароля).
Настройка доступа к узлу развёртывания
Цель — настроить SSH-доступ к узлу развёртывания для удобства работы.
Добавьте интерфейс из сети External:
sudo nmcli con add type vlan con-name VLAN<номер External Vlan> dev <имя интерфейса External> id <номер External Vlan> ip4 <IP адрес/маска External>
sudo ip route add default via <шлюз External>
Пример:
sudo nmcli con add type vlan con-name VLAN373 dev eno2 id 373 ip4 10.198.73.100/24
sudo ip route add default via 10.198.73.1
- Где:
10.198.73.100— незанятый IP в сети External, адрес undercloud373— VLAN ID сети External,10.198.73.1— шлюз из таблицы сетевой конфигурации (столбец Шлюз для сети External).
Теперь можно подключиться по SSH:
ssh stack@<IP адрес undercloud>
Пример:
ssh stack@10.198.73.100
Используйте один из способов для настройки узла развёртывания:
через графический инсталлятор (рекомендуемый способ);
через клиент командной строки.
Графический инсталлятор
Далее запустите инсталлятор для настройки узла:
$ undercloud-firstboot
┌───────────────────────────────────────── Undercloud Firstboot ─────────────────────────────────────────┐
│Primary network interface [ ]│
│Ctlplane CIDR 192.168.24.0/24 █
│Undercloud local IP 192.168.24.1 ░
│Gateway 192.168.24.1 ░
│Ctlplane DHCP start IP 192.168.24.35 ░
│Ctlplane DHCP end IP 192.168.24.235 ░
│Introspection DHCP start IP 192.168.24.16 ░
│Introspection DHCP end IP 192.168.24.34 ░
│Undercloud Nameservers ░
│Undercloud NTP Servers ░
│────────────────────────────────────────────────────────────────────────────────────────────────────────░
│Advanced settings ░
│────────────────────────────────────────────────────────────────────────────────────────────────────────░
│Undercloud Hostname undercloud.localdomain ░
│Overcloud Domain Name novalocal ░
│Undercloud Timezone Etc/GMT-3 ░
│Container Images File /var/lib/undercloud_firstboot/containers-prepare-parameter.yaml ░
│Container Insecure Registries undercloud.ctlplane:8787 ░
│Custom Environment Files /var/lib/undercloud_firstboot/undercloud-environment.yaml ░
│ ░
│ < Save/Ctrl+U > < Start/Ctrl+A > < Quit/Ctrl+X > │
└────────────────────────────────────────────────────────────────────────────────────────────────────────┘
В поле Primary network interface укажите интерфейс из столбца Интерфейс для сети Ctlplane (например,
eno1).
Примечание
Интерфейс не должен использоваться для доступа к узлу развёртывания!
В поле Ctlplane CIDR оставьте значение по умолчанию
192.168.24.0/24, если в вашей таблице сетевой конфигурации не указано иное. Если значение отличается — укажите его вручную, остальные параметры сети укажите по аналогии.
Примечание
После установки изменить сеть Ctlplane будет крайне сложно. Убедитесь, что параметры согласованы до развёртывания.
Примечание
Важно: В сети Ctlplane не должно быть другого DHCP-сервера — undercloud запускает свой.
Nameservers и NTP Servers укажите существующие из общих сетевых параметров, иначе оставьте поля пустыми.
Nameservers: x.x.x.x, y.y.y.y (укажите через запятую)
NTP Servers: ntp1.example.ru, ntp2.example.ru (укажите через запятую)
Дополнительные параметры (меняйте только при необходимости, по умолчанию развёртывание с этими параметрами):
Undercloud Hostname — имя хоста undercloud (по умолчанию
undercloud.novalocal).Overcloud Domain Name — домен для узлов облака (по умолчанию
novalocal).Undercloud Timezone — часовой пояс.
Container Images File, Container Insecure Registries, Custom Environment Files — расширенные настройки контейнеров и окружения.
После введения всех настроек перейдите к установке, нажав кнопку Start или комбинацию клавиш Ctrl+A.
Дождитесь установки облачной системы на узел развёртывания.
Ваш узел развёртывания готов! Основной пользователь — stack.
Клиент командной строки
Альтернативно, для настройки узла развёртывания через командную строку используйте флаг --non-interactive:
usage: undercloud-firstboot [-h] [--log-path LOG_PATH] [--non-interactive]
[--undercloud-conf UNDERCLOUD_CONF]
[--local-interface LOCAL_INTERFACE]
[--cidr CIDR] [--local-ip LOCAL_IP]
[--gateway GATEWAY] [--dhcp-start DHCP_START]
[--dhcp-end DHCP_END]
[--inspection-iprange INSPECTION_IPRANGE]
[--undercloud-nameservers UNDERCLOUD_NAMESERVERS]
[--undercloud-ntp-servers UNDERCLOUD_NTP_SERVERS]
[--undercloud-hostname UNDERCLOUD_HOSTNAME]
options:
-h, --help show this help message and exit
--log-path LOG_PATH Set up logging path (Default:
/var/log/undercloud.log)
--non-interactive Non-interactive mode. (Default: False)
--undercloud-conf UNDERCLOUD_CONF
Undercloud configuration file path (Default:
/var/lib/undercloud_firstboot/undercloud.conf)
--local-interface LOCAL_INTERFACE
Primary network interface
--cidr CIDR CIDR for the ctlplane subnet. (Default:
192.168.24.0/24)
--local-ip LOCAL_IP Undercloud local IP (Default: 192.168.24.1/24)
--gateway GATEWAY Gateway (Default: 192.168.24.1)
--dhcp-start DHCP_START
Ctlplane DHCP start IP (Default: 192.168.24.35)
--dhcp-end DHCP_END Ctlplane DHCP end IP (Default: 192.168.24.235)
--inspection-iprange INSPECTION_IPRANGE
Introspection DHCP IP range (Default:
192.168.24.16,192.168.24.34)
--undercloud-nameservers UNDERCLOUD_NAMESERVERS
Undercloud Admin IP (Default: )
--undercloud-ntp-servers UNDERCLOUD_NTP_SERVERS
Undercloud Admin IP (Default: )
--undercloud-hostname UNDERCLOUD_HOSTNAME
Undercloud Hostname (Default: undercloud.novalocal)
Обратите внимание, что локальный адрес узла развёртывания в этом случае указывается с маской подсети, а адреса для пула адресов интроспекции - через запятую.
Пример использования команды:
$ undercloud-firstboot --non-interactive --local-interface eth0 \
--undercloud-nameservers 8.8.8.8
Или пример со сменой сети администрирования:
$ undercloud-firstboot --non-interactive --local-interface eth0 \
--cidr 192.168.25.0/24 \
--local-ip 192.168.25.10/24 --gateway 192.168.25.1 \
--dhcp-start 192.168.25.135 --dhcp-end 192.168.25.140 \
--inspection-iprange 192.168.25.141,192.168.25.145
Дождитесь установки облачной системы на базе OpenStack на узел развёртывания.
Ваш узел развёртывания готов! Основной пользователь - stack.
Примечание
Следующий шаг: Настройка узлов и хранилищ
Устранение ошибок
Ошибка ntp
2025-10-27 08:15:41.669337 | 002590bb-0ebf-e9da-4309-00000000b7e8 | IGNORED | Ensure system is NTP time synced | undercloud | error={"changed": true, "cmd": ["chronyc", "waitsync", "30"], "delta": "0:04:50.304777", "end": "2025-10-27 08:15:41.637736", "msg": "non-zero return code", "rc": 1, "start": "2025-10-27 08:10:51.332959", "stderr": "", "stderr_lines": [], "stdout": "try: 1, refid: 7F7F0101, correction: 0.000000000, skew: 0.000\ntry: 2, refid: 7F7F0101, correction: 0.000000000, skew: 0.000\ntry: 3, refid: 7F7F0101, correction: 0.000000000, skew:
...
e9da-4309-00000000b7e8 | TIMING | chrony : Ensure system is NTP time synced | undercloud | 0:07:09.072453 | 290.53s
INTERACTIVE MODE
Такая ошибка возникает, когда ntp сервер не может выполнить синхронизацию. Если ntp сервер не был указан, то это нормально и нужно ввести c (означает Continue) и нажать ENTER, установка продолжится