community.hrobot.boot модуль – Установка конфигурации загрузки

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.hrobot.

Для использования в плейбуке укажите: community.hrobot.boot.

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

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

Описание

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

Параметры

Параметр	Комментарии
hetzner_password строка / обязательно	Пароль пользователя веб-службы Robot.
hetzner_user строка / обязательно	Имя пользователя веб-службы Robot.
install_cpanel словарь	Если этот параметр указан, будет активирована установка cPanel для следующей загрузки. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
arch целое число	Архитектура для использования при установке. Не все архитектуры доступны для всех дистрибутивов. По умолчанию `64`. Варианты: `32` `64`
dist строка / обязательно	Дистрибутив для установки.
hostname строка / обязательно	Имя хоста.
lang строка / обязательно	Язык для операционной системы.
install_linux словарь	Если этот параметр указан, будет активирована установка Linux для следующей загрузки. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
arch целое число	Архитектура для использования при установке. Не все архитектуры доступны для всех дистрибутивов. По умолчанию `64`. Варианты: `32` `64`
authorized_keys список / элементы=строка	Один или несколько отпечатков цифровых подписей SSH для оснащения системы восстановления. Можно использовать только отпечатки цифровых подписей SSH-ключей, размещённых в API Robot. Для получения списка доступных SSH-ключей используйте модуль community.hrobot.ssh_key_info, а для добавления или обновления — модуль community.hrobot.ssh_key.
dist строка / обязательно	Дистрибутив для установки.
lang строка / обязательно	Язык для операционной системы.
install_plesk словарь	Если этот параметр указан, будет активирована установка Plesk для следующей загрузки. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
arch целое число	Архитектура для использования при установке. Не все архитектуры доступны для всех дистрибутивов. По умолчанию `64`. Варианты: `32` `64`
dist строка / обязательно	Дистрибутив для установки.
hostname строка / обязательно	Имя хоста.
lang строка / обязательно	Язык для операционной системы.
install_vnc словарь	Если этот параметр указан, будет активирована установка VNC для следующей загрузки. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
arch целое число	Архитектура для использования при установке. Не все архитектуры доступны для всех дистрибутивов. По умолчанию `64`. Варианты: `32` `64`
dist строка / обязательно	Дистрибутив для установки.

END_OF_DOCUMENT_MARKER

lang строка / обязательно	Язык, используемый для операционной системы.
install_windows словарь	Если этот параметр указан, будет активирована установка Windows для следующей загрузки. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
lang строка / обязательно	Язык, используемый для Windows.
regular_boot логическое значение	Если этот параметр указан, все специальные конфигурации загрузки удаляются, и установленная операционная система будет загружена в следующий раз (при условии, что она загружается). Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`. Варианты: `false` `true`
rescue словарь	Если этот параметр указан, для следующей загрузки будет активирована система восстановления. Необходимо указать ровно один из `regular_boot`, `rescue`, `install_linux`, `install_vnc`, `install_windows`, `install_plesk`, и `install_cpanel`.
arch целое число	Архитектура, используемая для системы восстановления. Не все архитектуры доступны для всех операционных систем. По умолчанию `64`. Варианты: `32` `64`
authorized_keys список / элементы=строка	Один или несколько отпечатков ключей SSH для оснащения системы восстановления. Можно использовать только отпечатки ключей SSH, размещенных в API Robot. Для запроса ключей SSH, которые можно использовать, можно использовать модуль community.hrobot.ssh_key_info, а для добавления или обновления ключей SSH - модуль community.hrobot.ssh_key.
os строка / обязательно	Операционная система, используемая для системы восстановления. Возможные варианты могут меняться со временем. В настоящее время, по-видимому, доступны `linux`, `linuxold`, `freebsd`, `freebsdold`, `freebsdax`, `freebsdbetaax`, `vkvm`, и `vkvmold`.
server_number целое число / обязательно	Номер сервера, конфигурацию загрузки которого нужно изменить.

Атрибуты

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

См. также

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 строка	Описание активной конфигурации загрузки. Возвращается: успех Может возвращать только: `"regular_boot"` `"rescue"` `"install_linux"` `"install_vnc"` `"install_windows"` `"install_plesk"` `"install_cpanel"`
password строка	Корневой пароль для активной конфигурации загрузки, если доступен. Для конфигураций загрузки, не являющихся конфигурациями восстановления, рекомендуется как можно скорее изменить корневой пароль. Возвращается: успех и если `configuration_type` не `regular_boot`

Ключ

Описание

configuration_type

строка

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

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

Может возвращать только:

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

password

строка

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

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

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

Авторы

Felix Fontein (@felixfontein)

Ссылки на сборку

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