Ansible角色: christiangda.amazon_ssm_agent

此角色用于安装AWS系统管理代理

功能:

• 从AWS发行包下载并安装AWS系统管理代理
• 轮转代理日志文件

要求

此角色适用于RedHat、CentOS、Amazon Linux、Debian和Ubuntu发行版

• RedHat
  • 6
  • 7
  • 8
• CentOS
  • 6
  • 7
  • 8
• Amazon Linux
  • 1
  • 2
• Ubuntu
  • 16.*
  • 18.*
• Debian
  • jessie
  • sid
  • stretch

要查看Python与Ansible的兼容性矩阵，请参见项目Travis-CI构建矩阵

角色变量

# 可能的值:
# - true
# - false
# 默认值: false
# 注意:
# * 当您想要更新已安装版本时，请将值设置为true
ssm_update: false

依赖

无

示例剧本

RedHat/CentOS、Ubuntu和Debian

- hosts: servers
    gather_facts: True
    roles:
        - role: christiangda.amazon_ssm_agent
            vars:
                ssm_update: true

Amazon Linux 1/2 (my-playbook.yml)

- hosts: all
    gather_facts: True
    become: true
    become_user: root
    become_method: sudo
    remote_user: ec2-user
    roles:
        - role: christiangda.amazon_ssm_agent

清单文件示例 (inventory)

[all]
10.14.x.y
10.14.v.z

[amazon-1]
10.14.x.y

[amazon-2]
10.14.v.z

如何使用

ansible-playbook my-playbook.yml \
    --inventory inventory \
    --private-key [~/location of my key.pem] \
    --become \
    --become-user=ec2-user \
    --user ec2-user

开发 / 贡献

此角色使用Molecule进行测试，并使用 Python虚拟环境进行开发

准备您的环境

Python 3

mkdir ansible-roles
cd ansible-roles/

python3 -m venv venv
source venv/bin/activate
pip install pip --upgrade
pip install ansible
pip install molecule">=2.22rc1"
pip install molecule[vagrant]
pip install selinux
pip install docker
pip install pytest
pip install pytest-mock
pip install pylint
pip install rope
pip install autopep8
pip install yamllint
pip install flake8

Python 2.7

依赖

sudo dnf install redhat-rpm-config
sudo dnf install python-devel
sudo dnf install libselinux-python

mkdir ansible-roles
cd ansible-roles/

python2.7 -m virtualenv venv
source venv/bin/activate
pip install pip --upgrade
pip install ansible
pip install molecule">=2.22rc1"
pip install molecule[vagrant]
pip install selinux
pip install docker
pip install pytest
pip install pytest-mock
pip install pylint
pip install rope
pip install autopep8
pip install yamllint
pip install flake8

克隆角色仓库并创建符号链接

git clone https://github.com/christiangda/ansible-role-amazon-ssm-agent.git
ln -s ansible-role-amazon-ssm-agent christiangda.amazon_ssm_agent
cd christiangda.amazon_ssm_agent

执行测试

在本地使用docker

molecule test [--scenario-name default]

在本地使用vagrant

molecule create --scenario-name vagrant
molecule converge --scenario-name vagrant
molecule verify --scenario-name vagrant

或

molecule test --scenario-name vagrant

另外，如果您想使用虚拟机进行测试，我有一个非常不错的ansible-playground项目，使用Vagrant和VirtualBox，欢迎尝试！

许可证

此模块根据GNU通用公共许可证第3版发布:

• http://www.gnu.org/licenses/gpl-3.0-standalone.html

作者信息

• Christian González Di Antonio