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

RSS

fqdn (3) Versions 0.3.0

Installs/Configures fqdn

Berkshelf/Librarian
Policyfile
Knife
cookbook 'fqdn', '~> 0.3.0'
cookbook 'fqdn', '~> 0.3.0', :supermarket
knife cookbook site install fqdn
knife cookbook site download fqdn
README
Dependencies
Quality

fqdn cookbook

STATUS

This cookbook is not yet ready for use in production. It should only be used in testing situations such as cookbook development. Specifically, the line editing library it depends on contains bugs and will edit files over multiple runs in certain circumstances.

Description

There is an unfortunate amount of confusion and misunderstanding around the term FQDN. The acronym stands for "Fully Qualified Domain Name". This leads to some confusion about the relationship between it and a hostname. It would be better called "Fully Qualified DNS Host Name".

On linux, it is found by issuing the command hostname -f. On Solaris, there is no such thing, but you can set a dnsdomain name.

Linux will only return data when the proper bits are aligned in /etc/hosts. The order of these bits need to be in is determined by the version of glibc on the system. Solaris works a different way. Don't even get me started on Windows.

How this gets set initially comes from many different directions. Some Enterprises will keep a standard naming scheme and inject hostnames and fqdns into hosts during provisioning. Some Cloud providers will supply you with forward and reverse DNS, visible from the running system. Some wont. Sometimes you get a machine who's hostname is set to "computer" with no notion of being on a DNS domain at all.

Lots of server software breaks when a machine's FQDN is not properly set. Chef recipes that refer to the FQDN attribute will error Ohai is unable to determine what the FQDN should be.

Frankly, the whole thing is a mess.

This cookbook aims to easily set an FQDN on machines where it is not properly set out of the box.

Attributes

default['machine_fqdn'] = nil
default['machine_fqdn_as_hostname'] = true

Behavior

If included in the run_list, fqdn::default will attempt to repair the machine's FQDN based on user supplied data. If the attribute node['machine_fqdn'] is set, it will use the string found there to attempt to configuration the machine's hostname.

If node['machine_fqdn_as_hostname'] is set to true (it is by default), it will configure the machine such that the hostname command returns the full DNS path to the machine. That is, hostname and hostname -f will return the same things on Linux machines.

Requirements

line cookbook
hostsfile cookbook

Usage

include_recipe 'fqdn'

Recipes

debian.rb rhel.rb

Author

Author:: Sean OMeara (someara@opscode.com)

Dependent cookbooks

now >= 0.0.0
hostsfile >= 0.0.0
line >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

0.3.0 failed this metric

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

Contributing File Metric
            

0.3.0 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
            

0.3.0 failed this metric

FC064: Ensure issues_url is set in metadata: fqdn/metadata.rb:1
FC065: Ensure source_url is set in metadata: fqdn/metadata.rb:1
FC066: Ensure chef_version is set in metadata: fqdn/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: fqdn/metadata.rb:1
FC069: Ensure standardized license defined in metadata: fqdn/metadata.rb:1
Run with Foodcritic Version 11.1.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

0.3.0 failed this metric

fqdn does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

0.3.0 passed this metric

Publish Metric
            

0.3.0 passed this metric

Supported Platforms Metric
            

0.3.0 failed this metric

fqdn should declare what platform(s) it supports.

Testing File Metric
            

0.3.0 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
            

0.3.0 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