apt_dater

Manage the apt-dater and apt-dater-host package and configuration files.

Table of Contents

1. Description
2. What apt_dater affects
3. Usage
   • Managed Nodes
   • Central Node
4. Limitations - OS compatibility, etc.

Description

Briefly tell users why they might want to use your module. Explain what your module does and what kind of problems users can solve with it.

This should be a fairly short description helps the user decide if your module is what they want.

What apt_dater affects

This module install apt-dater-host on managed Debian machines and apt-dater on a central node to perform update from a single point.

Usage

Managed nodes

On managed node you can export the host to the central node via the Puppet Store Config functionality.

You can export the host yourself with de defined type apt_dater::host or let the module do it for you:

class { 'apt_dater':
  ensure        => 'present',
  export_host   => true,
  export_config => {
     user  => 'update_user',
     group => 'Databases',
  },
  collect_tag  => 'production', 
}

Central node

To collect all exported nodes on the central update node, you can use this:

class { 'apt_dater':
  ensure         => 'present',
  export_host    => true,
  export_config  => {
     user  => 'root',
     host  => 'localhost',
     group => 'Management',
  },
  collect_hosts => true,
  collect_tag   => 'production', 
}

Limitations

Only Debian-like operating systems are supported as apt-dater is tied to aptitude/apt package manager.

Reference

Table of Contents

Classes

• apt_dater: Install and configure apt-dater

Defined types

• apt_dater::host: Configure a host in apt-dater
• apt_dater::hostgroup: Group host

Classes

apt_dater

Install and configure apt-dater

Examples

include apt_dater

Parameters

The following parameters are available in the apt_dater class:

• ensure
• manage_tmux_package
• export_host
• export_config
• config_host_path
• config_path
• collect_hosts
• collect_tag
• spawn_agent

ensure

Data type: Enum['present', 'absent']

Should apt-dater and apt-dater-host be installed?

Default value: 'present'

manage_tmux_package

Data type: Boolean

Sould this class install tmux

Default value: true

export_host

Data type: Boolean

Do i need to export this host to be collected?

Default value: true

export_config

Data type: Hash[String, Any]

The attribute to pass to the exported host

Default value: {}

config_host_path

Data type: Stdlib::Unixpath

The config file to save the host list

Default value: '/etc/apt-dater/hosts.xml'

config_path

Data type: Stdlib::Unixpath

The config file of apt-dater central node

Default value: '/etc/apt-dater/apt-dater.xml'

collect_hosts

Data type: Boolean

Should we collect all exported hosts?

Default value: false

collect_tag

Data type: String

The tag to use for the export and the collect

Default value: 'default'

spawn_agent

Data type: Boolean

Do apt-dater need to spawn his own agent?

Default value: false

Defined types

apt_dater::host

Configure a host in apt-dater

Examples

apt_dater::host { 'namevar':
  host => 'myserver.mycompany.lan',
  user => 'root',
}

Parameters

The following parameters are available in the apt_dater::host defined type:

• user
• host
• group
• ensure
• comment
• type
• port
• identity

user

Data type: String

Username used for the SSH connection

host

Data type: String

Hostname or IP used for the connection

group

Data type: String[1]

Group of this host

Default value: 'Default Group'

ensure

Data type: Enum['present', 'absent']

Should this host be present

Default value: 'present'

comment

Data type: Optional[String[1]]

Comment for this host dicplayed in apt-dater

Default value: undef

type

Data type: String[1]

Connection type

Default value: 'generic-ssh'

port

Data type: Integer[1, 65535]

SSH Port

Default value: 22

identity

Data type: Optional[Stdlib::Unixpath]

Identity file to use

Default value: undef

apt_dater::hostgroup

Group host

Examples

apt_dater::hostgroup { 'Internal Hosts': }

Parameters

The following parameters are available in the apt_dater::hostgroup defined type:

• user

user

Data type: Optional[String[1]]

the default user of this group

Default value: undef