lucified/hubot-deploy-status

Name: hubot-deploy-status

Owner: Lucify

Description: Check deployment statuses from GitHub and run alerts if environments are out of sync

Forked from: flowdock/hubot-deploy-status

Created: 2016-10-31 14:21:21.0

Updated: 2016-12-01 20:29:44.0

Pushed: 2015-10-22 08:45:06.0

Homepage:

Size: 324

Language: CoffeeScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

hubot-deploy-status

Check deployment statuses from GitHub. Tries to use same data and configs that's available for hubot-deploy. Reads app config from apps.json and uses HUBOT_GITHUB_TOKEN or a user's personal deploy token (see hubot-deploy) if that's available to make api requests.

The script will fetch the latest deployment for an app (in specified environment) and display its status compared to the master (repo default) branch.

The script will also allow automatic cron-like deployment status checks, so your hubot can be configured to notify you if some environment for an app is not up to date (for example one component hasn't been deployed to production).

Tokens

Please not that to work, the GitHub tokens used must have user,repo oauth scopes. hubot-deploy requires only repo_deployment scope but that's not enough for this script.

Usage

For app that's configured with name example-app and has environments staging and production, you can say

t deploy-status for example-app in staging

and the response will be something like

t:

example is 4 commits ahead master in staging.
deployed ref is deploy-with-heaven (e429769).

its not in master:
69b Mumakil  Bump version
b1a Mumakil  Create a separate group for deploy gems
aae Mumakil  Use capistrano-flowdock for deploy notifications
769 Mumakil  Use double quotes in gemfile

To check which apps and envs can be queried:

t deploy-status

To toggle / turn on / turn on / check status of configured automatic checks

at apps and envs are automatically checked
t deploy-status:auto

rn all checks off
t deploy-status:auto off

ggle specific environment
t deploy-status:auto toggle app1 in production

rn on all environments for an app
t deploy-status:auto on for app1

Automatic checks and adapters

It's possible to use a different adapters to handle the automatic status check posting. Currently by default the script will post fairly simple messages to chat. Another option if you're a Flowdock user is to use Flowdock adapter.

TL;DR Supported adapters at the moment are default and flowdock.

Configuration

In general, the script will need HUBOT_GITHUB_TOKEN, which you will probably already have if your hubot interacts with github. If you want to have full functionality, the token must have user,repo oauth scopes.

The following environment variables can be set and will be used as defaults, but individual apps can override the settings. Examples included:

OY_STATUS_TIMEZONE=Europe/Helsinki
OY_STATUS_ROOM=acdcabbacd0123456789
OY_STATUS_ADAPTER=flowdock

Flowdock adapter supports additional:

OY_STATUS_SOURCE_TOKEN=9559e07bea935d55657bfdcb8d2b9c2c
OY_STATUS_AUTHOR_NAME=Hubot
OY_STATUS_AUTHOR_AVATAR=http://www.example.com/avatar.jpg

Then, in apps.json, you can configure the automatic status using cron-like syntax:

// A simple case with just production environment.
// Check the status once every work day at 8am and post
// results to the default chat room in env DEPLOY_STATUS_ROOM.
"example1": {
    "provider": "heroku",
    "repository": "acme/example1",
    "check_deploy_status": {
        "environments": {
            "production": "0 0 8 * * 1-5"
        }
    }
},
// A little more complex example with multiple environments.
// Checks production every workday at 8am and staging environment every
// two hours overriding adapter and room.
"example2": {
    "provider": "bundler_capistrano",
    "repository": "acme/example2",
    "environments": ["staging", "production"],
    "check_deploy_status": {
        "environments": {
            "production": "0 0 8 * * 1-5",
            "staging": "0 0 8-18/2 * * 1-5"
        },
        "adapter": "default",
        "room": "14dc03c3-8c97-45a5-8432-59df312e7c1b"
    }
}

The script uses cron package, so the cron pattern can be anything that package understands. Timezones are from time package.