ansible_hostname
hostname
Install dependencies and configure the hostname on your system.
GitHub | GitLab | Quality | Downloads | Version |
---|---|---|---|---|
Example Playbook
This example is taken from molecule/default/converge.yml
and is tested on each push, pull request and release.
---
- name: converge
hosts: all
become: yes
gather_facts: yes
roles:
- role: robertdebock.hostname
The machine needs to be prepared. In CI this is done using molecule/default/prepare.yml
:
---
- name: prepare
hosts: all
become: yes
gather_facts: no
roles:
- role: robertdebock.bootstrap
Also see a full explanation and example on how to use these roles.
Role Variables
The default values for the variables are set in defaults/main.yml
:
---
# defaults file for hostname
# The hostname to set. By default whatever the inventory is set to.
hostname: "{{ inventory_hostname_short }}"
# Should the machine be rebooted when the hostname is changed?
hostname_reboot: yes
Requirements
- pip packages listed in requirements.txt.
Status of used roles
The following roles are used to prepare a system. You can prepare your system in another way.
Requirement | GitHub | GitLab |
---|---|---|
robertdebock.bootstrap |
Context
This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.
Here is an overview of related roles:
Compatibility
This role has been tested on these container images:
container | tags |
---|---|
alpine | all |
amazon | Candidate |
el | 8 |
debian | all |
fedora | all |
opensuse | all |
ubuntu | all |
The minimum version of Ansible required is 2.10, tests have been done to:
- The previous version.
- The current version.
- The development version.
If you find issues, please register them in GitHub
License
Apache-2.0
Contributors
I'd like to thank everybody that made contributions to this repository. It motivates me, improves the code and is just fun to collaborate.
Author Information
Please consider sponsoring me.
ansible-galaxy install OsgiliathEnterprise/ansible-role-hostname