Создание собственного шаблона

Шаблоны в DCImanager 6 — это наборы образов диска и скриптов установки, которые хранятся на локации. DCImanager 6 использует шаблоны для установки операционных систем (ОС), проведения диагностики и восстановления серверов.

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

Создание копии шаблона

Чтобы создать копию шаблона, перейдите в Шаблоны → Шаблоны ОС и операций → выберите шаблон → меню → Копировать:

Введите Название шаблона.
Выберите кому разрешён Доступ к шаблону:
- Всем;
- Только администраторам.
Выберите требуется ли шаблону Поддержка EFI.
Укажите произвольные Теги для шаблона.
Укажите Имя и Значение макроса. Нажмите Добавить макрос, если нужно добавить больше макросов. Подробнее о макросах см. Макросы шаблонов.
Скопируйте путь к директории, в которой будет сохранена копия шаблона.
Нажмите Копировать.

Пример настроек

Настройка параметров шаблона

Шаблоны ОС хранятся на сервере локации в директории /opt/ispsystem/dci/os_templates/имя_шаблона. Шаблон состоит из файла metainfo.xml и набора файлов для установки. В metainfo.xml описаны параметры, которые будут использованы при установке. Некоторые из этих параметров используются макросами шаблонов.

Формат файла metainfo.xml

Параметры в файле metainfo.xml указываются в формате <название_параметра>значение_параметра</название_параметра>. Например, <sshpublickey>yes</sshpublickey>. Все пути в параметрах указываются относительно директории с шаблоном.

Основные параметры:

<kernel> — название файла с образом ядра Linux;
<initrd> — название файла с образом Initrd;
<kernelcommand> — параметры загрузки ядра. В параметре можно использовать макросы. Подробнее см. в статье Макросы шаблонов;

Пример параметра

<kernelcommand>lang=en_US keymap=us ks=($OSINSTALLINFO_HTTP) method=http://mirror.yandex.ru/centos/7/os/x86_64/ initrd=initrd ip=($IP) netmask=($NETMASK) gateway=($GATEWAY) dns=($NAMESERVER)</kernelcommand>

<installcfg> — имя конфигурационного файла для установки. Этот файл указывается в макросе $OSINSTALLINFO_HTTP;
<image> — имя файла ISO-образа, который будет примонтирован в качестве CD-ROM;
<tempipv4> — требуется ли выделение временного IPv4-адреса при установке ОС с основным IPv6-адресом. Возможные варианты: yes — требуется, no — не требуется;
<sharedir> — директория внутри шаблона, файлы из которой будут доступны по HTTP. Этот файл указывается в макросе $SHAREDIR_FILE;
<support><elem version="версия"> — краткие наименования и версии панелей управления, которые поддерживают шаблон. Например, чтобы шаблон поддерживался всеми версиями DCImanager 6, начиная с версии 4.8.0, укажите <support><elem version="4.8.0">dcimgr</elem></support>;
<illegal_password_characters> — символы, которые запрещено использовать в пароле;
<sshpublickey> — поддержка добавления публичных SSH-ключей. Возможные варианты: yes –- поддерживается, no — не поддерживается;
<up_mem_on_install> — оперативная память в Мб, которую сервер может использовать при установке ОС. После установки количество памяти возвращается к основному значению;
<chpasswd_method> — метод смены пароля. Для ОС семейства Linux укажите mount.linux;
<loaderefi64>pxelinux.efi</loaderefi64> — имя файла UEFI-загрузчика;
<ipxeconf> — имя конфигурационного файла для загрузки через iPXE;
<ipxeconf type="tftp"> — опция загрузки конфигурационного файла ipxe.conf по протоколу tftp. В конфигурационный файл dhcpd.conf добавляется строка вида "tftp://<адрес_панели_управления>/.../ipxe.conf".

Примеры шаблонов

kickstart (CentOS)

Технология kickstart позволяет гибко настраивать параметры установки для шаблонов ОС CentOS. Подробнее о kickstart см. в официальной документации CentOS.

Пример файла metainfo.xml

<?xml version="1.0"?>
<doc>
  <osname>CentOS-7-amd64</osname>
  <support>
    <elem>VMmgr</elem>
    <elem>IFXmgr</elem>
  </support>
  <rebootcount>1</rebootcount>
  <kernel>vmlinuz</kernel>
  <initrd>initrd.img</initrd>
  <type>ostemplate</type>
  <loader>pxelinux.0</loader>
  <pxelinuxcfg>pxelinux.conf</pxelinuxcfg>
  <tempipv4>yes</tempipv4>
  <kernelcommand>lang=en_US keymap=us ks=($OSINSTALLINFO_HTTPv4) ksdevice=link method=http://mirror.yandex.ru/centos/7/os/x86_64/ ip=($IPv4) netmask=($NETMASKv4) gateway=($GATEWAYv4) dns=($NAMESERVERv4) proxy=($HTTPPROXYv4) text</kernelcommand>
  <installcfg>install.cfg</installcfg>
  <limit>
    <elem name="ipv4">yes</elem>
    <elem name="ipv6">yes</elem>
    <elem name="mem">512</elem>
    <elem name="disk">2000</elem>
  </limit>
 </doc>

Пример файла install.cfg

%pre

#!/bin/sh

for disk in `ls -la /dev/sd?`; do
    dd if=/dev/zero of=$disk bs=512 count=32
done

SWSIZE=$(grep MemTotal /proc/meminfo  | awk '{print int($2/1024)+1}')
if [ ${SWSIZE} -gt 2048 ]; then
    SWSIZE=2048
fi

if [ `cat /proc/scsi/scsi | grep -wc ATA` -eq 2 ]; then
     set $(fdisk -l 2>/dev/null | grep -vi mapper | grep Disk | grep dev |  sed 's/://' | awk '{print $2}' | tr '\n' ' ')
     HD1=$1
    HD2=$2
    if [ -b ${HD2} ]; then
        SIZE1=$(fdisk -l "${HD1}"  2>/dev/null  | grep Disk | grep dev |  sed 's/://'|awk '{print $5}')
        SIZE2=$(fdisk -l "${HD2}"  2>/dev/null  | grep Disk | grep dev |  sed 's/://'|awk '{print $5}')
        if [ -n "${SIZE1}" ] && [ -n "${SIZE2}" ] && [ "${SIZE1}" = "${SIZE2}" ]; then
            USE_MIRROR=yes
        fi
    fi
fi

if [ -n "${USE_MIRROR}" ]; then
cat > /tmp/part-include << EOF
part raid.11 --size=256 --asprimary --ondisk=sda
part raid.12 --size=${SWSIZE} --asprimary --ondisk=sda 
part raid.13 --size=1 --grow --asprimary --ondisk=sda 
part raid.21 --size=256 --asprimary --ondisk=sdb
part raid.22 --size=${SWSIZE} --asprimary --ondisk=sdb 
part raid.23 --size=1 --grow --asprimary --ondisk=sdb
raid /boot --fstype ext4 --device md0 --level=RAID1 raid.11 raid.21
raid swap --fstype swap --device md1 --level=RAID1 raid.12 raid.22
raid / --fstype ext4 --device md2 --level=RAID1 raid.13 raid.23
EOF
else
cat > /tmp/part-include << EOF
part /boot --fstype ext4 --size=256 --asprimary --ondisk=sda
part swap --size=${SWSIZE} --asprimary --ondisk=sda
part / --fstype ext4 --size=1 --grow --asprimary --ondisk=sda
EOF
fi

%end
auth --useshadow --enablemd5
# Crete partition map
bootloader --location=mbr
zerombr
clearpart --all --initlabel
firstboot --disable
# Disk partitioning information
%include /tmp/part-include
# System keyboard
keyboard us
# System language
lang en_US.UTF-8
# Installation logging level
logging --level=info
# Use NFS installation media
url --url http://mirror.yandex.ru/centos/7/os/x86_64/
#Root password
rootpw ($PASS)
# SELinux configuration
selinux --disabled
# Text installation
text
# System timezone
timezone --utc Europe/Moscow

# Network
network --bootproto=static --ip=($IPv4) --netmask=($NETMASK)  --gateway=($GATEWAYv4) --nameserver=($NAMESERVERv4) --hostname=($HOSTNAME) --device=link

# Install OS instead of upgrade
install
%packages
@core
%end

%post
# Настройка сети
#echo "NETWORKING=yes" > /etc/sysconfig/network
#echo "HOSTNAME=($HOSTNAME)"
ETHDEV=$(ip route show | grep default | grep -Eo 'dev\ .+\ ' | awk '{print $2}')
HWADDR=$(cat /etc/sysconfig/network-scripts/ifcfg-eth0 | awk -F= '/HWADDR/ {print $2}' | sed 's/"//g')
UUID=$(cat /etc/sysconfig/network-scripts/ifcfg-eth0 | awk -F= '/UUID/ {print $2}' | sed 's/"//g')

if [ -n "($IPv6)" ]; then
cat > /etc/sysconfig/network << EOF
NETWORKING=yes
NETWORKING_IPV6=yes
HOSTNAME=($HOSTNAME)
IPV6_DEFAULTGW=($GATEWAY)
EOF

cat > /etc/sysconfig/network-scripts/ifcfg-${ETHDEV} << EOF
DEVICE="${ETHDEV}"
BOOTPROTO="static"
DNS1="($NAMESERVER)"
HWADDR="${HWADDR}"
IPV6ADDR="($IPv6)/($NETMASKv6)"
IPV6INIT="yes"
IPV6_AUTOCONF="no"
IPV6_DEFAULTGW="($GATEWAY)"
NM_CONTROLLED="yes"
ONBOOT="yes"
TYPE="Ethernet"
UUID="${UUID}"
EOF

fi
%end

%post --nochroot
wget -O /dev/null --no-check-certificate "($FINISHv4)"
# Reboot after installation
%end

reboot

preseed (Debian, Ubuntu)

Рекомендуем использовать для шаблонов ОС Debian, Ubuntu. Подробнее см. в официальной документации Ubuntu и Debian.