Version information
This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x
- Puppet >= 5.5.10 < 7.0.0
- , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'ghoneycutt-timezone', '2.0.0'
Learn more about managing modules with a PuppetfileDocumentation
puppet-module-timezone
Table of Contents
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with timezone
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Module description
This module manages the timezone.
Setup
What timezone affects
It symlinks /etc/localtime
to the appropriate timezone under
/usr/share/zoneinfo/
. On EL6 it manages /etc/sysconfig/clock
. On
Debian and Ubuntu it manages /etc/timezone
.
Setup requirements
This module has no dependencies outside of stdlib.
Beginning with timezone
Include the timezone
class to set your timezone to 'UTC'.
include timezone
Usage
To set the timezone to something other than the default of 'UTC'.
Example using a manifest
class { 'timezone':
timezone => 'Europe/Berlin',
}
Example using Hiera
timezone::timezone: 'Europe/Berlin'
If using EL6
You can specify if the hardware clock is set to UTC.
Example using a manifest
class { 'timezone':
hwclock_utc => true,
}
Example using Hiera
timezone::hwclock_utc: true
Limitations
This module has been tested to work on the following platforms with the
latest releases of Puppet v5 and v6 with the ruby versions associated with those
platforms. See .travis.yml
for an exact matrix.
- EL 6
- EL 7
- Debian 8
- Debian 9
- Ubuntu 14.04 LTS
- Ubuntu 16.04 LTS
- Ubuntu 18.04 LTS
Development
See CONTRIBUTING.md
for information related to the development of this
module.
Reference
Table of Contents
Classes
timezone
: This module manages the system's default timezone setting.
Classes
timezone
This module manages the system's default timezone setting.
Examples
Declaring the class
include timezone
Parameters
The following parameters are available in the timezone
class.
timezone
Data type: String
The systems default timezone, e.g. 'UTC' or 'Europe/Berlin'. See
/usr/share/zoneinfo
for available values.
Default value: 'UTC'
hwclock_utc
Data type: Optional[Boolean]
Optional boolean value indicating if the system's hardware clock is UTC
(true) or localtime (false). This value is only used on EL 6. If set to
undef
the UTC
setting will not be present in /etc/sysconfig/clock
.
Default value: undef
Change Log
v2.0.0
Merged pull requests:
- Release v2.0.0 - Modernize module #7 (ghoneycutt)
v1.2.1 (2016-11-04)
v1.2.0 (2016-11-04)
Merged pull requests:
- Add support for Ruby v2.3.1 #6 (ghoneycutt)
v1.1.1 (2016-07-12)
Merged pull requests:
- Docs and testing fixes #5 (ghoneycutt)
v1.1.0 (2016-05-27)
Merged pull requests:
- Support puppet v3 with future parser and puppet v4 (fixed) #3 (Phil-Friderici)
- Support puppet v3 with future parser and puppet v4 #2 (ghoneycutt)
v1.0.1 (2015-02-11)
v1.0.0 (2014-12-09)
v0.3.0 (2014-10-15)
v0.2.0 (2014-05-23)
v0.1.0 (2014-03-28)
* This Change Log was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 5.2.0 < 7.0.0)
Copyright (C) 2014 Niklas Grossmann <ngrossmann@gmx.net> Copyright (C) 2014-2019 Garrett Honeycutt <code@garretthoneycutt.com> 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.