Resource Type: host

This version of Puppet is not included in Puppet Enterprise. The latest version of PE includes Puppet 4.10.

NOTE: This page was generated from the Puppet source code on 2017-06-27 17:23:02 -0500

host

Description

Installs and manages host entries. For most systems, these entries will just be in /etc/hosts, but some systems (notably OS X) will have different solutions.

Attributes

host { 'resource title':
  name         => # (namevar) The host...
  ensure       => # The basic property that the resource should be...
  comment      => # A comment that will be attached to the line with 
  host_aliases => # Any aliases the host might have.  Multiple...
  ip           => # The host's IP address, IPv4 or...
  provider     => # The specific backend to use for this `host...
  target       => # The file in which to store service information.  
  # ...plus any applicable metaparameters.
}

name

(Namevar: If omitted, this attribute’s value defaults to the resource’s title.)

The host name.

(↑ Back to host attributes)

ensure

(Property: This attribute represents concrete state on the target system.)

The basic property that the resource should be in.

Valid values are present, absent.

(↑ Back to host attributes)

comment

(Property: This attribute represents concrete state on the target system.)

A comment that will be attached to the line with a # character.

(↑ Back to host attributes)

host_aliases

(Property: This attribute represents concrete state on the target system.)

Any aliases the host might have. Multiple values must be specified as an array.

(↑ Back to host attributes)

ip

(Property: This attribute represents concrete state on the target system.)

The host’s IP address, IPv4 or IPv6.

(↑ Back to host attributes)

provider

The specific backend to use for this host resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

Available providers are:

(↑ Back to host attributes)

target

(Property: This attribute represents concrete state on the target system.)

The file in which to store service information. Only used by those providers that write to disk. On most systems this defaults to /etc/hosts.

(↑ Back to host attributes)

Providers

parsed

NOTE: This page was generated from the Puppet source code on 2017-06-27 17:23:02 -0500

↑ Back to top