talkimhi / awless

A Mighty CLI for AWS

DevOps Assignment

CI/CD flow for AWLESS (open source)

Status:

About AWLESS

awless is a powerful, innovative and small surface command line interface (CLI) to manage Amazon Web Services.

awless stands out by providing the following features:

• small and hierarchical set of commands
• create and revert fully-fledged infrastructures through a new simple and powerful templating language
• local log of all your cloud modifications done through awless
• exploration of your cloud infrastructure and resources relations, even offline using a local graph storage
• greater output's readability with numerous machine and human friendly formats
• ensure smart defaults & security best practices
• connect easily using awless' smart SSH to your private & public instances

Demo

Note that the video above is in APNG and requires a recent browser.

Awards : Top 50 Developer Tools of 2017, InfoWorld Bossie Awards 2017

More information:

Take the tour at Getting Started (wiki). Or read the introductory blog post about awless.

More articles:

• Simplified user management for AWS
• InfoWorld: Production-grade deployment of WordPress
• Easy create & tear down of a multi-AZ CockroachDB cluster

DevOps Assignment // About

Assignment objectives were:

1. Choose and "containerize" an existing known open source project which doesn’t have a Docker repository.
2. build a CI/CD Flow for the project (must have some level of unit testing).

Tools / Online account(s) required to complete this assignment:

1. AWS Account
2. Github Account
3. Travis-CI Account
4. Ansible
5. Docker

CI/CD Implementation Guide

Follow this step-by-step tutorial to make your own awless CI/CD flow.

1. Launch an AWS EC2 Instance with SSM Agent and SSM IAM Role (How-to)

2. Install Docker and Ansible on the instance _{^{On Amazon Linux use the following commands :}} yum install git yum install docker pip uninstall ansible pip install ansible pip install docker-py service docker start

3. Fork the Awless git repository to your account

4. Link your Travis-CI account with your GitHub account.

5. Create IAM programmatic user with SSM run-command privileges.

6. Encrypt the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY vars into your TravisCI project.

7. Add your AWS_REGION and AWS_INSTANCE_ID vars to your TravisCI Project.

Your environment variables should look like this photo:

8. Commit and push changes to your Awless repository and check the flow.
9. Enjoy !@

Apache License

awless is an open source project created by Henri Binsztok, Quentin Bourgerie, Simon Caplette and François-Xavier Aguessy at WALLIX. awless is released under the Apache License and sponsored by Wallix.

Disclaimer: Awless allows for easy resource creation with your cloud provider;
we will not be responsible for any cloud costs incurred (even if you create a
million instances using awless templates).

Contributors are welcome! Please head to Contributing (wiki) to learn more. Note that awless uses triplestore another project developped at WALLIX.