chrisfu / puppet-amazon-ssm-agent

Puppet Module to download and Amazon System Management Agent

Puppet Amazon SSM Agent

Table of Contents

1. Description
2. Setup - The basics of getting started with amazon_ssm_agent
   • Beginning with amazon_ssm_agent
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Description

Download and install Amazon System Management Agent, i.e., amazon-ssm-agent package.

Setup

Beginning with amazaon_ssm_agent -- Installation

put the following line in your Puppetfile

mod 'shinesolutions/amazon_ssm_agent', :git => 'https://github.com/shinesolutions/amazon_ssm_agent.git'

Usage

For the simplest scenario, the following will download and install the latest package:

include amazon_ssm_agent

or specifying an AWS Region that is closest to you:

class {'amazon_ssm_agent':
  region => 'ap-southeast-2',
}

When the ssm agent has to communicate with Amazon EC2 System Manager Service via a proxy.

class {'amazon_ssm_agent':
  region     => 'ap-southeast-2',
  proxy_host => 'proxy.shinesolutions.com',
  proxy_port => '443'
}

Reference

Public classes

amazon_ssm_agent

Limitations

The module is still under active development and test. Currently there are no plan to support platforms other than Amazon Linux, RedHat, CentOS, and Ubuntu.