(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
$ npm install -g @asymmetrik/yadda
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 create-deployment-center --region <AWS_REGION> <DEPLOYMENT_CENTER_NAME>
<AWS_REGION> with the region you want the deployment center
installed in and
<DEPLOYMENT_CENTER_NAME> with the name you want to give this
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
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
The schema for the Manifest files can be found under
Deploying your application
After creating your Deployment Center and Manifest, you can deploy the application via
$ yadda deploy <environment>
<environment> with the name of the environment you want to deploy to
yadda deploy staging to deploy to the environment defined in
After your Deployment Center is created you can optionally create a secret center which your containers can leverage for encrypted secrets. See Yadda-Secret for the server package.
To create the Secret Center you can run
$ yadda create-secret-center <env>
The command will create a secret center in the same region as your environments deployment center. You can then access the secrets with
$ yadda secret <env> <action> <key> [value]