https://github.com/dgibbs64/ansible-role-amazon_ssm_agent
https://github.com/dgibbs64/ansible-role-amazon_ssm_agent
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dgibbs64/ansible-role-amazon_ssm_agent
- Owner: dgibbs64
- Created: 2024-09-24T09:34:36.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-28T13:38:31.000Z (3 months ago)
- Last Synced: 2025-03-19T14:49:32.812Z (about 2 months ago)
- Size: 68.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# amazon_ssm_agent
An [Ansible](https://www.ansible.com) role that ensures Amazon SSM Agent is installed on EC2 instances.
## About
Amazon SSM Agent is a management agent that can be installed on EC2 instances to enable AWS Systems Manager capabilities. This role will install or remove the Amazon SSM Agent.
> note: For Ubuntu AMI's, the Amazon SSM Agent is already installed by default. However this role will still ensure the agent is installed and running.
This role can only check if Amazon SSM Agent is installed and install it if not. Update functionality is handled by AWS Systems Manager. Amazon SSM Agent can be auto updated by enabling *Auto update SSM Agent* in `AWS Systems Manager > Fleet Manager > Settings > Agent auto update > Auto update SSM Agent`. Full guide found here.
This role uses amazon.aws.ec2_metadata_facts. Please ensure the EC2 metadata endpoint is setup on your control node.
## Requirements
Requires an AWS account to use the Amazon SSM features.
### Supported Distros
- AlmaLinux >= 8
- AmazonLinux 2023
- CentOS >= 8
- Debian >= 10
- Fedora >= 39
- OracleLinux >= 8
- Redhat Enterprise Linux >= 8
- Rocky Linux >= 8
- Ubuntu >= 20.04
## Role Variables
By default, this role will install the Amazon SSM Agent if not already installed.
To customize the configuration, you can set the following variables:
```yaml
# Agent state present|absent
amazon_ssm_agent_state: "present"
# Force install of SSM Agent
amazon_ssm_agent_force_install: false
```
## Dependencies
```yaml
community.general
amazon.aws
```
## Example Playbook
```yaml
---
- name: Netdata
hosts: all
roles:
- dgibbs64.amazon_ssm_agent
```
## License
MIT
## Author Information
- [Daniel Gibbs](https://danielgibbs.co.uk)