Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.57 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.57 KB

Mina::Slack

Announce Mina deployments to a slack channel.

Installation

Add this line to your application's Gemfile:

gem 'mina-slack'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mina-slack

Usage

Load the recipe

Include the recipe in your deploy.rb

# config/deploy.rb
require 'mina/slack'

Setup Slack Details

You'll need to setup your slack details with an API key, room and subdomain. You can add these as ENV variables or in the config/deploy.rb

# required
set :slack_url, 'https://hooks.slack.com/services/<YOUR-STRING1>/<YOUR-STRING2>' # comes from inbound webhook integration
set :slack_room, '#general' # the room to send the message to

# optional
set :slack_application, 'Application Name' # override Capistrano `application`
set :slack_username, 'Deploy Bot' # displayed as name of message sender
set :slack_emoji, ':cloud:' # will be used as the avatar for the message
set :slack_stage, 'staging' # will be used to specify the deployment environment

Or use the ENV variables:

# required
ENV['SLACK_URL'] = ''
ENV['SLACK_ROOM'] = ''

# optional
ENV['SLACK_APPLICATION'] = ''
ENV['SLACK_USERNAME'] = ''
ENV['SLACK_EMOJI'] = ''
ENV['SLACK_STAGE'] = '' # or ENV['to']

Contributing

  1. Fork it ( http://github.com//mina-slack/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request