Skip to main content
Version: 7.x

mattermost

Source

Installing

Create a Mattermost incoming webhook, through the administration panel.

Require the new recipe into your deploy.php

require 'contrib/mattermost.php';

Add hook on deploy:

before('deploy', 'mattermost:notify');

Configuration

  • mattermost_webhook - incoming mattermost webook required

    set('mattermost_webook', 'https://{your-mattermost-site}/hooks/xxx-generatedkey-xxx');
  • mattermost_channel - overrides the channel the message posts in

    set('mattermost_channel', 'town-square');
  • mattermost_username - overrides the username the message posts as

    set('mattermost_username', 'deployer');
  • mattermost_icon_url - overrides the profile picture the message posts with

    set('mattermost_icon_url', 'https://domain.com/your-icon.png');
  • mattermost_text - notification message

    set('mattermost_text', '_{{user}}_ deploying `{{branch}}` to **{{target}}**');
  • mattermost_success_text – success template, default:

    set('mattermost_success_text', 'Deploy to **{{target}}** successful {{mattermost_success_emoji}}');
  • mattermost_failure_text – failure template, default:

    set('mattermost_failure_text', 'Deploy to **{{target}}** failed {{mattermost_failure_emoji}}');
  • mattermost_success_emoji – emoji added at the end of success text

  • mattermost_failure_emoji – emoji added at the end of failure text

    For detailed information about Mattermost hooks see: https://developers.mattermost.com/integrate/incoming-webhooks/

Usage

If you want to notify only about beginning of deployment add this line only:

before('deploy', 'mattermost:notify');

If you want to notify about successful end of deployment add this too:

after('deploy:success', 'mattermost:notify:success');

If you want to notify about failed deployment add this too:

after('deploy:failed', 'mattermost:notify:failure');

Configuration

mattermost_webhook

Source

Default value
null

mattermost_channel

Source

Default value
null

mattermost_username

Source

Default value
'deployer'

mattermost_icon_url

Source

Default value
null

mattermost_success_emoji

Source

Default value
':​white_check_mark:'

mattermost_failure_emoji

Source

Default value
':​x:'

mattermost_text

Source

Default value
'_{{user}}_ deploying `{{branch}}` to **{{target}}**'

mattermost_success_text

Source

Default value
'Deploy to **{{target}}** successful {{mattermost_success_emoji}}'

mattermost_failure_text

Source

Default value
'Deploy to **{{target}}** failed {{mattermost_failure_emoji}}'

Tasks

mattermost:notify

Source

Notifies mattermost.

mattermost:notify:success

Source

Notifies mattermost about deploy finish.

mattermost:notify:failure

Source

Notifies mattermost about deploy failure.



Support Deployer ❤️

Hello, my name is Anton Medvedev (@antonmedv). I'm the creator of the Deployer.
I maintain this open source project in my spare time.
Supporters on GitHub give me extra motivation to work on the project.