Dpl (dee-pee-ell) is a deploy tool made for continuous deployment. Developed and used by Travis CI.

Dpl supports the following providers:

• AppFog
• Cloud Foundry
• cloudControl
• dotCloud (experimental)
• Engine Yard
• Heroku
• Nodejitsu
• NPM
• Openshift
• PyPi
• RubyGems
• S3

Dpl is published to rubygems.

• Dpl requires ruby with a version greater than 1.8.7
• To install: gem install dpl

###Security Warning:

Running dpl in a terminal that saves history is insecure as your password/api key will be saved as plain text by it.

###Global Flags

• --provider=<provider> sets the provider you want to deploy to. Every provider has slightly different flags, which are documented in the section about your provider following.
• Dpl will deploy by default from the latest commit. Use the --skip_cleanup flag to deploy from the current file state. Note that many providers deploy by git and could ignore this option.

• api-key: Heroku API Key
• strategy[git/anvil]: Deployment strategy for Dpl. Defaults to anvil.
• app: Heroku app name. Defaults to the name of your git repo.
• username: heroku username. Not necessary if api-key is used. Requires git strategy.
• password: heroku password. Not necessary if api-key is used. Requires git strategy.

• Anvil will run the buildpack compilation step on the Travis CI VM, whereas the Git strategy will run it on a Heroku dyno, which provides the same environment the application will then run under and might be slightly faster.
• The Git strategy allows using user and password instead of api-key.
• When using Git, Heroku might send you an email for every deploy, as it adds a temporary SSH key to your account.

As a rule of thumb, you should switch to the Git strategy if you run into issues with Anvil or if you're using the user-env-compile plugin.

dpl --provider=heroku --api-key=`heroku auth:token`
dpl --provider=heroku --strategy=git --username=<username> --password=<password>  --app=<application>

• username: Nodejitsu Username
• api-key: Nodejitsu API Key

dpl --provider=nodejitsu --username=<username> --api-key=<api-key>

• api-key: Engine Yard Api Key
• username: Engine Yard username. Not necessary if api-key is used. Requires git strategy.
• password: Engine Yard password. Not necessary if api-key is used.
• app: Engine Yard Application name. Defaults to git repo's name.
• environment: Engine Yard Application Environment. Optional.
• migrate: Engine Yard migration commands. Optional.

dpl --provider=engineyard --api-key=<api-key>
dpl --provider=engineyard --username=<username> --password=<password> --environment=staging
dpl --provider=engineyard --api-key=<api-key> --app=<application> --migrate=`rake db:migrate`

• username: Openshift Username.
• password: Openshift Password.
• domain: Openshift Application Domain.
• app: Openshift Application. Defaults to git repo's name.

####Examples:

dpl --provider=openshift --username=<username> --password=<password> --domain=<domain>
dpl --provider=openshift --username=<username> --password=<password> --domain=<domain> --app=<app>

• email: cloudControll email.
• password: cloudControll password.
• deployment: cloudControll Deployment. Follows the format "APP_NAME/DEP_NAME".

dpl --provider=cloudcontroll --email=<email> --password<password> --deployment=`APP_NAME/DEP_NAME`

• api-key: Rubygems Api Key.

dpl --provider=rubygems --api-key=<api-key>

• user: PyPI Username.
• password: PyPI Password.
• server: Optional. Only required if you want to release to a different index. Follows the form of "https://mypackageindex.com/index".

dpl --provider=pypi --user=<username> --password=<password>
dpl --provider=pypi --user=<username> --password=<password> --server=`https://mypackageindex.com/index`

• email: NPM email.
• api-key: NPM api key. Can be retrieved from your ~/.npmrc file.

dpl --provider=npm --email=<email> --api-key=<api-key>

• access-key-id: AWS Access Key ID. Can be obtained from here.
• secret-access-key: AWS Secret Key. Can be obtained from here.
• bucket: S3 Bucket.

dpl --provider=s3 --access-key-id=<access-key-id> --secret-access-key=<secret-access-key> --bucket=<bucket>

• email: Appfog Email.
• password: Appfog Password.
• app: Appfog App. Defaults to git repo's name.

dpl --provider=appfog --email=<email> --password=<password>
dpl --provider=appfog --email=<email> --password=<password> --app=<app>