#systemd-unit #systemd #dbus #unit #config-file

app killjoy-notifier-slack

代表 killjoy 发送关于单元状态变化的 Slack 消息

5 个版本

0.2.3 2023 年 7 月 7 日
0.2.2 2021 年 11 月 28 日
0.2.1 2021 年 11 月 27 日
0.2.0 2021 年 11 月 27 日
0.1.0 2021 年 11 月 24 日

命令行工具 中排名 1819

GPL-3.0-or-later

29KB
187

killjoy Notifier: Slack

代表 killjoy 生成 Slack 通知。

killjoy 是一个 systemd 单元监控应用程序。它发现 systemd 单元并跟踪其状态。当一个单元变为感兴趣的状态时,killjoy 会联系通知器。此应用程序是一个通知器,当被 killjoy 联系时,将使用 webhook 发布 Slack 消息。

此通知器的代码部分基于 https://github.com/Ichimonji10/killjoy-notifier-notification

概念

首先,阅读 killjoy 文档中的概念部分。

安装正确后,每当有 D-Bus 消息发送到它时,此应用程序将自动启动。启动后,此应用程序将消耗其消息队列中的所有消息(可能是来自 killjoy),然后闲置。

安装

Rust 开发者可以从源代码安装此应用程序。请注意,必须安装 libdbus。 (在 Ubuntu 上,这是由 libdbus-1-dev 包提供的。)

git clone https://github.com/kennep/killjoy-notifier-slack.git
cd killjoy-notifier-notification
cargo build

注意:不包括 systemd 单元脚本或安装脚本。可以从 https://github.com/Ichimonji10/killjoy-notifier-notification 等脚本开始使用。

配置

此通知器期望在主 killjoy 配置文件所在的同一目录中安装一个名为 slack-notifier.json 的配置文件。

以下是一个包含所有配置键的示例配置文件

{
    "webhook_url": "https://hooks.slack.com/services/YOUR_UNIQUE_WEBOOOK_URL",
    "username": "My user",
    "channel": "Channel name",
    "icon_emoji": ":robot_face:"
}

webhook_url 键是必需的,包含您的 Slack webhook URL。 usernamechannelicon_emoji 键是可选的。如果存在,它们指定要发布为的用户名、要发布的频道和要使用的表情符号。

如果 usernamechannel 不存在,则使用 Slack webhook URL 的默认值。如果 icon_emoji 不存在,则使用 :robot_face: 作为表情符号。

用法

在 killjoy 的配置文件中定义一个通知器

"slack": {
    "bus_type": "session",
    "bus_name": "com.wangpedersen.KilljoyNotifierSlack1"
}

然后,将其列在规则的通知器列表中的 notifiers 中。

当此应用程序接收到消息时,它将生成一条 Slack 消息。

更新日志

查看注释的 git 标签。

许可证

此应用程序根据 GPLv3 或任何后续版本进行授权。

依赖项

约 13–26MB
约 437K SLoC