首次开通
从订单确认到首次验收
核对所选机型、机房和租期，等待自动准备与凭据签发。首次进入后记录节点信息，并分别验证命令行、图形界面和 Xcode 环境。
- 确认订单状态与到期时间
- 核对主机指纹后建立首个会话
- 保存验收结果，不保存明文凭据
按任务定位问题
云端 Mac 帮助中心：从连接到构建逐项排查
先确定问题属于开通、连接、工具链、流水线、存储还是租期，再按节点信息、凭据、端口、磁盘与系统任务依次核对。每条路径都给出检查对象、可执行动作和升级工单所需信息。
- 6 类任务
- 开通、连接、工具、CI/CD、存储、租期
- 5 步诊断
- 从节点范围缩小到具体任务
- 2 种支持入口
- 控制台工单与支持邮箱
诊断登记板
顺序检查
先记录事实，再改变配置
-
01
核对订单节点 记录机房、主机名与订单状态
-
02
确认凭据状态 检查密钥、有效期与最近轮换
-
03
验证网络路径 区分 DNS、端口与本地网络问题
-
04
查看资源余量 检查磁盘空间、内存与后台任务
-
05
保留脱敏证据 收集时间、命令、退出码与日志片段
建议记录
节点 · 时间 · 命令 · 退出码
任务入口
按当前要完成的工作进入对应路径
不必从头阅读全部文档。先选择最接近的任务，再按卡片中的核对顺序执行。涉及订单状态、到期时间和凭据的事实，以控制台当前显示为准。
远程连接
建立 SSH 或 VNC 会话
SSH 适合命令行、自动化和隧道任务；VNC 适合需要 macOS 图形界面的操作。先核对节点与凭据，再检查本地网络和端口。
- 首次连接必须核对主机指纹
- 断线时先区分本地网络与节点会话
- 共享设备不保留敏感连接资料
开发工具
确认 Xcode 与构建环境
用命令记录 Xcode 版本、活动开发者目录和工具链状态。修改版本前先保留当前输出，避免把项目问题与环境变化混在一起。
- 记录
xcodebuild -version输出 - 确认项目、依赖与缓存所在磁盘
- 清理前先保留完整错误摘要
CI/CD
验证 self-hosted runner
先确认 runner 在线、标签匹配和工作目录权限，再运行最小测试任务。不要一开始就重跑整条流水线，否则难以定位失败环节。
- 核对 runner 标签与任务条件
- 验证工作目录和缓存目录权限
- 保留失败任务的退出码与脱敏日志
存储管理
处理空间、缓存与扩展需求
先区分项目文件、依赖缓存、构建产物和日志占用。空间持续增长时，再根据真实增量选择 +1TB SSD、+2TB SSD 或调整清理策略。
- 检查剩余空间与最大目录
- 区分可重建缓存和业务数据
- 扩展前完成重要数据备份
租期管理
核对续租、到期与迁出
控制台中的订单到期时间是操作基准。续租后再次核对状态；计划结束租用时，提前迁出代码、密钥、证书、日志和业务数据。
- 记录当前到期时间与所需周期
- 续租完成后重新检查订单状态
- 离场前执行备份、撤钥与清理
快速诊断器
选择当前失败的检查项
按从外到内的顺序检查。点击最早失败的一项，登记板会给出优先处理路径。若前一项尚未确认，不建议跳到后续步骤直接修改系统配置。
诊断前准备
- 记录问题发生时间与节点所在机房
- 保留原始命令、退出码和脱敏日志
- 一次只改变一个变量，并记录结果
检查顺序
01—05
处理路径
从第 01 项开始检查
先在控制台核对订单状态、目标机型与机房。确认记录一致后，再继续检查凭据、端口、磁盘和系统任务。
记录：节点 / 时间 / 现象 / 最近变更
构建问题
先固定工具链，再处理项目状态
构建失败通常不是单一变量导致。先记录工具版本与执行环境，再处理签名、缓存、自动化日志和 runner 条件，可以避免清理动作覆盖真正的错误证据。
确认 Xcode 版本
执行版本查询并记录活动开发者目录。若项目指定版本与当前环境不同，先确认兼容范围，再进行切换。
xcodebuild -version
xcode-select -p
swift --version验收：版本、路径与项目要求一致
检查签名环境
确认构建任务能读取所需证书、描述文件与环境变量。工单和日志中只保留名称、时间和错误摘要，不提交有效密钥。
security find-identity -v -p codesigning
env | sort验收：目标签名项可见且权限正确
有边界地清理 DerivedData
先保存首次失败输出，再只清理目标项目相关目录。不要把全盘清理作为第一步，否则会增加下一次构建耗时并丢失对照信息。
du -sh ~/Library/Developer/Xcode/DerivedData
df -h验收：释放空间后错误可稳定复现或消失
定位 Fastlane 失败环节
按 lane、action 与底层命令三层拆分日志。记录第一处真实错误、退出码和运行目录，不只截取最后一行汇总。
bundle exec fastlane lane_name --verbose
echo $?验收：能指出失败 action 与首个错误
核对 runner 标签与权限
确认 self-hosted runner 在线，任务标签与 runner 标签完全匹配，并验证执行用户对工作目录、缓存目录和构建目录具有正确权限。
whoami
pwd
ls -ld .
df -h验收：最小测试任务能够领取并完成
租期与资源
把到期时间、存储增长和并联需求分开管理
续租解决使用期限，存储扩展解决容量，Thunderbolt 5 并联解决特定多机工作流。三者是独立选项，操作前应分别记录当前状态和目标结果。
续租与到期时间
在控制台的订单记录中查看当前到期时间，选择续租周期并完成结算。续租后重新打开订单核对状态与新到期时间，不以本地日历提醒代替订单事实。
- 操作位置
- 控制台的订单与租期记录
- 操作前
- 记录当前到期时间和所需周期
- 操作后
- 核对订单状态与更新后的到期时间
存储扩展
先用目录占用和增长速度判断需求。可重建缓存应优先清理；代码、签名材料、构建产物和业务数据应先备份，再决定是否增加容量。
- +1TB SSD
- 持续增长的依赖、缓存和构建产物
- +2TB SSD
- 多项目、大型资产或更长留存周期
- 操作位置
- 控制台订单的可用附加选项
Thunderbolt 5 并联
适用于明确需要多台设备协作的工作流。下单前记录设备数量、连接目标、数据路径和验收方式；每台并联选项独立计价。
- 确认对象
- 参与并联的每台物理节点
- 验收条件
- 目标设备可识别、链路稳定、任务可执行
- 操作位置
- 配置订单时选择对应附加项
| 附加选项 | 每天 | 每周 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.9 | $7.9 | $14.6 | $39.7 |
| +2TB SSD | $5.8 | $15.8 | $29.2 | $79.4 |
| Thunderbolt 5 并联（每台） | $1.1 | $2.9 | $5.3 | $14.4 |
术语小词典
八个常见术语，用操作边界来解释
术语的价值在于帮助团队对齐操作范围。下面的定义聚焦于实际使用，不把产品名称、连接协议和自动化角色混为一谈。
- 云端 Mac
- 通过网络远程使用的 Mac 资源。ArmCLI 的云端 Mac 对应可远程连接的 Apple Silicon 物理节点，可用于开发、构建、测试和实验。
- 物理节点
- 实际交付的一台硬件设备。节点信息包括机房、主机名、连接资料和订单状态，排查问题时应先确认操作对象。
- 独享
- 一个订单对应一台独享物理机，租户之间不共享操作系统实例。用户仍需管理自身进程、权限、密钥和业务数据。
- 非虚拟机
- 计算任务直接运行在所租用的物理节点上，而不是与其他租户共享同一个虚拟化操作系统实例。
- VNC
- 用于远程查看和操作 macOS 图形界面的连接方式。适合需要窗口、模拟器或图形工具的任务，连接资料从控制台订单中获取。
- SSH
- 用于命令行连接、文件传输、端口转发和自动化任务的协议。首次连接应核对主机指纹，并优先使用密钥认证。
- self-hosted runner
- 由团队自行注册并运行在云端 Mac 上的流水线执行器。任务能否领取取决于在线状态、标签条件、权限和工作目录配置。
- 构建缓存
- 为了减少重复下载和编译而保留的中间数据。缓存可提高重复任务效率，但需要容量预算、失效策略和定期检查。
- 01 轮换密钥 发生人员变动、设备丢失、凭据误传或异常登录迹象时，撤销旧密钥并签发新密钥。
- 02 收紧权限 构建任务只获得完成工作所需的目录、命令和环境变量权限，不使用长期高权限凭据替代配置。
- 03 退出异常会话 检查当前用户、活动终端和后台进程，结束无法解释的会话，并记录时间与相关任务。
- 04 脱敏日志 保留命令、时间、退出码和错误上下文，删除访问令牌、私钥、证书内容、业务数据和内部地址。
- 05 完成离场清理 迁出代码与业务数据，撤销远程密钥，删除临时缓存和敏感文件，并在控制台核对租期状态。
升级支持路径
三步提交可复现、可核对的问题
信息越完整，越容易跳过重复确认。先完成任务文档中的最小检查，再提交节点、时间、命令和脱敏日志。
-
01
先执行对应任务文档
确认问题属于连接、工具链、CI/CD、存储还是租期。记录已经完成的步骤和每一步结果，不在同一次测试中同时修改多个变量。
-
02
准备最小问题包
包含节点与机房、发生时间、执行命令、退出码、第一处错误、最近变更和已尝试步骤。日志必须先完成脱敏。
-
03
通过控制台提交工单
已持有订单时优先使用控制台工单，使问题与节点和服务记录关联。购买前问题或无法进入控制台时，可联系服务团队。
紧急问题如何描述
在主题中写明“无法连接”“构建阻塞”或“订单状态异常”，正文提供节点、开始时间、影响任务和脱敏证据。不要在公开渠道发送有效凭据。
准备开始
选定任务规模后，直接配置独享物理 Mac
三档在售机型覆盖新加坡、日本（东京）、韩国（首尔）、香港、美国东部五个机房。具体可用状态以控制台实时返回为准。