deployer/docs/contrib/chatwork.md
hieudt-2054 4f8ebd3494
Adding a Chatwork contrib recipe (#2367)
* Adding a Chatwork contrib recipe
* Add docgen
2021-02-22 14:04:03 +01:00

4.9 KiB
Raw Blame History

chatwork

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
# https://deployer.org/recipes.html

require 'recipe/chatwork.php';

Add hook on deploy:

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:

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

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

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

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

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

Config

chatwork_token

Source

Chatwork settings

chatwork_room_id

Source

chatwork_api

Source

chatwork_notify_text

Source

The Messages

chatwork_success_text

Source

chatwork_failure_text

Source

Tasks

chatwork_send_message

Source

Helpers

chatwork:test

Source

Tasks

chatwork:notify

Source

chatwork:notify:success

Source

chatwork:notify:failure

Source