serverless-notify-after-command

1.1.5 • Public • Published

serverless-notify-after-command

This is a simple plugin for Serverless Framework to send a notification to the linux system notification system after any serverless command (successfull or failed).

This plugin depends that your operational system is able to run the bash commands:

sleep 
notify-send
paplay

For the plugin to work, it creates a child process the checks the amount of processes from serverless running in the system.

Install

$ npm install serverless-notify-after-command --save-dev

Add the plugin to your serverless.yml file:

plugins:
  - serverless-notify-after-command

Configure

The configuration of the plugin is done by defining a custom: notifyAfterCommand object in your serverless.yml with your specific configuration.

Attribute Type Default Description
active Boolean true Should run or not by default
blacklist Array [] Blacklist commands, even when active is true
whitelist Array [] Whitelist commands, even when active is false
stages Array ['development'] The list of stages to run
sound Boolean true True if a sound should be played too

For the stages, important to note how the plugin infers the stage. It gets the --stage option, then serverless.yml custom.stage, then serverless.yml provider.stage then 'development.' The first one it finds, is the value it considers.

custom:
  notifyAfterCommand:
    active: true
    blacklist: []
    whitelist: []
    stages: ['development']
    sound: true

Besides the serverless.yml configuration, you can pass Environment Variables to force it to use or not. Just set the SLS_NOTIFY to true or false, if you want notifications or not.

If you want to force the sound to play event when sound is false, pass the SLS_NOTIFY_SOUND=true.

SLS_NOTIFY=true serverless [command]
SLS_NOTIFY=true sls [command]
SLS_NOTIFY_SOUND=true sls [command]

Roadmap

Customize the notification sound.

Dependents (0)

Package Sidebar

Install

npm i serverless-notify-after-command

Weekly Downloads

1

Version

1.1.5

License

ISC

Unpacked Size

628 kB

Total Files

8

Last publish

Collaborators

  • arielschvartz