ansible-aws

Ansible Role AWS cli

Build Status

Ansible role which installs and configure the AWS cli by Python pip.

Requirements

None

Dependencies

Role Variables

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

aws_cli_name: awscli
aws_cli_version: 1.15.40

Name and version of the AWS cli package to be installed.

aws_cli_users: {}

This dictionary will configure the .aws/credentials file for each defined user. It accepts the following parameters:

  • username - the user name (Required);
  • group - The creds file's group, if not defined it will use the username as default group;
  • access_key - AWS Access Key ID; and
  • secret_key - AWS Secret Access Key.
aws_cli_config: {}

This dictionary will configure the .aws/config file for each defined user. It accepts the following parameters:

  • output - The aws cli's output format; and
  • region - The AWS region.

Test Kitchen

Install Deps

$ bundle

VMs

This kitchen configuration comes with different docker containers:

  • ubuntu-16.04
  • ubuntu-14.04
  • centos-7
  • fedora-26
  • fedora-25
  • fedora-24
  • debian-8

If you want to test the role using all of those machines, just run the commands below as they are. If you want to test the role on one system only, append to the commands below the VM name.

e.g.

$ bundle exec kitchen converge centos7

To converge the centos7 VM only.

Create the containers

$ bundle exec kitchen create

Converge your role

$ bundle exec kitchen converge

Run serverspec tests

$ bundle exec kitchen verify

Destroy the containers

$ bundle exec kitchen destroy

Run Create/Converge/Verify/Destroy in one command

$ bundle exec kitchen test

Write your tests

You can write your own test by adding a new file or editing the existing one living in the test/integration/aws/serverspec/localhost directory. More info about how to write serverspec test can be found here.

Example Playbook

    - hosts: all
      roles:
         - { role: darkraiden.ansible-aws_cli }

License

BSD

Author Information

This role was created in 2017 by Davide Di Mauro.

About

Install the AWS cli via Python pip

Install
ansible-galaxy install darkraiden/ansible-role-aws_pip
GitHub repository
License
Unknown
Downloads
128
Owner
Father, husband, tech geek and coder. DevOps Engineer at Microsoft