An open API service indexing awesome lists of open source software.

https://github.com/visiky/dingtalk-release-notify

Auto push message to DingTalk while release published.
https://github.com/visiky/dingtalk-release-notify

Last synced: 2 months ago
JSON representation

Auto push message to DingTalk while release published.

Awesome Lists containing this project

README

        

DingTalk Release Notify

![](https://img.shields.io/github/workflow/status/visiky/dingtalk-release-notify/CI?style=flat-square)
[![](https://img.shields.io/badge/marketplace-dingtalk--release--notify-blueviolet?style=flat-square)](https://github.com/marketplace/actions/dingtalk-release-notify)
[![](https://img.shields.io/github/v/release/visiky/dingtalk-release-notify?style=flat-square&color=orange)](https://github.com/visiky/dingtalk-release-notify/releases)

## 🎩 Pre-requisites

Create a workflow .yml file in your .github/workflows directory. An example workflow is available below. For more information, reference the GitHub Help Documentation for Creating a workflow file.

## 💡 Inputs introduction

- `DING_TALK_TOKEN`: Webhook token of DingTalk (required). 备注:钉钉机器人的 access_token,在钉钉 im 上 `创建自定义机器人` 即可得到;支持多个 DingTalk Token,用换行符分隔。
- `owner`: The name of the owner of the repo. Used to identify the owner of the repository. Used when cutting releases for external repositories. Default: Current owner
- `repo`: The name of the repository. Used to identify the repository on which to release. Used when cutting releases for external repositories. Default: Current repository
- `notify_title`: Text describing the title of the release. Default: '👏 { repo } { release_tag } Released'
- `notify_body`: Text describing the body of the release. Default: '## { title } { body }'
- `notify_footer`: Footer text describing of the release. Default: '> 前往 [**{ repo }** { release_tag }]({ release_url }) 查看完整信息.'
- `at_all`: @ all in DingTalk.
- `enable_prerelease`: use prerelease notes content

## 🚀 Example workflow (how to use?)

**Simple usages:**

```yml
name: DingTalk Release Notify

on:
workflow_dispatch: # manual trigger workflow to nofify dingTalk
release:
types: [published, edited]

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: visiky/dingtalk-release-notify@main
with:
DING_TALK_TOKEN: ${{ secrets.DING_TALK_ACCESS_TOKEN}}
```

**Advanced usages:**

```yml
name: DingTalk Release Notify

on:
workflow_dispatch: # manual trigger workflow to nofify dingTalk
release:
types: [published, edited]

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: visiky/dingtalk-release-notify@main
with:
DING_TALK_TOKEN: ${{ secrets.DING_TALK_ACCESS_TOKEN }}
notify_title: '🎉 DingTalk Release Notify 发布 release {release_tag} 🎉' # Template of nofify title message in DingTalk
notify_body: '## { title }


![](https://gw.alipayobjects.com/zos/antfincdn/pJ5JP3Ntkd/2021-08.png)
{ body }
' # Template of nofify body message in DingTalk
notify_footer: '> 前往 [**G2Plot**]({ release_url }) 查看完整信息.' # Template of nofify footer message in DingTalk
at_all: false # whether to ding everybody

```

**Prerelease usages:**

```yml
name: DingTalk Release Notify

on:
release:
types: [published]

jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: visiky/dingtalk-release-notify@main
with:
DING_TALK_TOKEN: ${{ secrets.DING_TALK_ACCESS_TOKEN}}
enable_prerelease: true

```

## Preview

preview

## LICENSE

[MIT](./LICENSE)