Shipit-slack NPM

shipit-slack

A set of tasks for Shipit used for slack slack notifications.

AristotoServer

Features:

Triggered on the updated or fetched event from shipit-deploy
Works via shipit-cli and grunt-shipit

Install

npm install shipit-slack --save-dev
yarn add shipit-slack --dev

Usage

It is required to set the webhookUrl that links to a Slack incoming webhook. This can be done in the shipit.config.slack key in the config.

slack: {
  webhookUrl: 'https://hooks.slack.com/services/XXX',
}

Afterwards, just simply run: (This triggers the slack task on the deploy deployed or fetched event. No additional config necessary.)

shipit default deploy

Or you can run the tasks separatly :

shipit default slack:init slack:send

Options `shipit.config.slack`

`slack.webhookUrl`

Type: String Default: null Required: true

The webhook url that is configured for your Slack channel.

`slack.channel`

Type: String Default: null

A string that decides what channel the webhook is send to. If this value is null, the default channel is used that is configured in the incoming webhook.

`slack.message`

Type: String Default: Shipit-Slack

A string that determines the message that is send with the Slack notification.

`slack.triggerEvent`

Type: String Default: fetched

An event name that triggers slack:install.

`slack.status`

Type: String Default: good Options: good, warning, error

An string that decides what color the notification in Slack gets, they are respectively: green, orange and red.

`slack.template`

Type: Object Default:

{
 attachments: [
   {
     fallback: '{{message}}',
     color: '{{status}}',
     fields: [
       {
         title: '{{message}}',
         value: moment().format('MMMM Do YYYY, H:mm:ss'),
         short: true
       },
       {
         title: 'Environment',
         value: '{{buildEnv}}',
         short: true
       },
     ]
   }
 ]
}

Template of slack message. All {{values}} will be populated from shipit.config.slack object. More info about Slack formatting

Example `shipitfile.js` options usage

module.exports = function (shipit) {
  require('shipit-deploy')(shipit);
  require('shipit-slack')(shipit);

  shipit.initConfig({
    default: {
      slack: {
        webhookUrl: 'https://hooks.slack.com/services/__XXX__',
        status: 'good',
        message: 'Shipit-Slack',
        triggerEvent: 'deployed',
        channel: '#default'
        template: {
          attachments: [{
            fallback: 'Frontend deployed to {{buildEnv}}',
            title: 'Visit',
            title_link: '{{url}}',
            pretext: '*Frontend deploy done!*:tada:',
            color: '{{status}}',
            fields: [{
              title: 'Environment',
              value: '{{buildEnv}}',
              short: false
            },
            {
              title: 'Changes',
              value: '{{message}}',
              short: false
            }],
            mrkdwn_in: ['pretext']
          }]
      }
    }
  });
};

Workflow tasks

slack
- slack:init
  - Emit event "slack_inited".
- slack:install
  - Runs slack install
  - Emit event "slack_installed"
- slack:send
  - Sends slack notification.

Event flow:

on Event "deploy" (shipit-deploy initialized)
- Runs slack:init
- on Event "slack_inited"
  - Runs slack:install (Triggered on the fetched event from shipit-deploy or by a custom slack.triggerEvent as mentioned above.)