Demo Slack Notification Setup

Learn how to configure Slack notifications in Jenkins by installing the Slack Notification plugin, creating a Slack channel and app, and integrating them with secure credentials. By the end, you’ll have automated build alerts in your Slack workspace.

Installing the Slack Notification Plugin

Jenkins offers a dedicated Slack Notification plugin to send build statuses, messages, and files directly to Slack channels.

1. In Jenkins, navigate to Manage Jenkins > Manage Plugins.
2. Open the Available tab, search for Slack Notification, select it, and click Install without restart.

3. Monitor the download progress under Plugin Manager. You’ll see statuses like "Pending," "Downloading," and "Installed."

4. Once installation completes, restart Jenkins to activate the plugin.

Reviewing the Plugin Documentation

While Jenkins restarts, review the official plugin documentation to explore advanced features and configuration options:

• Slack Notification Plugin for Jenkins

Creating a Slack Channel

Define a Slack channel to receive Jenkins build notifications:

1. In Slack, click Add channels > Create a channel.
2. Name it dasher-notifications (or your preferred identifier).
3. Choose Public or Private, then click Create.

When the channel opens, you’ll see a welcome prompt and an option to enable notifications.

Creating a Slack App via Manifest

Grant Jenkins permission to post messages by creating a Slack App with a bot user.

1. In Slack, go to Apps > Build, choose From an app manifest, and select your workspace.

2. Paste the YAML manifest below to define the bot and its scopes:

display_information:
  name: Jenkins
features:
  bot_user:
    display_name: Jenkins
    always_online: true
oauth_config:
  scopes:
    bot:
      - channels:read
      - chat:write
      - chat:write.customize
      - files:write
      - reactions:write
      - users:read
      - users:read.email
      - groups:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

3. Click Next, review permissions, then Create App.

4. Under OAuth & Permissions, click Install to Workspace and authorize the app.

5. Copy the Bot User OAuth Access Token from Installed App Settings. You’ll use this as a Jenkins credential.

Slack Bot Scopes Reference

Configuring Jenkins with Slack Credentials

1. After Jenkins restarts, go to Manage Jenkins > Configure System.
2. Scroll to the Slack section.
3. For Workspace, enter Jenkins.
4. Under Credentials, click Add > Jenkins > Secret text.

5. In the dialog:
   • Kind: Secret text
   • Secret: Bot User OAuth token
   • ID: slack-bot-token
   • Click Add.
6. Back in the Slack section, select Credentials → slack-bot-token.
7. Set Default Channel / Member ID to #dasher-notifications.
8. Click Test Connection, then Save.

/invite @Jenkins

Verifying the Integration

Once the connection succeeds, the Jenkins app will join the channel and post a confirmation message.

You’ve successfully set up Slack notifications for Jenkins. Next, configure your pipelines to send alerts on build successes, failures, and more!

Links and References

• Slack Notification Plugin for Jenkins
• Jenkins Documentation
• Slack API Documentation