56 lines
1.1 KiB
Markdown
56 lines
1.1 KiB
Markdown
# 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*
|