Blog

03/06/2019

Ansible reboot Linux machine or server with playbooks



I need to reboot the VM or bare metal Linux machine/server using Ansible and wait for it to come back, but it does not work with playbook as descried here. How to reboot Linux server with Ansible? How do I reboot and wait for reboot to complete in Ansible playbook for multiple Linux servers?

Introduction: You can reboot a Linux or Unix based machine, wait for it to go down (say for kernel update), come back up, and respond to commands. You can use either command or shell module to reboot the Linux server when kernel updated. However, now we have a reboot module to reboot a machine using Ansible. I tested this module with:

  1. Ubuntu Linux 16.04 / 18.04 LTS
  2. CentOS Linux 7
  3. Debian Linux 9.x
  4. RHEL 7.x
  5. SUSE 12.x
  6. FreeBSD
  7. OpenBSD

Prerequisite

Please note that you must have Ansible version 2.7 to work with the reboot module:
$ ansible --version

If not using Ansible version 2.7, try to update it using the dnf command/yum command/apt command/apt-get command as per your Linux distro version:
$ sudo apt update ## Debian or Ubuntu box ##
$ sudo yum update ## RHEL/CentOS 7 ##

Ansible reboot Linux machine or server with playbooks

The syntax is pretty simple to do reboot:

- name: Reboot the machine with all defaults using Ansible
  reboot:

– name: Reboot the machine with all defaults using Ansible reboot:

Here is a sample hosts file displayed using the cat command:

[all:vars]
k_ver="linux-image-4.15.0-36-generic"
ansible_user='{{ my_c_user }}'
ansible_become=yes
ansible_become_method=sudo
ansible_become_pass='{{ my_c_sudo_pass }}'
 
[legacy]
do-de.public
 
[cluster]
ln.cbz01 
ln.cbz02 
ln.cbz04 
ln.forum 
 
[lxd]
ln.cbz01
ln.cbz02
ln.cbz04
do-de.public 
 
[vpn:vars]
ansible_python_interpreter='/usr/bin/env python3'
 
[vpn]
do-blr-vpn
 
[backup]
gcvm.backup
 
[nodes:children]
vpn
backup
cluster
legacy
 
[isrestart:children]
backup
cluster
vpn

[all:vars] k_ver="linux-image-4.15.0-36-generic" ansible_user='{{ my_c_user }}’ ansible_become=yes ansible_become_method=sudo ansible_become_pass='{{ my_c_sudo_pass }}’ [legacy] do-de.public [cluster] ln.cbz01 ln.cbz02 ln.cbz04 ln.forum [lxd] ln.cbz01 ln.cbz02 ln.cbz04 do-de.public [vpn:vars] ansible_python_interpreter=’/usr/bin/env python3′ [vpn] do-blr-vpn [backup] gcvm.backup [nodes:children] vpn backup cluster legacy [isrestart:children] backup cluster vpn

Here is my reboot.yml:

---
- hosts: isrestart
  become: true
  become_user: root
  tasks:
          - name: Rebooting the cloud server/bare metal box
            reboot:

— – hosts: isrestart become: true become_user: root tasks: – name: Rebooting the cloud server/bare metal box reboot:

How to use Ansible reboot module playbook to reboot the box

Now all you have to do is run playbook (see how to set and use sudo password for Ansible Vault)
$ ansible-playbook -i hosts --ask-vault-pass --extra-vars '@cluster.data.yml' reboot.yml

How to reboot a machine and set time out value

By default Ansible reboot module waits 600 seconds. You can increase value using the following syntax:

- name: Reboot a Linux machine 
  reboot:
    reboot_timeout: 1800

– name: Reboot a Linux machine reboot: reboot_timeout: 1800

How to set command to run on the rebooted host and expect success from to determine the machine is ready for further tasks

By default whoami command used by ansbile. You can change it as follows:

- name: Reboot a Linux machine 
  reboot:
    test_command: uptime

– name: Reboot a Linux machine reboot: test_command: uptime

OR

- name: Reboot a Linux machine 
  reboot:
    test_command: ping -c 4 192.168.2.254

– name: Reboot a Linux machine reboot: test_command: ping -c 4 192.168.2.254

How to set pre and post reboot delay

One can force Ansible to wait after the reboot was successful and the connection was re-established in seconds as follows:

- name: Unconditionally reboot the machine with all defaults
  reboot:
    post_reboot_delay: 180

– name: Unconditionally reboot the machine with all defaults reboot: post_reboot_delay: 180

The above is useful if you want wait for additional networking/storage or server vpn to kick in despite your connection already working. You can also set time for shutdown to wait before requesting reboot:

- name: Unconditionally reboot the machine with all defaults
  reboot:
    pre_reboot_delay: 180

– name: Unconditionally reboot the machine with all defaults reboot: pre_reboot_delay: 180

Conclusion

You just learned how to reboot Linux/Unix box and wait for reboot to complete in Ansible playbook. For more info see this page here.

This entry is 2 of 2 in the Ansible Reboot a Machine/Server Tutorial series. Keep reading the rest of the series:
  1. Ansible reboot a Debian/Ubuntu Linux for kernel update and wait for it
  2. Ansible reboot Linux machine or server with playbooks

(adsbygoogle = window.adsbygoogle || []).push({});

Posted by: SXI ADMIN

The author is the creator of nixCraft and a seasoned sysadmin, DevOps engineer, and a trainer for the Linux operating system/Unix shell scripting. Get the latest tutorials on SysAdmin, Linux/Unix and open source topics via RSS/XML feed or weekly email newsletter.

14/08/2019

How to KVM, QEMU start or stop virtual machine from command line (CLI)

KVM or Kernel Based Virtual Machine is a popular virtualization technology. It allows you to run virtual guest machines over a host machine. To start...
14/08/2019

How to Docker backup Saving and restoring your volumes

Running a Docker volume backup First, we spin up a temporary container, and we mount the backup folder and the target Docker volume to this container....
12/08/2019

How to Start and Enable Firewalld on CentOS 7

In this article, we discuss how to start and enable firewalld. It is highly recommended that you have a firewall protecting your server.Pre-Flight CheckThese...