Skip to content

Warning

You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?

Slatify

Actions
Slack Notification Action
v2.0.1
Star (133)

Tags

 (1)

Slatify

GitHub release (latest by date) GitHub

This is Slack Notification for GitHub Actions.
Generated from actions/javascript-template.

Feature

  • Notify the result of GitHub Actions
  • Support three job status (reference: job-context)
    • success
    • failure
    • cancelled
  • Mention
    • Notify message to channel members efficiently
    • You can specify the condition to mention

How to use

First of all, you need to set GitHub secrets for SLACK_WEBHOOK that is Incoming Webhook URL.
You can customize the following parameters:

with parameter required/optional default description
type required N/A The result of GitHub Actions job
This parameter value must contain the following word:
- success
- failure
- cancelled
We recommend using ${{ job.status }}
job_name required N/A Means slack notification title
url required N/A Slack Incoming Webhooks URL
Please specify this key or SLACK_WEBHOOK environment variable
※SLACK_WEBHOOK will be deprecated
mention optional N/A Slack message mention
mention_if optional N/A The condition to mention
This parameter can contain the following word:
- success
- failure
- cancelled
- always
icon_emoji optional Use Slack Incoming Webhook configuration Slack icon
username optional Use Slack Incoming Webhook configuration Slack username
channel optional Use Slack Incoming Webhook configuration Slack channel name
commit optional false If true, slack notification includes the latest commit message and author.
token case by case N/A This token is used to get commit data.
If commit parameter is true, this parameter is required.
${{ secrets.GITHUB_TOKEN }} is recommended.

Please refer action.yml for more details.

Examples

- name: Slack Notification
  uses: homoluctus/slatify@master
  if: always()
  with:
    type: ${{ job.status }}
    job_name: '*Lint Check*'
    mention: 'here'
    mention_if: 'failure'
    channel: '#random'
    url: ${{ secrets.SLACK_WEBHOOK }}

↓ Including the latest commit data

- name: Slack Notification
  uses: homoluctus/slatify@master
  if: always()
  with:
    type: ${{ job.status }}
    job_name: '*Lint Check*'
    mention: 'here'
    mention_if: 'failure'
    channel: '#random'
    url: ${{ secrets.SLACK_WEBHOOK }}
    commit: true
    token: ${{ secrets.GITHUB_TOKEN }}

Notification Preview

Slack UI Example

Notification Preview

Contribute

  1. Fork this repository
  2. Pull your repository in local machine
  3. Update original repository
  4. Checkout "master" branch based "remotes/origin/master" branch
  5. Work on "master" branch
  6. Push you changes to your repository
  7. Create a new Pull Request

LICENSE

The MIT License (MIT)

Slatify is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Slack Notification Action
v2.0.1

Tags

 (1)

Slatify is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.