跳转到主要内容
首次接入 Flashduty 状态页时,您可以从零创建一个新状态页,也可以从 Atlassian Statuspage 迁移到 Flashduty 状态页。本文分别说明这两种接入路径的必要步骤。 状态页创建或迁移完成后,组件、分组、事件模板、订阅和事件发布都属于后续配置。您可以在本文末尾跳转到对应文档。 如果您还不了解状态页的基本概念,先阅读什么是状态页。

选择接入方式

如果您正在评估是否替换 Atlassian Statuspage,可以先阅读状态页对比。

从零创建状态页

从零创建只需要先建立一个状态页实体,并确认页面标题、访问地址和页面类型。创建后的品牌、域名、组件、订阅和事件发布配置,请在后续文档中完成。
1

选择状态页类型

登录 Flashduty 控制台,在左侧导航进入 On-call → 状态页面,点击 创建公开页面 或 创建内部页面。公开状态页面向客户、合作伙伴和外部访客;内部状态页面向组织成员,需要登录 Flashduty 后访问。
2

填写创建信息

按页面提示填写以下字段:
3

完成创建

点击 创建 完成创建。页面创建后,再按实际需要配置基础信息、组件、订阅、模板和事件发布流程。

从 Atlassian Statuspage 迁移

如果您已经在使用 Atlassian Statuspage,可以使用 Flashduty CLI 将组件、分组、历史事件和订阅者迁移到 Flashduty 状态页。
版本要求:迁移功能(结构与历史迁移、订阅者迁移)需要 Flashduty 专业版。
迁移分为两个独立步骤:
  1. 迁移结构与历史:导入组件、分组、历史事件、维护记录和通知模板。
  2. 迁移订阅者:导入邮件订阅者(并尽可能顺带迁移 Microsoft Teams Workflows 频道订阅者)及其订阅偏好。
两步分离的原因是:迁移结构时不会向订阅者发送通知。您可以先检查导入内容是否正确,再决定是否导入订阅者。导入的订阅者会直接变为活跃状态,无需重新邮件验证。
如果您使用 Codex、Claude Code、Cursor 等 AI 编程代理,也可以先按 flashduty-cli README 中的 Agent Skills 指引安装技能。安装后,flashduty skill(内置状态页参考文档)会向代理提供迁移命令和注意事项,代理可以在本地终端协助您完成迁移。

准备工作

安装 Flashduty CLI

更多安装方式请参考 CLI 文档。

登录 Flashduty

按提示输入 APP Key。获取方式:登录 Flashduty 控制台,进入 个人中心 → APP Key,创建并复制 APP Key。密钥仅在创建时显示,请妥善保存。

获取 Atlassian Statuspage API Key

  1. 登录 Atlassian Statuspage 管理面板
  2. 进入 User icon → API info,复制 API Key
  3. 设置环境变量:

获取 Atlassian Statuspage Page ID

在 Atlassian Statuspage 管理面板中,Page ID 显示在页面 URL 或页面设置中。格式类似 0db0rq26tg1l。

迁移步骤

建议先迁移结构和历史,再迁移订阅者,最后切换域名。
1

迁移结构与历史

执行以下命令导入 Atlassian Statuspage 的组件、分组、历史事件、维护记录和通知模板。此步骤会创建或复用 Flashduty 目标状态页。
--url-name 仅在本次迁移创建新的目标状态页时生效。如果同一个 --source-page-id 已经在历史迁移中映射到一个已存在的目标状态页:
  • 省略 --url-name,或传入与已存在目标状态页完全一致的值,迁移会复用该目标页继续执行。
  • 传入与已存在目标页不同的值,迁移会在预检阶段失败。如需更改 URL 名称,请在 Flashduty 控制台直接编辑目标状态页。
--url-name 的格式与唯一性要求:
  • 自动规范化为小写、用连字符连接,长度不超过 255 个字符;纯符号或规范化后为空的输入会被拒绝。
  • 在账号下的公开状态页范围内全局唯一,重复时会被拒绝。
2

查询迁移进度

迁移任务为异步执行,命令会立即返回一个 Job ID。使用以下命令查询进度:
结构与历史迁移会依次完成 5 个步骤:创建(或复用)目标状态页 → 导入分组(sections)→ 导入组件(components)→ 导入历史事件(incidents,含维护记录)→ 导入事件模板(templates)。任务完成后,输出中的 target_page_id 即为 Flashduty 状态页 ID,后续迁移订阅者时需要使用。如果需要取消正在运行的迁移任务,执行:
3

验证导入内容

在进行下一步之前,建议检查导入的内容:
您也可以登录 Flashduty 控制台,在状态页管理界面中检查组件、分组和历史事件是否完整。
4

迁移订阅者

确认结构和历史导入正确后,执行订阅者迁移:
各渠道订阅者的迁移处理规则:
  • 邮件:直接导入并立即生效,无需重新邮件验证;已在 Atlassian 端被标记为隔离(quarantined)的邮箱会被自动跳过。
  • Microsoft Teams(Workflows):若源订阅者带有可导出的新版 Teams Workflows Webhook URL(*.logic.azure.com / *.environment.api.powerplatform.com),系统会自动尽力迁移,并在导入成功后自动开启目标公开状态页的 Teams 订阅开关。使用微软已下线的旧版 Office 365 Connector 地址(*.webhook.office.com)或未导出 Webhook URL 的 Teams 订阅者会被跳过,并在 migration-status 的告警中提示重建 Workflows Webhook。
  • Slack:由于 Atlassian Statuspage API 不导出 Slack OAuth Token 或 Webhook 地址,Slack 订阅者无法自动迁移,会跳过并在 migration-status 的告警中汇总;迁移后在目标状态页开启 Slack 订阅,由订阅者通过 订阅更新 → Slack 重新授权即可。
  • SMS 及其他不支持的方式:自动跳过。
订阅者迁移具备幂等性,可以安全地多次执行,已存在的订阅者不会被重复导入。
5

切换域名和 RSS/Atom

如果原 Atlassian Statuspage 使用自定义域名,将 CNAME 记录切换到 Flashduty 提供的状态页地址。Flashduty 兼容 history.rss 和 history.atom 链接格式,原 RSS/Atom 订阅可继续生效。自定义域名配置请参考配置状态页基础信息。RSS/Atom 订阅规则请参考订阅管理。

继续配置

完成创建或迁移后,按目标进入对应文档。这里不再重复展开每个功能的配置步骤。