Back to Deployer

Chatwork Recipe

docs/contrib/chatwork.md

8.0.34.7 KB
Original Source
<!-- DO NOT EDIT THIS FILE! --> <!-- Instead edit contrib/chatwork.php --> <!-- Then run bin/docgen -->

Chatwork Recipe

php
require 'contrib/chatwork.php';

Source

Chatwork Recipe

Installing

  1. Create chatwork account by any manual in the internet
  2. Take chatwork token (Like: b29a700e2d15bef3f26ae6a5c142d1ea) and set chatwork_token parameter
  3. Take chatwork room id from url after clicked on the room, and set chatwork_room_id parameter
  4. If you want, you can edit chatwork_notify_text, chatwork_success_text or chatwork_failure_text
  5. Require chatwork recipe in your deploy.php file
php
# https://deployer.org/recipes.html
require 'recipe/chatwork.php';

Add hook on deploy:

php
before('deploy', 'chatwork:notify');

Configuration

  • chatwork_token – chatwork bot token, required
  • chatwork_room_id — chatwork room to push messages to required
  • chatwork_notify_text – notification message template
    [info]
      [title](*) Deployment Status: Deploying[/title]
      Repo: {{repository}}
      Branch: {{branch}}
      Server: {{hostname}}
      Release Path: {{release_path}}
      Current Path: {{current_path}}
    [/info]
    
  • chatwork_success_text – success template, default:
    [info]
      [title](*) Deployment Status: Successfully[/title]
      Repo: {{repository}}
      Branch: {{branch}}
      Server: {{hostname}}
      Release Path: {{release_path}}
      Current Path: {{current_path}}
    [/info]"
    
  • chatwork_failure_text – failure template, default:
    [info]
      [title](*) Deployment Status: Failed[/title]
      Repo: {{repository}}
      Branch: {{branch}}
      Server: {{hostname}}
      Release Path: {{release_path}}
      Current Path: {{current_path}}
    [/info]"
    

Tasks

  • chatwork:notify – send message to chatwork
  • chatwork:notify:success – send success message to chatwork
  • chatwork:notify:failure – send failure message to chatwork

Usage

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

php
before('deploy', 'chatwork:notify');

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

php
after('deploy:success', 'chatwork:notify:success');

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

php
after('deploy:failed', 'chatwork:notify:failure');

Configuration

chatwork_token

Source

Chatwork settings :::info Required Throws exception if not set. :::

chatwork_room_id

Source

:::info Required Throws exception if not set. :::

chatwork_api

Source

php
return 'https://api.chatwork.com/v2/rooms/' . get('chatwork_room_id') . '/messages';

chatwork_notify_text

Source

The Messages

php
"[info]\n[title](*) Deployment Status: Deploying[/title]\nRepo: {{repository}}\nBranch: {{branch}}\nServer: {{hostname}}\nRelease Path: {{release_path}}\nCurrent Path: {{current_path}}\n[/info]"

chatwork_success_text

Source

php
"[info]\n[title](*) Deployment Status: Successfully[/title]\nRepo: {{repository}}\nBranch: {{branch}}\nServer: {{hostname}}\nRelease Path: {{release_path}}\nCurrent Path: {{current_path}}\n[/info]"

chatwork_failure_text

Source

php
"[info]\n[title](*) Deployment Status: Failed[/title]\nRepo: {{repository}}\nBranch: {{branch}}\nServer: {{hostname}}\nRelease Path: {{release_path}}\nCurrent Path: {{current_path}}\n[/info]"

Tasks

chatwork_send_message {#chatwork_send_message}

Source

Helpers

chatwork:test {#chatwork-test}

Source

Tests messages.

Tasks

chatwork:notify {#chatwork-notify}

Source

Notifies Chatwork.

chatwork:notify:success {#chatwork-notify-success}

Source

Notifies Chatwork about deploy finish.

chatwork:notify:failure {#chatwork-notify-failure}

Source

Notifies Chatwork about deploy failure.