community.hrobot.boot – Set boot configuration

Note

This plugin is part of the community.hrobot collection (version 1.2.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.hrobot.

To use it in a playbook, specify: community.hrobot.boot.

New in version 1.2.0: of community.hrobot

Synopsis

  • Set the boot configuration for a dedicated server.

Parameters

Parameter Choices/Defaults Comments
hetzner_password
string / required
The password for the Robot webservice user.
hetzner_user
string / required
The username for the Robot webservice user.
install_cpanel
dictionary
If this option is provided, a cPanel installation will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
arch
integer
    Choices:
  • 32
  • 64
The architecture to use for the install.
Not all architectures are available for all distributions.
Defaults to 64.
dist
string / required
The distribution to install.
hostname
string / required
The hostname.
lang
string / required
The language to use for the operating system.
install_linux
dictionary
If this option is provided, a Linux system install will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
arch
integer
    Choices:
  • 32
  • 64
The architecture to use for the install.
Not all architectures are available for all distributions.
Defaults to 64.
authorized_keys
list / elements=string
One or more SSH key fingerprints to equip the rescue system with.
Only fingerprints for SSH keys deposited in the Robot API can be used.
You can use the community.hrobot.ssh_key_info module to query the SSH keys you can use, and the community.hrobot.ssh_key module to add or update SSH keys.
dist
string / required
The distribution to install.
lang
string / required
The language to use for the operating system.
install_plesk
dictionary
If this option is provided, a Plesk installation will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
arch
integer
    Choices:
  • 32
  • 64
The architecture to use for the install.
Not all architectures are available for all distributions.
Defaults to 64.
dist
string / required
The distribution to install.
hostname
string / required
The hostname.
lang
string / required
The language to use for the operating system.
install_vnc
dictionary
If this option is provided, a VNC installation will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
arch
integer
    Choices:
  • 32
  • 64
The architecture to use for the install.
Not all architectures are available for all distributions.
Defaults to 64.
dist
string / required
The distribution to install.
lang
string / required
The language to use for the operating system.
install_windows
dictionary
If this option is provided, a Windows installation will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
lang
string / required
The language to use for Windows.
regular_boot
boolean
    Choices:
  • no
  • yes
If this option is provided, all special boot configurations are removed and the installed operating system will be booted up next (assuming it is bootable).
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
rescue
dictionary
If this option is provided, the rescue system will be activated for the next boot.
Precisely one of regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, and install_cpanel must be provided.
arch
integer
    Choices:
  • 32
  • 64
The architecture to use for the rescue system.
Not all architectures are available for all operating systems.
Defaults to 64.
authorized_keys
list / elements=string
One or more SSH key fingerprints to equip the rescue system with.
Only fingerprints for SSH keys deposited in the Robot API can be used.
You can use the community.hrobot.ssh_key_info module to query the SSH keys you can use, and the community.hrobot.ssh_key module to add or update SSH keys.
os
string / required
The operating system to use for the rescue system. Possible choices can change over time.
Currently, linux, linuxold, freebsd, freebsdold, freebsdax, freebsdbetaax, vkvm, and vkvmold seem to be available.
server_number
integer / required
The server number of the server whose boot configuration to adjust.

See Also

See also

community.hrobot.ssh_key

Add, remove or update SSH key

community.hrobot.ssh_key_info

Query information on SSH keys

Examples

- 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.reset:
    hetzner_user: foo
    hetzner_password: bar
    rescue:
      os: linux

- name: Enable a Linux install for the next boot
  community.hrobot.reset:
    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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
configuration_type
string
success
Describes the active boot configuration.

Can only return: regular_boot, rescue, install_linux, install_vnc, install_windows, install_plesk, install_cpanel
password
string
success and if a boot configuration other than regular_boot is active
The root password for the active boot configuration, if available.
For non-rescue boot configurations, it is avised to change the root password as soon as possible.



Authors

  • Felix Fontein (@felixfontein)