(Yet Another Docker Deployment Application)
yadda
is a command line tool for managing deploying a collection of
microservices to AWS EC2 Container Service using a declarative syntax. Create a
Manifest file (and associated environment files) declaring your services and
jobs (one-time or periodic task), and yadda
will handle building the required
docker images, pushing them to your AWS Elastic Container Registry, creating
the associated services and task definitions in ECS, and running periodic tasks
on a schedule.
Warning: Use of yadda will result in creating resources in AWS for which you bear the cost.
yadda
is installable via npm under the asymmetrik
namespace.
$ npm install -g @asymmetrik/yadda
To operate, yadda
first must install a deployment center that handles the
deployment history of your application (enabling the rollback
feature) and
is responsible for running the jobs defined in your Manifest files.
To create the deployment center, run the following after installing yadda
$ yadda create-deployment-center --region <AWS_REGION> <DEPLOYMENT_CENTER_NAME>
replacing <AWS_REGION>
with the region you want the deployment center
installed in and <DEPLOYMENT_CENTER_NAME>
with the name you want to give this
deployment center.
A single deployment center can be used to manage deployments across multiple AWS Regions (including managing deployments on ECS clusters outside of the region where the Deployment Center is installed).
Additionally, a single deployment center can handle managing multiple different applications.
yadda
needs certain information to manage the deployments. This information is
stored in a Manifest file for a given App and specific environment files for
each deployment environment.
yadda
expects these files to be within the root directory of your App,
inside a folder named deployment
. An example folder structure is provided
below.
MyApp
|- deployment
|- Manifest.js
|- env
|- production.js
|- staging.js
|- dev.js
To create a skeleton for the required files, run
$ yadda init
which will create the deployment folder and skeleton files in the current working directory.
You can find an full example under the example
directory in this
repo. The example files will show the required information for configuring your
application.
The schema for the Manifest files can be found under /config/manifest.js
.
After creating your Deployment Center and Manifest, you can deploy the application via
$ yadda deploy <environment>
replacing <environment>
with the name of the environment you want to deploy to
(for example, yadda deploy staging
to deploy to the environment defined in
deployment/env/staging.js
).