Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

The chef_hostname cookbook has been deprecated

Author provided reason for deprecation:

The chef_hostname cookbook has been deprecated and is no longer being maintained by its authors. Use of the chef_hostname cookbook is no longer recommended.

RSS

chef_hostname (14) Versions 1.0.1

Configures the hostname on a node

Policyfile
Berkshelf
Knife
cookbook 'chef_hostname', '~> 1.0.1', :supermarket
cookbook 'chef_hostname', '~> 1.0.1'
knife supermarket install chef_hostname
knife supermarket download chef_hostname
README
Dependencies
Changelog
Quality 33%

NOTE THIS COOKBOOK HAS BEEN MOVED TO CORE CHEF AS OF CHEF 14.0.190

All new development will be in core chef.

chef_hostname Cookbook

Sets the node's hostname

  • resource-driven cookbook
  • supports FQDNs as hostnames
  • persists after a reboot
  • reloads ohai
  • runs at compile-time (no need to use lazy)
  • fixes up /etc/hosts so node["fqdn"] works
  • runs nearly everywhere
  • supports hostnamectl from systemd
  • not tied to any other sysctl/etc-hosts cookbook dependecies

Motivation

  • Make strong guarantees that node["fqdn"] in other recipes "just works"
  • No need to lazy { node["fqdn"] }
  • Be very portable

Requirements

Platforms

  • Ubuntu/Debian (and derivatives like Mint/Raspbian)
  • RHEL/CentOS/Scientific/Oracle/Fedora (and derivatives like Pidora)
  • OpenSUSE/SLES
  • FreeBSD/OpenBSD/NetBSD
  • Docker Containers
  • MacOS
  • Solaris
  • Gentoo
  • Arch
  • Cisco Nexus
  • Windows

Because of the way that this cookbook "Duck Types" the operating system, many systems that are not listed above have a decent chance of working out of the box provided that they implement a common pattern.

Chef

  • Chef 12.11+

Cookbooks

  • none

Custom Resources

hostname Sets the hostname, ensures that reboot will preserve the hostname, re-runs the ohai plugin to set the node data.

Actions

  • :set: Ses the hostname

Properties

  • hostname: hostname to set
  • compile_time: defaults to running at compile time, set to false to disable

Chefspec / Testing

The action to be used in Chefspec/tests is "set" for exmaple:

      it 'checks if hostname is being set' do
        expect(chef_run).to set_hostname('your.hostname.com')
      end

Examples

Setting hostname to a string:

hostname "foo.example.com"

Setting hostname to the node name:

hostname node.name

Setting hostname to whatever attribute you like:

hostname node['set_fqdn']

There is no need to "lazy" arguments to templates and filenames when this is used since it forces itself to run at compile-time.

hostname node.name

# node["fqdn"] will be set here at compile time
template "/etc/motd" do
  source "motd.erb"
  variables({
    fqdn: node["fqdn"]
  })
end

# /bin/hostname will be set here at compile time
myhostname = `/bin/hostname`

file "/etc/issue" do
  content myhostname
end

The hostname resource will drop a line into /etc/hosts so that the node["fqdn"] can be resolved correctly, and will re-trigger ohai. The default is to use the node["ipaddress"]` value for the ipaddress on the /etc/hosts line. In order to override it:

hostname node["cloud"]["public_hostname"] do
  ipaddress node["cloud"]["public_ipv4"]
end

In order to override the editing of the /etc/hosts file pass nil for the ipaddress (note that if you edit the /etc/hosts file you will be responsible for also reloading the ohai plugin and you will want to do both at compile-time yourself in order for node["fqdn"] to resolve)

hostname node.name do
  ipaddress nil
end

Aliases can also be added to the line that hostname adds to /etc/hosts:

hostname node.name do
  ipaddress "259.1.1.1"
  aliases [ "klowns.car.local", "yolo" ]
end

Notes

There are no recipes in this cookbook, the resource is meant to be used in your own custom recipes. There are no attributes in this cookbook, you can drive the resource off of whatever attribute(s) you like.

Docker container hostnames do not persist after restarts due to limitations of docker.

TODO

  • fix setting node['fqdn'] correctly on windows
  • aix
  • xenserver (probably already supported via RHEL)
  • test: exherbo, alpine, slackware, rapsbian, pidora
  • smartos, omnios, openindiana, opensolaris, nexentacore?

Maintainers

This cookbook is maintained by Chef's Community Cookbook Engineering team. Our goal is to improve cookbook quality and to aid the community in contributing to cookbooks. To learn more about our team, process, and design goals see our team documentation. To learn more about contributing to cookbooks like this see our contributing documentation, or if you have general questions about this cookbook come chat with us in #cookbok-engineering on the Chef Community Slack

License


Copyright:: 2016-2016, Chef Software, Inc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

chef_hostname Cookbook CHANGELOG

This file is used to list changes made in each version of the chef_hostname cookbook.

1.0.1 (2018-04-06)

  • This cookbook has been deprecated as the hostname resource now ships in Chef 14. If you encounter issues with the resource please update to Chef 14 and file an issue against Chef if the problem continues.
  • Dynamically update the EC2 config file on windows
  • Remove Chefspec matchers as they're auto generated now

1.0.0 (2018-01-25)

  • Update kitchen config
  • Update hostname resource check for File check so that on SUSE systems doesn't fail.
  • Require Chef 12.11 and use the built in docker helper
  • Move all maintainer information to the readme
  • The test cookbook is named test not fake

0.6.0 (2017-05-30)

  • Added testing in Travis with Delivery local mode
  • Require Chef 12.7+ in order to be Chef 13 compatible
  • Use a SPDX standard license string

0.5.0 (2017-02-27)

Full Changelog

Closed issues:

  • Missing dbus dependency on Ubuntu 16.04 LTS? #25
  • cloud-init resets hostname #23

Merged pull requests:

v0.4.2 (2016-09-19)

Full Changelog

Closed issues:

  • Multiple HOSTNAME lines added to /etc/sysconfig/network (CentOS 6.7) #16

Merged pull requests:

v0.4.1 (2016-04-05)

Full Changelog

Merged pull requests:

v0.4.0 (2016-03-22)

Full Changelog

Merged pull requests:

v0.3.1 (2016-03-21)

Full Changelog

Merged pull requests:

v0.3.0 (2016-03-11)

Full Changelog

Merged pull requests:

v0.2.0 (2016-03-11)

Full Changelog

Merged pull requests:

v0.1.2 (2016-03-11)

Full Changelog

v0.1.1 (2016-03-11)

Full Changelog

Merged pull requests:

v0.1.0 (2016-03-11)

Collaborator Number Metric
            

1.0.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

1.0.1 passed this metric

No Binaries Metric
            

1.0.1 passed this metric

Testing File Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number