Ansible Role: amazon-ssm

This role helps you install amazon-ssm on your target machine.

Requirements

None.

Role Variables

Here are the available settings you can change, along with their default values (look in defaults/main.yml):

---
# default settings for ansible-role-amazon-ssm

# Allow or disallow sudo access for ssm-user on Linux systems
allow_sudo: true

# (Optional) Set activation id for on-premise instances
activation_id:

# (Optional) Set activation code for on-premise instances
activation_code:

# (Optional) Set AWS region for on-premise instances
aws_region:

# Set SSM Agent to work through an HTTP or HTTPS proxy
http_proxy_url:
https_proxy_url:

Dependencies

None.

Example Playbook

This is an example playbook for using the Ansible Galaxy role on your localhost to install the latest version of amazon-ssm.

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

To remove sudo access for the ssm-user account on Linux systems:

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

Local Testing

This project uses Molecule to help with development and testing.

To develop or test, you need to have these installed:

• Linux (like Ubuntu)
• Docker
• Python (including python-pip)
• Ansible
• Molecule
• Virtualbox (only for Windows testing)
• Vagrant (only for Windows testing)

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 by diodonfrost in 2019.