krakowski / rocket Goto Github PK

This is a small application designed for sending notifications to RocketChat. It was developed with the idea of sending notifications from CI pipelines to channels.

The binary is available for Linux, macOS and Windows from the GitHub Releases page.

First a ".rocket" folder must be created in the project directory.

mkdir .rocket

In the next step a template for the notification is created in the folder just created.

cat << EOF > .rocket/my-template.yml
channel: '#my-channel'
text: 'Hello from {{.Env.SENDER}}'
EOF

Since the YAML file is processed with the template package, as in this example, environment variables can be used. The created template can now be used to send a notification.

ROCKET_HOST=https://rocketchat.com ROCKET_USER=myuser ROCKET_PASS=mypass SENDER=Rocket rocket notify my-template

The environment variables can of course also be set in advance. This includes variables set in CI Pipelines.

The rocket tool accepts the following arguments.

Additionally some options are configured via environment variables.

ROCKET_USER and ROCKET_PASS are not required, since they are interactively queried from the console when not available.

Please refer to the RocketChat documentation to find out which fields can be set in the template file(s).

This project is licensed under the GNU GPLv3 License - see the LICENSE file for details.