kevholditch/pagerduty-slack-sync

PagerDuty-Slack同步工具镜像

镜像概述

本镜像是一款用于自动同步PagerDuty值班计划与Slack群组的工具，旨在解决团队值班信息在Slack中的实时同步问题，避免手动更新带来的繁琐操作和信息延迟，确保团队成员能及时获取当前值班人员信息。

核心功能与特性

• 自动同步：定期或触发式同步PagerDuty值班计划数据至Slack
• 实时更新：当PagerDuty值班计划发生变更时，自动更新Slack群组中的值班信息
• 配置灵活：支持自定义同步间隔、目标Slack频道等参数
• 轻量部署：基于Docker容器化部署，简化环境配置与维护

使用场景与适用范围

• 运维团队：实时同步值班工程师信息，便于紧急事件快速响应
• 开发团队：同步项目值班人员，确保问题能及时对接负责人
• 任何使用PagerDuty和Slack的团队：需要在Slack中集中展示值班信息的场景

使用方法与配置说明

前提条件

• 拥有PagerDuty账号及API访问权限（需创建API密钥）
• 拥有Slack工作区及API令牌（需具备发送消息至指定频道的权限）
• 已获取PagerDuty值班计划ID和目标Slack频道ID

环境变量配置

Docker部署示例

1. 使用docker run命令部署

bash
docker run -d \
  --name pagerduty-slack-sync \
  -e PAGERDUTY_API_KEY="your_pagerduty_api_key" \
  -e PAGERDUTY_SCHEDULE_ID="PABC123" \
  -e SLACK_API_TOKEN="xoxb-1234567890-abcdefghijklmnopqrstuvwxyz" \
  -e SLACK_CHANNEL_ID="C12345678" \
  -e SYNC_INTERVAL=1800 \
  pagerduty-slack-sync:latest

2. 使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  pagerduty-slack-sync:
    image: pagerduty-slack-sync:latest
    container_name: pagerduty-slack-sync
    environment:
      - PAGERDUTY_API_KEY=your_pagerduty_api_key
      - PAGERDUTY_SCHEDULE_ID=PABC123
      - SLACK_API_TOKEN=xoxb-1234567890-abcdefghijklmnopqrstuvwxyz
      - SLACK_CHANNEL_ID=C12345678
      - SYNC_INTERVAL=1800
      - LOG_LEVEL=info
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

验证与日志

查看容器运行状态：

bash
docker ps | grep pagerduty-slack-sync

查看同步日志：

bash
docker logs -f pagerduty-slack-sync

注意事项

• 确保PagerDuty API密钥具有访问值班计划的权限
• Slack API令牌需包含chat:write权限以发送消息至指定频道
• 同步间隔建议根据值班计划更新频率设置，避免过于频繁的API请求
• 如同步失败，可通过日志排查API密钥、ID配置是否正确或网络连接问题