This version is compatible with:
- Puppet Enterprise >=3.4.3
- Puppet >=3.4.3
Start using this module
####Table of Contents
- Module Description - What YAML importer for Connect does and why it is useful
- Setup - The basics of getting started with the YAML importer for Connect
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Connect is a replacement for YAML in hiera when using Puppet. Connect allows you to assign, manipulate and reference data. It also allows you to import data items from external sources. The code to import this data is called a datasource.
This module contains the data source for reading YAML files into Connect. Although Connect, is build to get away from YAML, sometimes it is useful to be able to read and use the contents of a YAML file. This module allows you to do so.
Here is an example reading a YAML file.
import from yaml('/aaa/a.yaml') do variable1 = 'key1' variable2 = 'yaml::key2' end
In this example we are opening the file
/aaa/a.yaml, and reading the keys
yaml::Key2 . In the rest of the Connect configuration, you can use the variables as
###Installing the module
To use the YAML datasource module, you first have to make sure it is installed.
puppet module install hajee/connect_yaml
If you are using a Puppetfile, you need the following lines:
No additional actions are required. Connect searches for available data sources when staring. So when this data source is installed, it is usable instantaneous.
###What connect_yaml affects
connect_yaml affects no other modules then only Connect.
A requirement for
connect_yaml is the [Connect]](https://github.com/hajee/connect), module. This requirement is specified in the module metadata so you don’t have to manage it yourself.
###Beginning with connect YAML module
Check the Connect Language, in a Nutshell, for more intro into the language.
--debug option to puppet to see what is happening
This module is tested CentOS and Redhat. It will probably work on other Linux distributions.
This is an open source project, and contributions are welcome.
Currently we have tested:
- CentOS 5
- Redhat 5
Make sure you have:
Install the necessary gems:
And run the tests from the root of the source code:
We are currently working on getting the acceptance test running as well.
- hajee/connect (>= 0.0.9 < 0.1.0)