Skip to content

Latest commit

 

History

History
52 lines (37 loc) · 2.14 KB

README.md

File metadata and controls

52 lines (37 loc) · 2.14 KB

hostname cookbook

Build Status Chef cookbook

Description

Sets hostname and FQDN of the node. The latest code is hosted at https://github.com/3ofcoins/chef-cookbook-hostname

Important

Setting hostname on FQDN is not (and won't be) supported. Unfortunately, using dots in the hostname can cause inconsistent results for any system that consumes DNS and is not allowed by RFC952. If a user needs additional info in their shell prompt, they can change PS1 in etc/profile to include the FQDN together with any information they find useful (such as the customer, the environment, etc).

Attributes

  • node['set_fqdn'] - FQDN to set.

The asterisk character will be replaced with node.name. This way, you can add this to base role:

default_attributes :set_fqdn => '*.project-domain.com'

and have node set its FQDN and hostname based on its chef node name (which is provided on chef-client first run's command line).

  • node['hostname_cookbook']['hostsfile_ip'] -- IP used in /etc/hosts to correctly set FQDN (default: 127.0.1.1)

  • node['hostname_cookbook']['hostsfile_aliases'] -- list of aliases used in /etc/hosts for the ip set above (default: [hostname])

  • node['hostname_cookbook']['hostsfile_include_hostname_in_aliases'] -- whether to include the hostname at the end of the aliases list above (default: true)

  • node['hostname_cookbook']['append_hostsfile_ip'] -- Set to false to prevent an entry for the node's hostname from being appended in /etc/hosts (default: true)

Recipes

  • hostname::default -- will set node's FQDN to value of set_fqdn attribute, and hostname to its host part (up to first dot).
  • hostname::vmware -- sets hostname automatically using vmtoolsd. You do not need to set node["set_fqdn"].

Author

Author: Maciej Pasternacki [email protected]