Define the services for your application in
Cordagefile.coffee and then deploy them
using the command-line tool.
fleetctl commands behind the scenes and removes the need of writing systemd
configuration files, as they are generated automatically when you deploy. Cordage makes it easy
to add additional units for a service, making it easy to scale your application when necessary.
Cordage runs locally on your machine, meaning there is no complicated software to install on your servers. If you're already using CoreOS, then you can get started straight away.
- Deploy multiple units/instances of a service easily
- Configure your services so there is only one unit for that service per host
- Automatically detects updates to docker images on deployment
- View your deployed services and units
- Destroy a specific service and/or a specific version of a service
$ npm install -g cordage
Cordage uses a simple file called
Cordagefile.coffee which should live in the root
of your project repository. This file will define what services will run across your
Here is an example
= ->@service 'app'description: 'Application Server'image: 'nginx'rules:onePerHost: true
Please note that Cordage is still early days. The configuration format is likely to change significantly in the future and several more options will be added.
Cordage is just running
fleetctl commands behind the scenes, so as long as you
fleetctl commands successfully against your cluster,
Cordage should work just fine.
See all available Cordage commands
Once you have configured your services in
Cordagefile.coffee, you can deploy
them to your cluster. Cordage will automatically detect new versions of your service
docker images, making it easy to deploy a new version of your application.
Build and deploy your services across the cluster
$ cordage deploy
Listing services and running units
To check that your deployment went smoothly, you can run the list command to view all of your services and any running units (containers) for each one.
List services and units
$ cordage list
If you want to shutdown and destroy all units for a particular service, then you can use the destroy command.
Destroy all units for a particular service
$ cordage destroy app
Destroy all units for a specific version of a service
$ cordage destroy app:12.04
Licensed under the MIT License.
View the full license here.