Cloudbase-init

Общие сведения

Cloudbase-init - утилита для настройки виртуальной машины под управлением ОС Windows.

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

Дополнительная информация

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

Рекомендуется использовать источник NoCloud.

Пример использования в SpaceVM

Для использования cloudbase-init необходимо:

1. На ВМ под управлением ОС семейства Windows установить утилиту cloudbase-init.

2. Убедиться в успешной установке.

3. После установки cloudbase-init необходимо перейти в директорию C:\Program Files\Cloudbase Solutions\Cloudbase-Init\conf, где находятся конфигурационные файлы cloudbase-init.conf и cloudbase-init-unattend.conf.

4. Перейти к конфигурации файла cloudbase-init.conf и добавить строки:

   metadata_services=cloudbaseinit.metadata.services.nocloudservice.NoCloudConfigDriveService
   plugins=cloudbaseinit.plugins.common.userdata.UserDataPlugin
   

5. Найти параметры, отвечающие за поиск источника конфигурационного диска, и привести к виду:

   config_drive_raw_hhd=false
   config_drive_cdrom=true
   config_drive_vfat=false
   

   Настройка может отличаться в зависимости от версии утилиты.

6. Сохранить файл cloudbase-init.conf.

7. Перейти к конфигурационному файлу cloudbase-init-unattend.conf и добавить строки:

   metadata_services=cloudbaseinit.metadata.services.nocloudservice.NoCloudConfigDriveService
   plugins=cloudbaseinit.plugins.common.userdata.UserDataPlugin
   

8. Найти параметры, отвечающие за поиск источника конфигурационного диска, и привести к виду:

   config_drive_raw_hhd=false
   config_drive_cdrom=true
   config_drive_vfat=false
   

   Настройка может отличаться в зависимости от версии утилиты.

9. Сохранить файл cloudbase-init-unattend.conf.

10. Открыть командную строку от имени администратора и выполнить:

    sysprep /oobe /generalize /shutdown
    

    На стадии подготовки виртуальной машины при помощи утилиты Sysprep рекомендуется передать файл ответов через ключ /unattend:Unattend.xml для пропуска интерактивного выбора параметров ОС при запуске ВМ из шаблона. В противном случае при запуске ВМ в гостевой ОС будет происходить остановка для интерактивного выбора параметров.

    Файл ответов Unattend.xml, полученный после установки cloudbase-init, находится в директории с конфигурационными файлами. Для запуска приведенной команды необходимо Unattend.xml поместить в ту же директорию, из которой в командной строке запускается Sysprep.

    Например, если Sysprep запускается из директории C:\Windows\System32\Sysprep, то файл Unattend.xml должен находиться в данной директории.

11. Перейти к управлению ВМ и перевести ее в режим шаблона. Для этого необходимо перейти в раздел ВМ/Шаблон и нажать В режим шаблона.

12. Создать конфигурационный диск. Подробная информация доступна на сайте NoCloud configuration drive.

13. Создать новую папку и два файла в ней: meta-data и user-data.

14. Сконфигурировать файлы согласно документации производителя.

15. Выполнить команду для создания ISO с названием cidata, например:

    genisoimage -output seed.iso -volid cidata -joliet -rock user-data meta-data
    

    Необходимо использовать собственные названия.

16. После выполнения всех шагов будет получен ISO-образ.

17. Перейти в раздел Виртуальные машины и создать ВМ из шаблона, для этого нажать кнопку Добавить ВМ из шаблона.

18. Загрузить стандартным способом полученный ISO-образ и примонтировать к ВМ.

19. Включить питание ВМ и убедиться, что cloudbase-init готов к работе.

    В процессе включения допускается несколько перезагрузок системы. Необходимо дождаться полного завершения процесса.

Демонстрация работы cloudbase-init

В файл user-data добавить строки:

#cloud-config
set_hostname: cloudbase
users:
  -
    name: test
    gecos: 'test user'
write_files:
   content: 'test text'
   path: C:\test.txt

Пример файла user-data использует YAML структуру и имеет 4 основных раздела:

• #cloud-config - все файлы user-data должны начинаться с этой строки.

• set_hostname - имя хоста, которое будет присвоено.

• users - данные пользователя, который будет создан.

• write_files - блок для создания тестового файла.

В результате конфигурации user-data будет получено: