Skip to content

A Dockerized tool for sending messages to Slack channels

License

Notifications You must be signed in to change notification settings

krom/slack-notify

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Slack-Notify

Slack-Notify is a very simple tool for sending a Slack notification via a Slack Incoming Webhook.

It is designed to function as a 12-factor app, receiving configuration via environment variables. To keep things simple, it is rigid in what it allows you to set. More complex slackbots might want to customize this a little more.

Slack Incoming Webhooks

This tool uses Slack Incoming Webhooks to send a message to your slack channel.

Before you can use this tool, you need to log into your Slack account and configure this.

Usage

Running slack-notify in a shell prompt goes like this:

$ export SLACK_WEBHOOK=https://hooks.slack.com/services/Txxxxxx/Bxxxxxx/xxxxxxxx
$ SLACK_MESSAGE="hello" slack-notify

Running the Docker container goes like this:

$ export SLACK_WEBHOOK=https://hooks.slack.com/services/Txxxxxx/Bxxxxxx/xxxxxxxx
$ docker run -e SLACK_WEBHOOK=$SLACK_WEBHOOK -e SLACK_MESSAGE="hello" -e SLACK_CHANNEL=acid kromz/slack-notify

.gitlab-ci.yml

You may to setup variables via CI/CD variables

stages:
  - notify
  
variables:
  SLACK_WEBHOOK: https://hooks.slack.com/services/Txxxxxx/Bxxxxxx/xxxxxxxx
  SLACK_CHANNEL: deploy

notify:
  stage: notify
  image: kromz/slack-notify:latest
  script:
    - 'SLACK_MESSAGE="Message" slack-notify'

Environment Variables

# The Slack-assigned webhook
SLACK_WEBHOOK=https://hooks.slack.com/services/Txxxxxx/Bxxxxxx/xxxxxxxx
# A URL to an icon
SLACK_ICON=http://example.com/icon.png
# The channel to send the message to (if omitted, use Slack-configured default)
SLACK_CHANNEL=example
# The title of the message
SLACK_TITLE="Hello World"
# The body of the message
SLACK_MESSAGE="Today is a fine day"
# RGB color to for message formatting. (Slack determines what is colored by this)
SLACK_COLOR="#efefef"
# The name of the sender of the message. Does not need to be a "real" username
SLACK_USERNAME="Bot"

Build It

Compile:

make build

Publish to DockerHub

make docker-build docker-push

About

A Dockerized tool for sending messages to Slack channels

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 82.8%
  • Makefile 8.8%
  • Dockerfile 8.4%