ACdeploy (Automatic Container Deployment)
Keeping you cool during your deployments
Mission statement
The goal of ACDeploy is to enable one-step deployment of projects to staging & production environments with minimal configuration.
Sounds great, how does that work?
ACDeploy automatically detects the programming language of your project and creates a Docker container from a pre-defined build pack. This Docker container is pushed to one of the supported Cloud platforms.
Getting started
Step 1: install ACDeploy
npm install -g @remie/acdeploy
Step 2: Clone your project repository locally Step 3: Enabled ACDeploy for your project (be prepared to answer some questions)
acdeploy init
Step 4: Commit & push the generated config files Step 5: Watch your CI environment do the rest
Prerequisites (the fine print)
ACDeploy is specifically created for a workflow that uses version control, continuous integration and a cloud platform. At this point, the following tools are supported:
- Version control: GitHub
- Continuous integration: TravisCI, CircleCI
- Cloud platform: Amazon Web Services
To be able to use ACDeploy in your project, you should create a GitHub account and host your project there. Use your GitHub credentials to log into TravisCI and enable TravisCI for your project. Finally, create an AWS account (you will need the API credentials).
Oh, and there is a list of supported development languages (buildpacks):
- PHP
- NodeJS
- Maven
If you wish to also use ACDeploy for local development, you will need to install Docker CE locally. Oh, and ACDeploy is written in NodeJS, so you will need to install it locally for any of this to work.
ACDeploy configuration
If you run acdeploy init you will be asked some basic questions. To make this as easy as possible, ACDeploy will try to ask you as little information as possible, and will assume the rest. If you do not feel comfortable with those assumptions, or if you are curious what ACDeploy does, you can check the .acdeploy.yml file which will be added to your project after running acdeploy init.
Important note: the AWS section of the YML file is based on the AWS SDK for Javascript. If you wish to change that configuration, you can use the AWS documentation to check which properties you can add/remove