安装与排查 Jira 集成
配置 Jira Cloud、GitHub 应用、GHE.com 数据驻留和个人 SSO 授权。
Jira 集成同时依赖 Atlassian Forge 应用和 GitHub App。只完成其中一侧安装，不能保证用户已经能够从工作项启动 cloud agent。
必要条件
- 付费 Copilot 访问。
- Jira Cloud 账号，Jira 已启用 AI，组织已激活 Rovo。
- 安装者具有 Jira site administrator，以及 GitHub organization owner 或 GitHub App manager 权限。
- 用户完成个人连接，并对目标仓库有写权限。
这些前提针对 Jira Cloud；官方此页没有提供 Jira Server/Data Center 安装流程。
GitHub.com 安装
- 在 Atlassian Marketplace 打开 GitHub Copilot for Jira，选择 Get it now。
- 选择 Atlassian site，检查安装详情并完成安装。
- 点击安装确认中的 Configure，继续到 GitHub 授权；也可从 GitHub App 页面进入安装。
- 登录 GitHub，按需要建立活跃 SAML 会话并授权。
- 选择组织与应用可访问的仓库，排除不应开放的范围，再完成安装。
- 回到 Jira 应用配置，确认已连接的组织。
GHE.com 数据驻留
使用单独的 GHEC with Data Residency 应用。安装前在其配置中填写 SUBDOMAIN.ghe.com，保存后再选择 site 安装。
后续通过 Jira 的 Configure 完成企业授权；未自动跳转时，从企业的 SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira 安装入口继续。组织、仓库选择与 SAML 前提仍需满足。
这里的 GHE.com 数据驻留入口不等于 GitHub Enterprise Server 支持承诺。
增减组织
Jira 管理员和 GitHub organization owner 可在 Jira 工作空间设置的 GitHub Copilot 应用页管理已连接组织。通过 Connect More GitHub Organizations 添加，并启用或禁用对应组织。
若初始安装后新增 SSO 保护组织，用户需为该组织建立新的活跃 SAML 会话，才可从 Jira 触发其仓库任务。
常见问题
| 现象 | 检查方向 |
|---|---|
| 看不到 Copilot 或无法分配 | Atlassian 管理中是否为 Jira 启用 AI，Rovo 和应用安装是否完成 |
| 看得到但自己不能分配 | Jira 个人账号设置中的 GitHub Copilot for Jira 是否登录并授权 |
| 别人能用、自己不能 | GitHub SSO 会话、个人应用授权和仓库写权限 |
| 无响应 | GitHub/Atlassian 服务状态、cloud agent 是否能在 GitHub Issue 正常分配、App 是否被授予该仓库 |
SSO 排障可在 GitHub 组织设置中重新 Sign out / Sign in，再回 Jira 刷新。官方说明企业统一 SSO 时，登录其中一个组织可建立相应企业组织的会话。发起工作后的使用和 PR 迭代见Jira 工作流程。