CloudFoundry Deployment

This page documents deployments using dpl v1 which currently is the default version. The next major version dpl v2 will be released soon, and we recommend starting to use it. Please see our blog post for details. dpl v2 documentation can be found here.

You now have the amazing ability to deploy directly to CloudFoundry after a successful build on Travis CI.

The Easy Way #

Go grab the Travis gem from GitHub and run this command:

travis setup cloudfoundry

You will be asked to answer a few simple questions about your CloudFoundry setup, and Travis will take care of the rest!

The Slightly Harder Way #

So you want to write your own .travis.yml, fine. Here is the minimum required to get up and running:

 deploy:
   provider: cloudfoundry
   username: hulk_hogan@example.com
   password: supersecretpassword
   api: https://api.run.pivotal.io
   organization: myawesomeorganization
   space: staging
   manifest: manifest-staging.yml       # (optional)  Defaults to manifest.yml.
   app_name: My app name                # (optional)

Make sure that you encrypt your password before pushing your updated .travis.yml to GitHub.

You can do this using the Travis gem above and running:

travis encrypt --add deploy.password

If your password includes symbols (such as braces, parentheses, backslashes, and pipe symbols), you must escape those symbols before running travis encrypt.

Conditional releases #

You can deploy only when certain conditions are met. See Conditional Releases with on:.