Go Other
Permalink
Failed to load latest commit information.
_layouts Listing container instances Jun 20, 2017
aws Include Region ID in the graph to enable to show a whole region. Aug 16, 2017
cloud Include Region ID in the graph to enable to show a whole region. Aug 16, 2017
commands Reverse sorting when listing with flag `--reverse` Aug 17, 2017
config After release version bump Aug 17, 2017
console Reverse sorting when listing with flag `--reverse` Aug 17, 2017
database Serializing tpl with context: source/fillers/locale May 23, 2017
fetch Removing unneeded resources in Fetchers cache Jul 28, 2017
gen/aws Sync performance: better CPU / mem. See below: Aug 7, 2017
graph Better error message when property unmarshalling failure Aug 17, 2017
inspect gofmt minor changes May 31, 2017
logger Loggers are now sent to the stderr file descriptor Apr 7, 2017
smoke_tests Driver: update LB target group and target group attributes Jul 3, 2017
ssh SSH through fifixed and finished Aug 4, 2017
sync Re-design fetchers: independant of cloud logic, Jul 28, 2017
template Issue #120 - include profile in template execution Jul 13, 2017
vendor Dep: pointing towards awless-scheduler v0.0.6 Aug 18, 2017
web Re-design fetchers: independant of cloud logic, Jul 28, 2017
.gitignore Sync profiling with enabling flag on sync command Jul 28, 2017
.travis.yml Marshal infra to full RDF, rather than RDF+Json. Apr 6, 2017
CHANGELOG.md Bumping CHANGELOG Aug 17, 2017
CNAME Create CNAME Mar 13, 2017
Gopkg.lock Dep: pointing towards awless-scheduler v0.0.6 Aug 18, 2017
Gopkg.toml Dep: pointing towards awless-scheduler v0.0.6 Aug 18, 2017
LICENSE Add Apache license Feb 10, 2017
README.md Update README.md Jun 1, 2017
_config.yml Set theme jekyll-theme-cayman Mar 13, 2017
getawless.sh awless binaries: prefer tar.gz for linux build Jun 22, 2017
main.go Remove save history and error local storage May 17, 2017
release.go awless binaries: prefer tar.gz for linux build Jun 22, 2017

README.md

Build Status Go Report Card

awless is a fast, powerful and easy-to-use command line interface (CLI) to manage Amazon Web Services.

Twitter | Wiki | Changelog

Why awless

awless will help you achieve your goals without leaving your terminal:

  • run frequent actions by using simple commands
  • get nice and readable output (for humans) that machine know how to parse too
  • explore and query your infrastructure and cloud resources, even offline
  • ensure smart defaults & security best practices
  • write and run powerful templates (see awless templates (wiki))
  • connect to your instances easily

Install

Choose one of the following options:

  1. On macOS, use homebrew: brew tap wallix/awless; brew install awless
  2. With curl (macOS/Linux), run: curl https://raw.githubusercontent.com/wallix/awless/master/getawless.sh | bash
  3. Download the latest awless binaries (Windows/Linux/macOS) from Github
  4. If you have Golang already installed, install from the source with: go get -u github.com/wallix/awless

Main Features

video of a few awless commands
Note that this video is in APNG. On Chrome, you need an extension to view it.

  • Clear and easy listing of multi-region cloud resources (subnets, instances, users, buckets, records, etc.) on AWS EC2, IAM, S3, RDS, AutoScaling, SNS, SQS, Route53, CloudWatch, CloudFormation and Lambda: awless list
  • Output formats either human (Markdown-compatible tables, trees) or machine readable (csv, tsv, json, ...): --format
  • Listing can be filtered via resource properties or resources tags: --filter property=val, --tag Key=Value
  • Explore a resource given only an id, name or arn (properties, relations, dependencies, ...): awless show
  • Creation, update and deletion (CRUD) of cloud resources and complex infrastructure with smart defaults and sound autocomplete through powerful awless templates: awless run my-awless-templates/create_my_infra.txt
  • Powerful CRUD CLI one-liner (integrated in the awless templating engine) with: awless create instance ..., awless create vpc ..., awless attach policy ...
  • Leveraging AWS userdata to provision instance on creation from remote (i.e http) or local scripts: awless create instance userdata=http://...
  • Easy reporting of all the CLI template executions: awless log
  • Revert of executed templates and resources creation: awless revert
  • Clean and simple ssh to instances: awless ssh
  • Resolve public images dynamically (i.e. independant of the region specific AMI id): awless search images canonical:ubuntu:xenial --id-only
  • Aliasing of resources through their natural name so you don't have to always use cryptic ids that are impossible to remember
  • Inspectors are small CLI utilities to run analysis on your cloud resources graphs: awless inspect
  • Manual sync mode to fetch & store resources locally. Then query & inspect your cloud offline: awless sync
  • CLI autocompletion for Unix/Linux's bash and zsh awless completion

Getting started

Take the tour at Getting Started (wiki).

Or read the introductory blog post about awless.

About

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.