config-file.md

Configuration File

hubot-deploy looks for an apps.json file in the root of your deployed hubot to map names to specific repos that should be deployed. Here's what the format looks like.

It's a javascript object where application aliases are used as the names(keys). This allows you to easily reference projects even if the repository name is long, hard to type, or easy to forget. The object itself tells GitHub enough information for deployment systems to handle the who(name), what(repository), where(environment), and how(provider).

Common Attributes
provider	Either 'heroku' or 'capistrano'. Required
repository	The name with owner path to a repo on github. e.g. "atmos/heaven". Required
environments	An array of environments that you can deploy to. Default: "production"
required_contexts	An array of commit status context names to verify against.
github_api	A String with the full URL to the API. Useful for enterprise installs. Default: "https://api.github.com"
github_token	A token for creating deployments in the GitHub API specific to the specific repository.
allowed_rooms	An array of room id's for restricting the deployments to be started only in those rooms.

Any extra parameters will be passed along to GitHub in the payload field. This should allow for a decent amount of customization.

{
  "hubot": {
    "provider": "heroku",
    "auto_merge": false,
    "repository": "MyOrg/my-org-hubot",
    "environments": ["production"],

    "heroku_production_name": "my-orgs-hubot"
  },

  "dotcom": {
    "provider": "heroku",
    "repository": "MyOrg/www",
    "environments": ["production","staging"],
    "required_contexts": ["ci/janky", "security/brakeman"],

    "heroku_staging_name": "my-org-www-staging",
    "heroku_production_name": "my-org-www"
  }
}

Providers

Heroku

There's another plugin for hubot called hubot-deploy-heroku.

Deprecated GitHub Services

GitHub has service integrations for Heroku and OpsWorks. This allows you to get deployment support without having to setup an service of your own.

Heroku

GitHub provides a repo integration for deploying to heroku. Docs.

Provider Attributes
heroku__name	The name of the heroku app to push to. Multiple environments are available with things like 'heroku_production_name' and 'heroku_staging_name'.

OpsWorks

There's also a repo integration for deploying to Aws OpsWorks. OpsWorks supports multi-environment deployments by specifying different stack and app ids. Docs.

Supported Heaven Services

There is also heaven which exists if you need to write your own custom stuff or don't want to share your keys with GitHub. This requires you to stand up your own service, but deploys to heroku relatively easily.