116 lines
3.5 KiB
Markdown
116 lines
3.5 KiB
Markdown
# drone-matrixchat-notify
|
|
|
|
A [drone.io] [plugin] to send notifications to Matrix chat rooms from
|
|
CI pipeline steps.
|
|
|
|
Example pipeline configuration:
|
|
|
|
```yaml
|
|
kind: pipeline
|
|
type: docker
|
|
name: default
|
|
|
|
steps:
|
|
- name: build
|
|
image: alpine
|
|
commands:
|
|
- ./build
|
|
|
|
- name: notify
|
|
image: spotlightkid/drone-matrixchat-notify
|
|
settings:
|
|
homeserver: 'https://matrix.org'
|
|
roomid: '!xxxxxx@matrix.org'
|
|
userid: '@drone-bot@matrix.org'
|
|
password:
|
|
from_secret: drone-bot-pw
|
|
template: '${DRONE_REPO} ${DRONE_COMMIT_SHA} ${DRONE_BUILD_STATUS}'
|
|
```
|
|
|
|
## Configuration settings
|
|
|
|
* `allowed_tags` *(default:* [`DEFAULT_ALLOWED_TAGS`]*)*
|
|
|
|
List or set or string with comma-separated list of HTML tag names. HTML
|
|
tags not included, will be stripped from the HTML output generated by
|
|
rendering a Markdown message template.
|
|
|
|
Note that the default list does not include any tags, which allow to load
|
|
external resources when the generated HTML is displayed, notably `img`
|
|
is not included.
|
|
|
|
* `allowed_attrs` *(default:* [`DEFAULT_ALLOWED_ATTRS`]*)*
|
|
|
|
List or string with comma-separated list of HTML attribute names or
|
|
dict mapping tag names to lists of attributes names.
|
|
|
|
See the bleach documentation on [allowed attributes] for more information.
|
|
|
|
* `accesstoken`
|
|
|
|
Access token to use for authentication instead of `password`. Either an
|
|
access token or a password is required.
|
|
|
|
* `deviceid`
|
|
|
|
Device ID to send with access token.
|
|
|
|
* `devicename`
|
|
|
|
Device name to send with access token.
|
|
|
|
* `homeserver` *(default:* `https://matrix.org`*)*
|
|
|
|
The Matrix homeserver URL.
|
|
|
|
* `markdown`
|
|
|
|
If set to `yes`, `y`, `true` or `on`, the message resulting from template
|
|
substtution is considered to be in Markdown format and will be rendered to
|
|
HTML and sent as a formatted message with `org.matrix.custom.html` format.
|
|
|
|
* `markdown_extensions` *(default:* `admonition, extra, sane_lists, smarty`)
|
|
|
|
Comma-separated list of enabled Markdown extensions. See this
|
|
[list of extensions] for valid extension names. Including an invalid
|
|
extension name in this list will disable Markdown rendering.
|
|
|
|
* `pass_environment` *(default:* `DRONE_*`*)*
|
|
|
|
Comma-separated white-list of environment variable names or name patterns.
|
|
Patterns are shell-glob style patterns and case-sensitive.
|
|
|
|
Only environment variables matching any of the given names or patterns will
|
|
be available as valid placeholders in the message template.
|
|
|
|
* `password`
|
|
|
|
Password to use for authenticating the user set with `userid`. Either a
|
|
password or an access token is required.
|
|
|
|
* `roomid` *(required)*
|
|
|
|
ID of matrix chat room to send messages to (ID, not alias).
|
|
|
|
* `template` *(default:* `${DRONE_BUILD_STATUS}`*)*
|
|
|
|
The message template. Valid placeholders of the form `${PLACEHOLDER}` will
|
|
be substituted with the values of the matching environment variables
|
|
(subject to filtering according to the `pass_environment` setting).
|
|
|
|
See this [reference] for environment variables available in drone.io CI
|
|
pipelines.
|
|
|
|
* `userid` *(required)*
|
|
|
|
ID of user on homeserver to send message as (ID, not username).
|
|
|
|
|
|
[`DEFAULT_ALLOWED_ATTRS`]: ./matrixchat-notify.py#L29
|
|
[`DEFAULT_ALLOWED_TAGS`]: ./matrixchat-notify.py#L35
|
|
[allowed attributes]: https://bleach.readthedocs.io/en/latest/clean.html#allowed-attributes-attributes
|
|
[drone.io]: https://drone.io/
|
|
[list of extensions]: https://python-markdown.github.io/extensions/
|
|
[plugin]: https://docs.drone.io/plugins/overview/
|
|
[reference]: https://docs.drone.io/pipeline/environment/reference/
|