Slack Notify Cli

CLI tool to post slack messages. Uses the node-stage tool for configuration.

Setup

1yarn add slack-notify-cli@poviolabs/slack-notify-cli#v2
2
3# update
4yarn up slack-notify-cli@poviolabs/slack-notify-cli#v2

or install globally

1npm i -g slack-notify-cli@poviolabs/slack-notify-cli#v2 --force

Example

1slackNotify: &slackNotify
2    channel: C03AXDS9F2B
3    autolinkPrefix: NS-
4    autolinkTarget: https://github.com/poviolabs/node-stage/issues/
5    commitPrefix: https://github.com/poviolabs/node-stage/commit/
6    projectName: NodeStage
7
8stages:
9    myapp-prd:
10      slackNotify:
11        <<: *slackNotify
12

1yarn slack-notify-cli --messageType success
2yarn slack-notify-cli --messageType failure
3yarn slack-notify-cli --messageType info --message A custom message!

Options

--message

Any text appended to the Slack message

--channel

The Slack channel to send the message to. Right-click copy url on the channel to find it. Example: C03AXDS9F2B

--messageType [ success | failure | info ]

--appVersion

Version of the deploy. Tied to a specific Release and Stage combination. If supplied with a semver format, the version will be prefixed with ${STAGE}

--autolinkPrefix

Prefix to detect the ticket id.

--autolinkTarget

The url prefix that is generated for the ticket id.

--commitPrefix

The url that is generated for the commit sha.

--projectName

Name of the project as presented in Slack.

--branchName

Name of the branch deployed. Auto-detected from most CI/CD services.

--dryRun --verbose

Run and output the Slack template without actually sending the message.

More options can be found here.

Development

Test locally

1# test with ts-node
2yarn test:ts-node:cli --help
3
4# build new version
5yarn build
6
7# test build
8yarn test:cli --help