Check last build on Travis-CI
Simple tool useful to define smart architectures on Amazon Web Service.
Answer is very simple, we prefer this tool to AWS client because :
- We do not want to maintain aws client, hiss versioning or BOTO libraries, and updating this project you will update to latest aws sdk
- We want an an accelerator do deploy faster AWS infrastructure.
- We do not want do strive our mind with aws client complex api
- We want ready build-in procedures to access services
- We want a tool easy to integrate with new features
- We are providing a plugin interface to develop different scenarios
- We want integrated AWS Architect features with AWS Developer operations
- We want to access AWS with simplified guided procedures and batch YAML scripts to deploy multiple complex architectures cross-region, maintaining versioning of cloud artifacts and stacks
Objectives
Project objectives are :
- Provide an AWS client agnostic application
- Define an Amazon Web Services accelerator
- Support complex CloudFormation operations
- Integrate multiple AWS services
- Flatten distance between DevOps and CloudFormation
- Create new operative system working in both DevOps, SysOps, and Architectures
- YAML batch language for architecture and multi-region stacks
- Plugin interface to fast develop new features or simply pull from repository new features, without any integration effort
Pre-requisites
You can use an AWS credentials file to specify your credentials. This is a special, INI-formatted file stored under your HOME directory, and is a good way to manage credentials for your development environment. The file should be placed at ~/.aws/credentials
, where ~
represents your HOME directory.
Using an AWS credentials file offers a few benefits:
Your projects' credentials are stored outside of your projects, so there is no chance of accidentally committing them into version control.
You can define and name multiple sets of credentials in one place.
You can easily reuse the same credentials between projects.
The format of the AWS credentials file should look something like the following:
[default]
aws_access_key_id = YOUR_AWS_ACCESS_KEY_ID
aws_secret_access_key = YOUR_AWS_SECRET_ACCESS_KEY
[project1]
aws_access_key_id = ANOTHER_AWS_ACCESS_KEY_ID
aws_secret_access_key = ANOTHER_AWS_SECRET_ACCESS_KEY
Each section (e.g., [default], [project1]), represents a separate credential profile. Profiles can be referenced from a SDK configuration flag, or when you are instantiating a client, using the profile option:
-profile <profile_name>
Install client
To install client use following command :
go get -u github.com/golang/dep/cmd/dep
go get -u github.com/hellgate75/aws-architect
dep ensure -update
Run command
To execute client use following command :
aws-architect
With this command you will have the list of available sub-commands. In case you want inspect sub-command sample usage you can execute following command :
aws-architect help <sub-command>
Some samples
Here a list of common used configuration file samples:
Issues
We track and improve code accordingly to plan and issues you create on project issues tracker at :
Issues Tracker
Thanks you for advertising us on library bugs or improvements.
License
LGPL-v3
Extra clauses :
- This software is not re-distributable for commercial use prior authors written authorization
- Extension of this library is prohibited without prior written authorization of authors
- Authors decline any responsibility on un-appropriate use of the library
- This software is covered by copyright rules, if you want know more write authors at hellgate75@gmail.com
- Authors will maintain this library on discontinuos periods of time, now blueprints or milestone are provided at the moment
- Users are not authorized for commercial use of library without a specific license from authors, and business packages for company LDAP/SAM integration
- This library is not delivered in Gopkg, because we identify in it a potential AWS integrated tool-set, in a future time