Version information
This version is compatible with:
- Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 4.7.0 < 6.0.0
- , , ,
Start using this module
Add this module to your Puppetfile:
mod 'womply-stdlib_aws', '0.3.1'
Learn more about managing modules with a PuppetfileDocumentation
stdlib_aws
Table of Contents
- Description
- Setup - The basics of getting started with stdlib_aws
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Description
stdlib_aws
is a helper module containing various Puppet extensions to assist with managing resources on AWS.
For now, the only think it contains is the function stdlib_aws::subnets_from_tag
, which takes a tag, optionally a tag value, and optionally a region (uses default region otherwise), and returns a list of subnet IDs for all AWS subnets tagged as described.
Setup
Setup Requirements
- Install AWS Ruby SDK into Puppet's Ruby on the master if it's not already present.
/opt/puppetlabs/puppet/bin/gem install aws-sdk
- Configure credentials for the gem in one of the usual ways.
Beginning with stdlib_aws
Use the functions! :D
Usage
This section is where you describe how to customize, configure, and do the fancy stuff with your module here. It's especially helpful if you include usage examples and code samples for doing things with your module.
Reference
Viewing Docs
NB: puppetmodule.info is updated hourly, so please be patient after a new release!
Building Docs
git clone https://github.com/womply/womply-stdlib_aws.git
cd womply-stdlib_aws
bundle install
puppet strings generate lib/puppet/functions
- Open
index.html
in thedocs/
subdirectory.
Limitations
None known.
Development
For now, just fork and make a PR!
Guidelines
- Functions should be in-DSL rather than with Ruby when possible. If you're not sure which to use...ask!
Release Notes/Contributors/Etc. Optional
Changelog
All notable changes to this project will be documented in this file.
Release 0.3.1
Bugfixes
- Fixed typo in subnets_from_tag codebase that causes failures when specifying a key and value for a tag.
Release 0.3.0
Features
- Added type Stdlib_aws::S3bucket to validate S3 bucket names.
- Added stdlib_aws::s3_bucket_to_arn function.
- Uses Stdlib_aws::S3bucket type to validate bucket names.
Release 0.2.1
Bugfixes
- Replaced entry in gemfile for
aws-sdk-core
with correct gem,aws-sdk
.
Release 0.2.0
Features
stdlib_aws::subnet_id_to_cidr
function. Retrieves a CIDR-notation address for a given AWS Subnet ID.
Release 0.0.2
Features
- Published to forge!
- Version bump for published release!
Release 0.0.1
Features
stdlib_aws::subnets_from_tag
function. Retrieves a list of AWS subnet IDs based on a supplied tag.
Bugfixes
Known Issues
No tests (yet).
Dependencies
- puppetlabs-stdlib (>= 4.13.1 < 5.0.0)