mirror of
https://github.com/appleboy/drone-discord.git
synced 2026-06-14 22:12:26 +08:00
Bo-Yi Wu
145 lines
4.1 KiB
Markdown
145 lines
4.1 KiB
Markdown
<img src="images/discord-logo.png">
|
|
|
|
# drone-[discord](https://discordapp.com)
|
|
|
|
Drone plugin for sending message to Discord channel using Webhook.
|
|
|
|
[](https://godoc.org/github.com/appleboy/drone-discord)
|
|
[](https://cloud.drone.io/appleboy/drone-discord)
|
|
[](https://codecov.io/gh/appleboy/drone-discord)
|
|
[](https://goreportcard.com/report/github.com/appleboy/drone-discord)
|
|
[](https://hub.docker.com/r/appleboy/drone-discord/)
|
|
[](https://microbadger.com/images/appleboy/drone-discord:linux-amd64 "Get your own image badge on microbadger.com")
|
|
|
|
Webhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use. See more [api document information](https://discordapp.com/developers/docs/resources/webhook). For the usage information and a listing of the available options please take a look at [the docs](http://plugins.drone.io/appleboy/drone-discord/).
|
|
|
|
Sending discord message using a binary, docker or [Drone CI](http://docs.drone.io/).
|
|
|
|
## Features
|
|
|
|
* [x] Send Multiple Messages
|
|
* [x] Send Multiple Files
|
|
|
|
## Build or Download a binary
|
|
|
|
The pre-compiled binaries can be downloaded from [release page](https://github.com/appleboy/drone-discord/releases). Support the following OS type.
|
|
|
|
* Windows amd64/386
|
|
* Linux arm/amd64/386
|
|
* Darwin amd64/386
|
|
|
|
With `Go` installed
|
|
|
|
```
|
|
$ go get -u -v github.com/appleboy/drone-discord
|
|
```
|
|
|
|
or build the binary with the following command:
|
|
|
|
```
|
|
$ export GOOS=linux
|
|
$ export GOARCH=amd64
|
|
$ export CGO_ENABLED=0
|
|
$ export GO111MODULE=on
|
|
|
|
$ go test -cover ./...
|
|
|
|
$ go build -v -a -tags netgo -o release/linux/amd64/drone-discord .
|
|
```
|
|
|
|
## Docker
|
|
|
|
Build the docker image with the following commands:
|
|
|
|
```
|
|
$ make docker
|
|
```
|
|
|
|
Please note incorrectly building the image for the correct x64 linux and with
|
|
CGO disabled will result in an error when running the Docker image:
|
|
|
|
```
|
|
docker: Error response from daemon: Container command
|
|
'/bin/drone-discord' not found or does not exist..
|
|
```
|
|
|
|
## Usage
|
|
|
|
There are three ways to send notification.
|
|
|
|
* [usage from binary](#usage-from-binary)
|
|
* [usage from docker](#usage-from-docker)
|
|
* [usage from drone ci](#usage-from-drone-ci)
|
|
|
|
<a name="usage-from-binary"></a>
|
|
### Usage from binary
|
|
|
|
#### Send Notification
|
|
|
|
```bash
|
|
drone-discord \
|
|
--webhook-id xxxx \
|
|
--webhook-token xxxx \
|
|
--message "Test Message"
|
|
```
|
|
|
|
<a name="usage-from-docker"></a>
|
|
### Usage from docker
|
|
|
|
#### Send Notification
|
|
|
|
```bash
|
|
docker run --rm \
|
|
-e WEBHOOK_ID=xxxxxxx \
|
|
-e WEBHOOK_TOKEN=xxxxxxx \
|
|
-e WAIT=false \
|
|
-e TTS=false \
|
|
-e USERNAME=test \
|
|
-e AVATAR_URL=http://example.com/xxxx.png \
|
|
-e MESSAGE=test \
|
|
appleboy/drone-discord
|
|
```
|
|
|
|
<a name="usage-from-drone-ci"></a>
|
|
### Usage from drone ci
|
|
|
|
#### Send Notification
|
|
|
|
Execute from the working directory:
|
|
|
|
```bash
|
|
docker run --rm \
|
|
-e WEBHOOK_ID=xxxxxxx \
|
|
-e WEBHOOK_TOKEN=xxxxxxx \
|
|
-e WAIT=false \
|
|
-e TTS=false \
|
|
-e USERNAME=test \
|
|
-e AVATAR_URL=http://example.com/xxxx.png \
|
|
-e MESSAGE=test \
|
|
-e DRONE_REPO_OWNER=appleboy \
|
|
-e DRONE_REPO_NAME=go-hello \
|
|
-e DRONE_COMMIT_SHA=e5e82b5eb3737205c25955dcc3dcacc839b7be52 \
|
|
-e DRONE_COMMIT_BRANCH=master \
|
|
-e DRONE_COMMIT_AUTHOR=appleboy \
|
|
-e DRONE_COMMIT_AUTHOR_EMAIL=appleboy@gmail.com \
|
|
-e DRONE_COMMIT_MESSAGE=Test_Your_Commit \
|
|
-e DRONE_BUILD_NUMBER=1 \
|
|
-e DRONE_BUILD_STATUS=success \
|
|
-e DRONE_BUILD_LINK=http://github.com/appleboy/go-hello \
|
|
-e DRONE_JOB_STARTED=1477550550 \
|
|
-e DRONE_JOB_FINISHED=1477550750 \
|
|
-v $(pwd):$(pwd) \
|
|
-w $(pwd) \
|
|
appleboy/drone-discord
|
|
```
|
|
|
|
You can get more [information](DOCS.md) about how to use this plugin in drone.
|
|
|
|
## Testing
|
|
|
|
Test the package with the following command:
|
|
|
|
```
|
|
$ make test
|
|
```
|