From 2c140b50485ff646ffa6b79eaff3fc40f12f1180 Mon Sep 17 00:00:00 2001 From: thegeeklab-bot Date: Tue, 15 Aug 2023 22:35:53 +0000 Subject: [PATCH] [skip ci] auto-update documentation --- content/_index.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++ data/data.yaml | 43 +++++++++++++++++++++++++++++ 2 files changed, 112 insertions(+) create mode 100644 content/_index.md create mode 100644 data/data.yaml diff --git a/content/_index.md b/content/_index.md new file mode 100644 index 0000000..026dc07 --- /dev/null +++ b/content/_index.md @@ -0,0 +1,69 @@ +--- +title: wp-matrix +--- + +[![Build Status](https://ci.thegeeklab.de/api/badges/thegeeklab/wp-matrix/status.svg)](https://ci.thegeeklab.de/repos/thegeeklab/wp-matrix) +[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/thegeeklab/wp-matrix) +[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/wp-matrix) +[![Go Report Card](https://goreportcard.com/badge/github.com/thegeeklab/wp-matrix)](https://goreportcard.com/report/github.com/thegeeklab/wp-matrix) +[![GitHub contributors](https://img.shields.io/github/contributors/thegeeklab/wp-matrix)](https://github.com/thegeeklab/wp-matrix/graphs/contributors) +[![Source: GitHub](https://img.shields.io/badge/source-github-blue.svg?logo=github&logoColor=white)](https://github.com/thegeeklab/wp-matrix) +[![License: Apache-2.0](https://img.shields.io/github/license/thegeeklab/wp-matrix)](https://github.com/thegeeklab/wp-matrix/blob/main/LICENSE) + +Woodpecker CI plugin to send messages to a Matrix room. + + + +{{< toc >}} + + + +## Usage + +```YAML +kind: pipeline +name: default + +steps: +- name: notify + image: thegeeklab/matrix + settings: + homeserver: https://matrix.org + roomid: abcdefghijklmnopqrstuvwxyz:matrix.org + username: octocat + password: secret +``` + +### Parameters + + + +{{< propertylist name=wp-matrix.data sort=name >}} + + + +## Build + +Build the binary with the following command: + +```Shell +make build +``` + +Build the container image with the following command: + +```Shell +docker build --file Containerfile.multiarch --tag thegeeklab/wp-matrix . +``` + +## Test + +```Shell +docker run --rm \ + -e PLUGIN_ROOMID=0123456789abcdef:matrix.org \ + -e PLUGIN_USERNAME=yourbot \ + -e PLUGIN_PASSWORD=p455w0rd \ + -v $(pwd):/build:z \ + -w /build \ + thegeeklab/wp-matrix +``` diff --git a/data/data.yaml b/data/data.yaml new file mode 100644 index 0000000..42c5bc1 --- /dev/null +++ b/data/data.yaml @@ -0,0 +1,43 @@ +--- +properties: + - name: username + description: Authentication username. If set, the `password` parameter is required as well. + type: string + required: false + + - name: password + description: Authentication password. + type: string + required: false + + - name: user_id + description: Aauthentication User ID. If set, the `access_token` parameter is required as well. + type: string + required: false + + - name: access_token + description: Authentication access token. + type: string + required: false + + - name: homeserver + description: The Matrix homeserver url to use. + defaultValue: https://matrix.org + type: string + required: false + + - name: roomid + description: Room ID to send messages to. + type: string + required: false + + - name: template + description: | + Golang template for the message. The [Metadata struct](https://pkg.go.dev/github.com/thegeeklab/wp-plugin-go/plugin#Metadata) + is exposed to the template and all fields can be referenced. To extend the functionality, [sprig functions](https://masterminds.github.io/sprig/) can also be used. + defaultValue: | + Status: **{{ .Pipeline.Status }}**
+ Build: [{{ .Repository.Owner }}/{{ .Repository.Name }}]({{ .Pipeline.Link }}){{ if .Curr.TargetBranch }} ({{ .Curr.TargetBranch }}){{ end }} by {{ .Curr.Author }}
+ Message: {{ .Curr.Message }} + type: string + required: false