User data

User data

User data — пользовательские параметры конфигурации операционной системы сервера. Описываются в виде скриптов в формате cloud-config (текстовые файлы с YAML-синтаксисом) или как bash-скрипт. Скрипты автоматически кодируются в Base64, передаются на сервер и выполняются с помощью агента cloud-init при первом запуске операционной системы. Использование user data помогает автоматизировать настройку серверов.

Указать user data можно при создании облачного сервера.

Подробнее о форматах скриптов cloud-config и bash в инструкции User data formats документации cloud-init.

В скриптах можно передавать параметры для настройки операционной системы и сценарии. Например:

создать каталог и загрузить в него файлы;
обновить репозитории и установить пакеты программного обеспечения;
разместить SSH-ключи на сервере;
настроить файл конфигурации преобразователя доменных имен resolv.conf.

Посмотрите другие примеры в инструкции Cloud config examples документации cloud-init.

Указать user data⁠

Указать user data можно только при создании облачного сервера:

в панели управления — на шаге 14 можно вставить текст в поле User data, загрузить файл в форматах txt, gz, sh или MIME-архив. Максимальный размер скрипта с данными, которые не закодированы в Base64, — 16 КБ;
через OpenStack CLI и Terraform — только скрипты с данными, закодированными в Base64.

После создания сервера изменить скрипт нельзя.

Примеры user data⁠

Создать каталог и загрузить в него файлы⁠⁠

Cloud-config
Bash-скрипт

Пример скрипта для создания каталога и загрузки в него файла по сети:

#cloud-config
runcmd:
- mkdir /run/newdir
- [ wget, "http://example.com", -O, /run/newdir/index.html ]

Пример скрипта для создания каталога и загрузки в него файла по сети:

#!/bin/sh
mkdir /run/newdir
wget http://example.com -O /run/newdir/index.html

Обновить репозитории и установить пакеты⁠

Cloud-config
Bash-скрипт

Пример скрипта для установки pwgen и pastebinit:

#cloud-config
package_update: true
packages:
 - pwgen
 - pastebinit

Пример скрипта для установки docker:

#!/bin/sh
apt update
apt install docker

Разместить SSH-ключи на сервере⁠

Cloud-config
Bash-скрипт

Пример скрипта:

#cloud-config
ssh_authorized_keys:
  - ssh-rsa AAAAB3N…V7NZ user1@host
  - ssh-rsa AAAAB3N…NtHw== user2@server

Пример скрипта:

#!/bin/sh
echo "ssh-rsa AAAAB3N…V7NZ user1@host" >> /root/.ssh/authorized_keys
echo "sssh-rsa AAAAB3N…NtHw== user2@server" >> /root/.ssh/authorized_keys

Настроить файл конфигурации⁠

Cloud-config
Bash-скрипт

Пример скрипта для преобразователя доменных имен resolv.conf:

#cloud-config
manage_resolv_conf: true
resolv_conf:
  nameservers: ['4.4.4.4', '8.8.8.8']
  searchdomains:
    - foo.example.com
    - bar.example.com
  domain: example.com
  options:
    rotate: true
    timeout: 1

Пример скрипта для преобразователя доменных имен resolv.conf:

#!/bin/sh
cat <<EOF > /etc/resolv.conf
domain example.com
nameserver 4.4.4.4
nameserver 8.8.8.8
search foo.example.com bar.example.com
options rotate
options timeout:1
EOF

Указать user data⁠​

Примеры user data⁠​

Создать каталог и загрузить в него файлы⁠⁠​

Обновить репозитории и установить пакеты⁠​

Разместить SSH-ключи на сервере⁠​

Настроить файл конфигурации⁠​