核对交付记录
节点、配置、系统版本、租期和访问凭据必须与订单确认信息一致。
建立首个会话
先验证命令行连接,再按工作需要建立图形会话并测试断线恢复。
复现开发环境
锁定 Xcode、依赖工具和工作目录,不直接把旧机器全部文件原样覆盖。
提交真实构建
用实际仓库执行一次归档或测试任务,记录耗时、日志和产物校验结果。
收到设备信息后,先核对订单与物理节点,再完成连接、工具链复现和 CI 执行器注册。每一步都给出检查命令、完成标准与出错时需要保留的证据。
节点、配置、系统版本、租期和访问凭据必须与订单确认信息一致。
先验证命令行连接,再按工作需要建立图形会话并测试断线恢复。
锁定 Xcode、依赖工具和工作目录,不直接把旧机器全部文件原样覆盖。
用实际仓库执行一次归档或测试任务,记录耗时、日志和产物校验结果。
不要在信息尚未核对时开始搬迁环境。先登录控制台,逐项比对订单记录与设备详情;若字段不一致,保留页面信息并提交工单。
确认节点是新加坡、日本东京、韩国首尔、香港或美国东部之一。记录节点代码,并从主要办公网络测试连接路径。
目录包含两档,收到信息后应逐字段核对芯片、内存和存储。
核对系统版本、主机名、连接地址、端口和临时凭据。首次登录后立即按团队规范轮换凭据。
按天、周、月或季租用时,都应在开始前确定数据导出时间和任务停止点,避免把清理工作留到最后。
命令行适合做基础验收和自动化,图形会话适合 Xcode、模拟器及需要可视界面的操作。两种方式应分别验证,不把其中一种成功视为全部连接正常。
从控制台复制主机地址、端口和用户名,核对字符与大小写,不从旧工单复用过期信息。
首次连接时比对交付信息。指纹变化时先停止连接并确认原因,不直接删除本地记录后重试。
确认当前用户、主机名、系统版本、磁盘与 Xcode 路径,不立即安装或删除软件。
主动断开后重新连接,确认会话恢复方式、长任务托管策略和日志落盘目录。
先使用较低分辨率和色彩质量确认会话稳定,再逐步提高设置,避免把画面卡顿误判为设备性能问题。
禁止在共享屏幕、录屏或未受控剪贴板中暴露密码、私钥和证书口令。
离开设备前锁定图形会话。多人协作时明确同一时间的操作人,避免并发修改环境。
断线重连后检查前台应用、构建进程和磁盘写入是否仍在运行,不凭画面停顿判断任务已失败。
以下命令覆盖芯片、内存、磁盘、系统版本、网络和开发工具路径。运行后保存输出,但提交工单前应移除用户名、内部仓库地址和其他敏感字段。
printf '\n== CHIP ==\n'
system_profiler SPHardwareDataType | grep -E "Chip|Memory"
printf '\n== DISK ==\n'
diskutil info / | grep -E "Device Node|File System|Disk Size|Free Space"
printf '\n== SYSTEM ==\n'
sw_vers
uname -m
printf '\n== NETWORK ==\n'
route -n get default | grep interface
ping -c 5 1.1.1.1
printf '\n== XCODE ==\n'
xcodebuild -version
xcode-select -p
swift --version
printf '\n== TOOL PATHS ==\n'
command -v git
command -v ruby
command -v fastlane
环境一致性来自明确版本与可重复步骤,而不是把旧机器的整个用户目录复制过来。签名材料应最小化导入,并在租期结束前完成清理。
运行 xcodebuild -version,记录主版本与构建号;项目固定版本时,将要求写入仓库文档。
运行 xcode-select -p,必要时用团队批准的路径切换,不在任务中途临时升级。
仅导入当前项目需要的证书,使用受控传输方式,并限制钥匙串访问范围。
目标签名身份可被识别核对应用标识、团队信息、能力与有效状态,避免混用其他项目遗留文件。
归档目标匹配项目配置在构建脚本中按最小时间范围解锁,任务结束后恢复锁定,不把口令写入仓库或普通日志。
非交互构建可读取所需项先执行依赖解析、项目列表与签名设置检查,再开始完整归档。
失败发生在正式构建前每次只改变一个变量,并保留回退点。这样出现构建差异时,可以确认问题来自数据、依赖环境还是 CI 注册。
注册后至少验证一次冷缓存任务、一次热缓存任务和一次失败重试。工作目录、缓存与并发策略必须由流水线显式管理。
| 平台 | 注册检查 | 工作目录 | 缓存策略 | 并发建议 |
|---|---|---|---|---|
| GitHub Actions | 确认自托管 Runner 标签与目标仓库或组织范围 | 每个任务使用独立工作区,结束后清理临时文件 | 缓存键包含锁文件摘要、Xcode 与架构信息 | 先单任务验证,再依据内存和磁盘压力提高并发 |
| GitLab CI | 核对 Runner 标签、保护分支权限与执行器状态 | 避免多个项目共享可写目录和同名产物路径 | 按项目、分支与依赖摘要划分缓存范围 | 为归档、测试和轻量检查设置不同队列 |
| Jenkins | 确认节点标签、远程根目录和凭据作用域 | 流水线结束后清理 workspace,但保留必要日志 | 将依赖缓存与构建产物分开管理 | 限制重型归档任务同时占用同一设备 |
| 自建 Runner | 记录服务启动方式、运行用户和任务领取条件 | 按任务标识创建目录,退出时执行确定性清理 | 明确缓存所有者、容量上限和失效条件 | 用队列控制资源,不依赖脚本碰运气抢锁 |
执行器在线、标签匹配、运行用户正确,并且只能读取被授权的仓库与凭据。
同一提交在冷缓存与热缓存条件下都能得到一致产物,失败时保留明确退出码。
临时签名文件、派生数据和构建中间物有确定清理规则,不依赖人工逐项删除。
根据 CPU、内存和 SSD 压力设置队列,不让多个归档任务互相挤占资源。
性能问题至少记录发生时间、节点、任务提交版本、复现步骤和对照结果。只描述“很慢”无法区分资源压力、网络路径与图形会话问题。
记录高占用进程、线程数量和任务阶段。比较单任务与并发任务,检查是否存在重复构建、失控测试或后台索引。
记录峰值内存、压缩内存和交换变化。若任务只有并发时失败,应先降低并发再比较,而不是立即归因于网络。
检查剩余空间、派生数据、依赖缓存和历史产物。清理前先记录目录体积,避免删除后失去问题证据。
使用固定本地网络连续测试,并与备用网络对照。仓库拉取慢时还要区分节点路径和依赖服务响应。
降低分辨率和色彩质量后复测,同时通过命令行观察任务是否继续运行。记录重连后前台与后台状态。
凭据、签名材料、构建产物和缓存都有明确所有者。租期结束前按顺序导出、验证、移除和复查,不把清理工作交给临时记忆。
填写控制台中可用于定位订单的标识
新加坡、日本东京、韩国首尔、香港或美国东部
写明时区,并给出首次发生与最近复现时间
基础档或高配档,以及附加存储信息
从干净状态开始,按实际执行顺序逐项列出
附完整命令、退出码和脱敏输出,不只附截图
说明正常情况下应出现的状态、文件或返回值
说明偏差、复现次数以及是否影响全部任务
列出重试、重连、降并发或清缓存等动作及结果
基础档适合轻量构建和日常开发;高配档适合高内存实验、多项目并发和更重的构建任务。两档均为独享物理机、非虚拟机。