copy-heroku-releases
A node command line utility to copy Heroku slugs from one app to one or more other apps
This is valuable when you want the same code in different Heroku apps to partition your system (for example by country)
For details of the Heroku platform API see
Getting Started
Install the command line utility with: npm install -g copy-heroku-releases
You must have an account on Heroku
Documentation
This program will deploy a slug from one application to one or more others. You must own these apps.
The default is to copy the most recent (highest) release
The program accepts its parameters from the environment rather than the command line.
Environment variables
Mandatory parameters
The source application name: DEPLOY_SOURCE_APPLICATION
The Heroku API key for your account: DEPLOY_HEROKU_API_TOKEN
The target organisation: DEPLOY_TARGET_ORGANISATION
The list of target apps: DEPLOY_TARGET_APP_FILTER
Note: the target apps can be a list of regular app names or a list of regexes or a mix of both
Optional parameters
You can run a rehearsal of the deployment by setting DEPLOY_REHEARSAL to true. This will list the action that the program would take but prevents execution.
You can request an explicit release setting DEPLOY_RELEASE_NUMBER. This will use the specific release rather than the latest.
You can obtain a DEBUG trace by setting DEPLOY_DEBUG to true
Errors
Some releases don't have slugs and this is reported as an error
If the requested release number is not present this is reported as an error
Examples
$ copy-heroku-releases
Source app: bamboo-test-deploy-app source version: 27 ('Rollback to v25') source slug: 4bd9fcde-c6b0-499d-9029
Copied slug 4bd9fcde-c6b0-499d-9029 to app test-deploy-xyz [created new app version 36]
Copied slug 4bd9fcde-c6b0-499d-9029 to app test-deploy-xyz [created new app version 35]
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
0.8.5 - added DEBUG option 0.8.4 - use promises and JSHint conformance 0.8.3 - hack to support deploying apps by organisation 0.8.2 - relies on the updated Heroku client now ... and I have more TODOs! 0.8.1 - realised that it wasn't fully functional ... proxy patch 0.8.0 - fully functional for me ... not 1.0.0 as I haven't socialised this enough yet :)
License
Copyright (c) 2014 Ray McDermott
Licensed under the MIT license.