karlkfi/pagerbot

PagerBot

PagerBot可根据PagerDuty排班自动更新Slack用户组的成员，并向选定频道发送消息通知当前轮换人员。

核心功能

• 基于PagerDuty排班同步Slack用户组成员（通过***匹配用户）
• 向指定Slack频道发送轮换变更通知
• 记录PagerDuty中存在但Slack未找到的用户警告

Docker镜像信息

本地构建

使用https://github.com/syndbg/goenv%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%EF%BC%9A

bash
goenv local

编译二进制文件：

bash
go build

二进制发布

使用https://github.com/mitchellh/gox%E4%BA%A4%E5%8F%89%E7%BC%96%E8%AF%91%EF%BC%9A

bash
# 安装gox
go get github.com/mitchellh/gox
# 构建二进制文件
gox -osarch "linux/amd64" -ldflags "-extldflags '-static'" -output "dist/{{.OS}}_{{.Arch}}/pagerbot"

也可从https://github.com/karlkfi/pagerbot/releases%E4%B8%8B%E8%BD%BD%E9%A2%84%E6%9E%84%E5%BB%BA%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82

Slack设置

1. 创建Slack应用
2. 在OAuth & Permissions中配置应用权限：
   • 以PagerBot身份发送消息（chat:write:bot）
   • 向特定频道发帖（incoming-webhook）
   • 访问工作区用户组基本信息（usergroups:read）
   • 修改用户组（usergroups:write）
   • 访问工作区用户资料（users:read）
   • 查看用户***（users:read.email）
3. 安装应用并复制OAuth Access Token（需工作区管理员权限）
4. 保存令牌：echo "SLACK_TOKEN=<token>" >> .secrets.env

PagerDuty设置

1. 创建只读PagerDuty API密钥（需账户管理员权限）
2. 保存密钥：echo "PAGERDUTY_KEY=<key>" >> .secrets.env
3. 保存组织名称：echo "PAGERDUTY_ORG=<org>" >> .secrets.env

配置说明

基础配置文件示例（YAML格式）：

yaml
api_keys:
  slack: "$SLACK_TOKEN" # Slack OAuth令牌
  pagerduty:
    org: "$PAGERDUTY_ORG" # PagerDuty子域名
    key: "$PAGERDUTY_KEY" # PagerDuty API密钥

groups:
- name: firefighter # 要更新的Slack用户组名称
  schedules: # PagerDuty排班ID列表
  - PAAAAAA
  - PBBBBBB
  update_message: # 可选通知消息（%s为成员列表逗号分隔）
    message: ":fire_engine: @paas-oncall 轮班变更：%s :fire_engine:"
    channels: # 发送通知的频道列表
    - paas

启动时指定配置和环境变量文件：

bash
./pagerbot --config /path/to/config.yml --env-file /path/to/.secrets.env

部署方式

Docker部署

bash
# 构建并标记镜像
docker build -t karlkfi/pagerbot:latest .
# 本地运行
docker run --env-file .secrets.env karlkfi/pagerbot:latest
# 推送至镜像仓库
docker push karlkfi/pagerbot:latest

Kubernetes部署

1. 创建加密Secret：

bash
kubectl apply -f - <<EOF
apiVersion: v1
kind: Secret
metadata:
  name: pagerbot-secrets
type: Opaque
data:
  slack-token: "$(grep 'SLACK_TOKEN' .secrets.env | cut -d'=' -f2 | tr -d '\n' | base64)"
  pagerduty-key: "$(grep 'PAGERDUTY_KEY' .secrets.env | cut -d'=' -f2 | tr -d '\n' | base64)"
  pagerduty-org: "$(grep 'PAGERDUTY_ORG' .secrets.env | cut -d'=' -f2 | tr -d '\n' | base64)"
EOF

2. 创建部署：

bash
kubectl apply -f deployments/kubernetes/deployment.yml