Version information
This version is compatible with:
- Puppet Enterprise 3.x
- Puppet 3.x
- , , , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'electrical-file_concat', '1.0.1'
Learn more about managing modules with a PuppetfileDocumentation
puppet-lib-file_concat
Table of Contents
- Overview
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Overview
Library for concatenating multiple files into 1.
Usage
Creating a file fragment
Creates a file fragment to be collected by file_concat based on the tag.
Example with exported resource:
@@file_fragment { "uniqe_name_${::fqdn}":
tag => 'unique_tag', # Mandatory.
order => 10, # Optional. Defaults to 10.
content => 'some content' # OR
content => template('template.erb') # OR
source => 'puppet:///path/to/file'
}
Concatenating file fragments into one file
Gets all the file fragments and puts these into the target file. This will mostly be used with exported resources.
example:
File_fragment <<| tag == 'unique_tag' |>>
file_concat { '/tmp/file':
tag => 'unique_tag', # Mandatory
path => '/tmp/file', # Optional. If given it overrides the resource name.
owner => 'root', # Optional. Defaults to undef.
group => 'root', # Optional. Defaults to undef.
mode => '0644' # Optional. Defaults to undef.
order => 'numeric' # Optional. Set to 'numeric' or 'alpha'. Defaults to numeric.
replace => true # Optional. Boolean Value. Defaults to true.
backup => false # Optional. true, false, 'puppet', or a string. Defaults to 'puppet' for Filebucketing.
}
Limitations
Development
Types in this module release
##1.0.1 ( Apr 17, 2015 )
###Summary Bugfix release
####Features
####Bugfixes
- Fix windows support by not defaulting owner,group and mode values
####Changes
####Testing changes
####Known bugs
##1.0.0 ( Apr 09, 2015 )
###Summary Major release. The module has been moved from the ispavailability account on Forge to elecrical.
####Features
- Major refactoring to enhance functionality
- Re-use existing file resource to avoid code duplication
- Make the module more compatiable with puppetlabs-concat
- Support array of sources
####Bugfixes
####Changes
####Testing changes
- Add centos 7 acceptance testing
- Add tests for user/group/mode options
####Known bugs
##0.3.0 ( Mar 26, 2015 )
###Summary This release adds windows support to the library.
####Features
- Added windows support to the library.
####Bugfixes
####Changes
####Testing changes
####Known bugs
##0.2.1 ( Mar 25, 2015 )
###Summary Bugfix release
####Features
####Bugfixes
- Fix a bug caused by some refactoring
####Changes
####Testing changes
####Known bugs
- Windows is not supported yet
##0.2.0 ( Mar 25, 2015 )
###Summary With this release Ive done several code cleanups and added some basic tests. Also support for puppet-server has been fixed
####Features
####Bugfixes
- Remove unnecessary require which fixed support for puppet-server
####Changes
- Added some basic files
- Implemented rubocop for style checking
####Testing changes
- Implemented basic acceptance tests
####Known bugs
- Windows is not supported yet
##0.1.0 ( Jan 21, 2014 )
Rewrite of the fragment ordering part.
Fragments are now first ordered based on the order number and then on the resource name.
Convert order
parameter to string to support integer values when using Hiera/YAML ( PR#3 by Michael G. Noll )
##0.0.2 ( Mar 03, 2013 ) Adding source variable option to file_fragment type
##0.0.1 ( Jan 13, 2013 ) Initial release of the module
Copyright (c) 2013-2015 Richard Pijnenbug <richard@ispavailability.com> Copyright (c) 2012 Simon Effenberg <savar@schuldeigen.de> Copyright (c) 2012 Uwe Stuehler <uwe@bsdx.de> 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.