Do you deploy to AWS Elastic Beanstalk? Do you need to run application in multiple environments? If both answers are yes, read on.

This is a starting point repository for web application. You can use the included scripts to customize application building and AWS deployment processes. You are required to have some knowledge of AWS and bash scripting to be able to configure and add on your custom code, however I have made this boilerplate really simple and easy to understand.

Included scripts automate tasks below for you:

• Create or update an application in AWS
• Create or update an Elastic Beanstalk environment base on your GIT branch
• Archive application files in S3, also purges old files after configurable days
• Seamlessly deploy your production(master branch) code to EBS without downtime. See AWS Blue/Green deployment and beware of the DNS caveat noted in the documentation.

You're required to:

• Add your own web content
• Add on your own custom logics for application building. For examples, you might need to move files around or configure database credentials
• Modify deployment processes to fit your needs

In this demo, I created a new application with 3 environments in AWS Elastic Beanstalk using commands only.

Click here to see a high resolution video of the demo.

• master This is the branch you want to start fresh
• wordpress This is the branch I experiment with Wordpress
• beta This is the branch I commit and test features

• Install awscli, jq, gdate (macOS only) and configure awscli. See installation instructions below
• Change these values in aws.sh: APP_NAME, SECURITY_GROUP, EC2_KEY_NAME and S3_BUCKET. See value descriptions below
• Run ./aws.sh deploy

apt-get install awcli

brew install awcli

For installation instructions, go to http://docs.aws.amazon.com/cli/latest/userguide/installing.html.

$ aws configure
AWS Access Key ID [None]: [YOUR ACCESS KEY ID]
AWS Secret Access Key [None]: [YOUR SECRET ACCESS KEY]
Default region name [None]: us-east-1
Default output format [None]: json

For configuration instructions, go to http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html.

jq is used to parse JSON data in bash.

apt-get install jq

brew install jq

gdate is an GNU verion of date for macOS

brew install coreutils

Put all your web content inside /public_html. Content will get served by web server of the stack of your choice. As long as the web server supports, you can have a PHP, ASP.net or completely static site.

You might also have a seaprate process that builds the content in the directory. For example: Webpack build of a React application.

Whatever and however you want to put the content there, it's up to you.

You can further configure a Elastic Beanstalk envionrment using the configuration files in .ebextensions directory.

For more details, go to http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/ebextensions.html.

Below are the variables you can customize in aws.sh.

This command deploys current branch to a Elastic Beanstalk environment.

If application doesn't exists, it creates the application. If environment doesn't exist, it creates the environment. If environment exists, it updates the environment.

This command terminates the environment of current branch.

This command terminates the application and also terminates all of its environments.

Example: ./delete-s3.sh "s3://mys3bucket/apps/my-app/master" "7 days"

This return a list of most current stacks available in AWS.

• Ubuntu 16 LTS
• macOS High Serria

MIT - See included LICENSE.md