drone-ntfy/README.md

57 lines
1.1 KiB
Markdown
Raw Normal View History

# Drone Ntfy plugin
[![Build Status](https://ci.cuzo.dev/api/badges/parra/drone-ntfy/status.svg)](https://ci.cuzo.dev/parra/drone-ntfy)
The Ntfy.sh plugin posts build status messages to your selected Ntfy server.
Example:
```yml
kind: pipeline
name: default
steps:
- name: send ntfy notification
image: parrazam/drone-ntfy
when:
status: [success, failure]
settings:
url: https://ntfy.example.org
topic: events
priority: low
tags:
- pipeline-status
- dev
username:
from_secret: ntfy_user
password:
from_secret: ntfy_password
```
## Properties
`url` *string* [optional] \
Ntfy server.
> *Default: https://ntfy.sh*
`topic` *string* [**REQUIRED**] \
Topic to publish message.
> *Default: none*
`priority` *string* [optional] \
Priority of the notification. Values can be [min, low, default, high, max].
> *Default: default*
`tags` *string* [optional] \
Custom tags to include.
> *Default: none*
`username` *string* [optional] \
Username with publish permissions.
> *Default: none*
`password` *string* [optional] \
[***SECRET RECOMMENDED***] \
Password for username.
> *Default: none*