Модуль community.hrobot.boot — настройка конфигурации загрузки

Примечание

Этот модуль входит в коллекцию community.hrobot (версия 2.7.2).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.hrobot.

Чтобы использовать её в плейбуке, укажите: community.hrobot.boot.

Добавлено в community.hrobot 1.2.0

Краткое описание
Параметры
Атрибуты
См. также
Примеры
Возвращаемые значения

Краткое описание

Задаёт конфигурацию загрузки выделенного сервера.

Параметры

Параметр	Комментарии
hetzner_password string / обязательный	Пароль пользователя веб-службы Robot.
hetzner_user string / обязательный	Имя пользователя веб-службы Robot.
install_cpanel dictionary	Если указан этот параметр, при следующей загрузке будет запущена установка cPanel. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
arch integer	Архитектура, используемая для установки. Не все архитектуры доступны для всех дистрибутивов. По умолчанию используется `64`. Этот параметр устарел и будет удалён в community.hrobot 3.0.0. Варианты: `32` `64`
dist string / обязательный	Дистрибутив для установки.
hostname string / обязательный	Имя хоста.
lang string / обязательный	Язык операционной системы.
install_linux dictionary	Если указан этот параметр, при следующей загрузке будет запущена установка системы Linux. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
arch integer	Архитектура, используемая для установки. Не все архитектуры доступны для всех дистрибутивов. По умолчанию используется `64`. Этот параметр устарел и будет удалён в community.hrobot 3.0.0. Варианты: `32` `64`
authorized_keys list / elements=string	Один или несколько отпечатков SSH-ключей, которые будут добавлены в систему восстановления. Вместо отпечатка можно указать открытый ключ — модуль вычислит его отпечаток и передаст его в API Robot. Можно использовать только отпечатки SSH-ключей, добавленных в API Robot. Для просмотра доступных SSH-ключей используйте модуль community.hrobot.ssh_key_info, а для добавления или обновления SSH-ключей — модуль community.hrobot.ssh_key.
dist string / обязательный	Дистрибутив для установки.
lang string / обязательный	Язык операционной системы.
install_plesk dictionary	Если указан этот параметр, при следующей загрузке будет запущена установка Plesk. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
arch integer	Архитектура, используемая для установки. Не все архитектуры доступны для всех дистрибутивов. По умолчанию используется `64`. Этот параметр устарел и будет удалён в community.hrobot 3.0.0. Варианты: `32` `64`
dist string / обязательный	Дистрибутив для установки.
hostname string / обязательный	Имя хоста.
lang string / обязательный	Язык операционной системы.
install_vnc dictionary	Если указан этот параметр, при следующей загрузке будет запущена установка VNC. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
arch integer	Архитектура, используемая для установки. Не все архитектуры доступны для всех дистрибутивов. По умолчанию используется `64`. Этот параметр устарел и будет удалён в community.hrobot 3.0.0. Варианты: `32` `64`
dist string / обязательный	Дистрибутив для установки.
lang string / обязательный	Язык операционной системы.
install_windows dictionary	Если указан этот параметр, при следующей загрузке будет запущена установка Windows. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
lang string / обязательный	Язык Windows.
rate_limit_retry_timeout integer добавлено в community.hrobot 2.1.0	Время ожидания (в секундах) при получении ошибок превышения ограничения частоты запросов. Укажите `0`, чтобы не повторять запрос. Укажите отрицательное значение, например `-1`, чтобы повторять запрос бесконечно. По умолчанию: `-1`
regular_boot boolean	Если указан этот параметр, все специальные конфигурации загрузки удаляются, и при следующей загрузке запускается установленная операционная система (если она поддерживает загрузку). Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`. Варианты: `false` `true`
rescue dictionary	Если указан этот параметр, при следующей загрузке будет запущена система восстановления. Необходимо указать ровно один из параметров `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk` и `install_cpanel`.
arch integer	Архитектура системы восстановления. Не все архитектуры доступны для всех операционных систем. По умолчанию используется `64`. Этот параметр устарел и будет удалён в community.hrobot 3.0.0. Варианты: `32` `64`
authorized_keys list / elements=string	Один или несколько отпечатков SSH-ключей, которые будут добавлены в систему восстановления. Вместо отпечатка можно указать открытый ключ — модуль вычислит его отпечаток и передаст его в API Robot. Можно использовать только отпечатки SSH-ключей, добавленных в API Robot. Для просмотра доступных SSH-ключей используйте модуль community.hrobot.ssh_key_info, а для добавления или обновления SSH-ключей — модуль community.hrobot.ssh_key.
os string / обязательный	Операционная система для системы восстановления. Доступные варианты могут меняться со временем. В настоящее время, по всей видимости, доступны `linux`, `linuxold`, `freebsd`, `freebsdold`, `freebsdax`, `freebsdbetaax`, `vkvm` и `vkvmold`.
server_number integer / обязательный	Номер сервера, конфигурацию загрузки которого нужно изменить.

Атрибуты

Атрибут	Поддержка	Описание
action_group	Группа действий: community.hrobot.robot добавлено в community.hrobot 1.6.0	Используйте `group/community.hrobot.robot` в `module_defaults`, чтобы задать значения по умолчанию для этого модуля.
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз состояния изменений, не изменяя целевой объект.
diff_mode	Поддержка: нет	В режиме различий будут возвращены сведения об изменениях (или о возможных изменениях в `check_mode`).
idempotent	Поддержка: полная	При повторном запуске подряд с теми же аргументами вне режима проверки второй запуск сообщает об отсутствии изменений. Предполагается, что система, которой управляет модуль или которую он опрашивает, не изменилась существенным образом.

См. также

community.hrobot.ssh_key: Добавление, удаление или обновление SSH-ключа.
community.hrobot.ssh_key_info: Получение сведений об SSH-ключах.

Примеры

---
- name: Disable all special boot configurations
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    regular_boot: true

- name: Enable a rescue system (64bit Linux) for the next boot
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    rescue:
      os: linux

- name: Enable a Linux install for the next boot
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    install_linux:
      dist: CentOS 5.5 minimal
      lang: en
      authorized_keys:
        - 56:29:99:a4:5d:ed:ac:95:c1:f5:88:82:90:5d:dd:10
        - 15:28:b0:03:95:f0:77:b3:10:56:15:6b:77:22:a5:bb

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
configuration_type string	Описывает активную конфигурацию загрузки. Возвращается: при успехе Возможные значения: `"regular_boot"` `"rescue"` `"install_linux"` `"install_vnc"` `"install_windows"` `"install_plesk"` `"install_cpanel"`
password string	Пароль root для активной конфигурации загрузки, если он доступен. Для конфигураций загрузки, не связанных с системой восстановления, рекомендуется как можно скорее сменить пароль root. Возвращается: при успехе и если `configuration_type` не равно `regular_boot`

Ключ

Описание

configuration_type

string

Описывает активную конфигурацию загрузки.

Возвращается: при успехе

Возможные значения:

"regular_boot"
"rescue"
"install_linux"
"install_vnc"
"install_windows"
"install_plesk"
"install_cpanel"

password

string

Пароль root для активной конфигурации загрузки, если он доступен.

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

Возвращается: при успехе и если configuration_type не равно regular_boot

Авторы

Felix Fontein (@felixfontein)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/hrobot/boot_module.html