community_mailbot 0.1.1

王国钥匙

您需要从 community.lsst.org 和 Mandrill 获取 API 密钥。将它们设置为以下环境变量

• $MANDRILL_KEY（注意，使用 community_mailbot 子账户的 API 密钥）

• $DISCOURSE_KEY（Discourse 密钥应对应于具有足够权限的用户）

• $DISCOURSE_USER

可选地设置 $COMMUNITY_MAILBOT_CACHE 为您希望 Mailbot 跟踪其已转发主题的位置。

设置主题 → 电子邮件映射

为了设置如何将 Discourse 类别映射到接收者电子邮件地址，您需要知道每个相关类别的整数 ID。要获取这些信息，请运行附带的脚本

discourse_categories

如果您设置了上述环境变量，您就不需要向脚本提供任何参数。

接下来，创建一个 config.json 文件。它是一个简单的哈希结构；每个键值对是 Discourse 类别 ID 和该类别的电子邮件接收者列表。一般格式是

{
    "<id>": [{"email": "<email address>",
              "name": "<recipient name>",
              "type": "to"}],
}

值中的 dict 结构与 Mandrill send-template API 相匹配。通常，"type" 字段应该是 "to"，但也可能是 "cc" 或 "bcc"。

请注意，由于每个类别的接收者信息是一个 list，因此您可以拥有多个接收者。

预缓存旧主题

在机器人发送电子邮件之前，您希望它了解并忽略较旧的消息。为了预热缓存，我们将使用 --cache-only 选项运行 forward_discourse 脚本。

forward_discourse config.json --cache-only

请注意，forward_discourse 可以使用您已设置的环境变量进行配置。运行 forward_discourse --help 查看完整的选项集。

设置 cron 调度

当机器人定期监控 Discourse 站点的新主题时，它运行效果最佳。cron 是设置此功能的好方法。

创建一个 shell 脚本来包含所有脚本参数很有用。例如，创建一个名为 run_mailbot.sh 的脚本

#!/bin/bash
source /home/ec2-user/.bash_profile
source activate community_mailbot
forward_discourse /home/ec2-user/config.json

echo "$(date) Ran forward_discourse"

此脚本设置了 shell 环境，加载 Python 环境，然后运行邮件机器人。

然后指示 cron 每 10 分钟运行此脚本一次

首先，在终端中打开 crontab

crontab -e

并为机器人添加一行

*/10 * * * * /home/ec2-user/run_mailbot.sh

然后坐下来观看电子邮件流动。