Ansible Role: amazon-ssm

This role provide a compliance for install amazon-ssm on your target host.

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

---
# defaults file for ansible-role-amazon-ssm

# Enable or disable sudo access for ssm-user on Linux instances
allow_sudo: true

# (Optional) Setup activation id, used with on-premise instances
activation_id:

# (Optional) Setup activation code, used with on-premise instances
activation_code:

# (Optional) Setup aws region, used with on-premise instances
aws_region:

# Configure SSM Agent to communicate through an https or/and https proxy
http_proxy_url:
https_proxy_url:

Dependencies

None.

Example Playbook

This is a sample playbook file for deploying the Ansible Galaxy role in a localhost and installing latest amazon-ssm version.

---
- hosts: localhost
  become: true
  roles:
    - role: diodonfrost.amazon_ssm

Remove sudo access to the ssm-user account on Linux instances

---
- hosts: localhost
  become: true
  roles:
    - role: diodonfrost.amazon_ssm
      vars:
        allow_sudo: false

Local Testing

This project uses Molecule to aid in the development and testing.

To develop or test you'll need to have installed the following:

Linux (e.g. Ubuntu)
Docker
Python (including python-pip)
Ansible
Molecule
Virtualbox (windows test only)
Vagrant (windows test only)

Testing with Docker

# Install requirements
pip install -r requirements-dev.txt

# Test role on CentOS 8
molecule test

# Test role on Ubuntu 20.04
image=ansible-ubuntu:20.04 molecule test

# Test role on Opensuse Leap
image=ansible-opensuse:leap molecule test

Testing with Virtualbox

# Test role on Windows
molecule test -s windows

# Test role on Macos
molecule test -s macos

License

Apache 2

Author Information

This role was created in 2019 by diodonfrost.

SD-1987 / ansible-role-amazon-ssm