UDC 镜像仓库迁移踩坑记录

背景 一次把 UDC 相关仓库从外部 GitLab 源迁到内网 GitLab + Nexus 的迁移,踩了十来个坑。本文把每个坑的「现象 → 根因 → 修复」记下来,方便后续再做类似镜像同步时直接对照。迁移目标是:把外部源(记为 gitlab-cloud)的仓库改写成指向内网 GitLab 的 podspec,并同步 Maven 产物到内网 Nexus。 名词解释 Pull Mirror(GitLab 原生镜像):GitLab 自带的仓库镜像功能,让镜像仓库与上游完全一致。 Nexus:内网私有仓库(Maven / raw 等),用来托管同步过来的二进制与 Maven 产物。 Protected 变量:GitLab CI 变量标记为 Protected 后,只在保护分支 / 标签上注入。 members/all:GitLab 查组成员接口,带 /all 才会包含从父组继承的成员。 一、GitLab 原生镜像根本没法用 一开始想直接用 GitLab 自带的 Repository Mirroring(pull mirror),结果它和「改写 podspec URL」的需求天然冲突:原生 pull mirror 会让镜像仓库与上游完全一致,等于把我们在内网侧做的 podspec URL 改写每次同步都覆盖回去。而且源仓库里的 podspec 仍带外部域名,我们用的同步 bot 是源项目的只读成员,push 回源会 403 “not allowed to upload code”——源仓库修不了。 ...

October 21, 2026

GitLab macOS Runner 构建成功后卡死 27 分钟排查

背景与现象 某条 iOS 主工程的 MR 流水线,构建 job 在 Build Succeeded 之后,卡在 Cleaning up project directory and file based variables 约 27 分钟,GitLab 页面一直显示 running(14:57 构建完成,15:24 才上报 success)。编译本身只花了约 8 分钟——卡的是 job 收尾阶段,而且最终自行成功,属于「假死」而非失败。 名词解释 GitLab Runner:执行 CI job 的 agent 进程;concurrent 控制同一台机器上能并行跑几个 job。 DerivedData:Xcode 的构建中间产物目录,体积大、文件多。 CAS(Content Addressable Storage):Xcode 编译缓存,按内容寻址,默认无清理上限。 launchd:macOS 的系统服务管理器,相当于开机自启 + 定时任务(类似 cron,但睡眠错过会自动补跑)。 排查过程(逐层排除) 磁盘 / inode:盘仅 66% 使用、300G+ 可用、inode 充足 → 排除磁盘满。 日志定位卡点:日志尾部 Build Succeeded → after_script → Saving cache 全部完成,最后沉默在收尾清理段 → 卡的是 runner 清理,不是编译。 自研探针一次采齐(gitlab-runner-probe.sh):runner 配置 concurrent = 3;builds 目录 131G(DerivedData 56G + 编译缓存 49G + checkout 22G);项目 checkout 仅 2.4G / 6 万文件,清理对象本身很小;事发时 load average 16/26/25,空载后回落到 5.65 → 负载与 CI 活动强相关;swap used 1.8G → 内存曾吃紧;删除微基准:6 万小文件 rm -rf 仅 2s → 排除文件系统删除吞吐问题。 时间线对齐:该 job 的清理窗口(14:58–15:24)与同 runner 上另一个 KMP 重构建 job(14:58–15:11)完全重叠。 根因定位 直接原因:同机并发超载。 concurrent=3 下,KMP 链接等重 job 把 CPU / IO / 内存打满(load 25+、动用 swap),收尾清理这种秒级小活被拖成 27 分钟。 ...

October 19, 2026

GitLab SAST 在 ARM64 Runner 上的故障复盘

背景与目标 把 Semgrep SAST 接到 iOS 工程的 CI 上,原本的扫描 job 一直跑不通。本文记录从 Rosetta 崩溃到原生 ARM64 镜像上线的全过程,以及其间踩到的十几个坑。结论是:本机 / 流水线显示「非阻断成功」都不算验收通过,真正的完成标准是——正式 job 执行成功、新报告有效、GitLab 解析成功、目标分支配置一致。 名词解释 SAST(Static Application Security Testing,静态应用安全测试):不运行程序,靠扫描源码发现安全缺陷。 Semgrep:一款开源的静态分析 / SAST 引擎,GitLab 官方 SAST analyzer 底层就用的它。 Rosetta:Apple 在 ARM64 macOS 上转译运行 AMD64 二进制的兼容层;转译路径异常时会有看不懂的分配错误。 ARM64 / AMD64:两种 CPU 指令集架构。混用会导致需要转译,转译层出问题是本次故障根源。 gl-sast-report.json:GitLab SAST 的标准报告文件,有官方 schema 校验。 最终结果(验收口径) 修复后,正式 semgrep-sast job 切换到固定 digest 的原生 ARM64 镜像。正式 job(Runner 13 上)成功运行;285 条规则扫描 2209 个文件,产生 111 条原始发现;gl-sast-report.json 状态为 success 并通过官方 schema 校验;服务端确认扫描 SUCCEEDED、errors=[]。 ...

October 16, 2026

把 GitHub 依赖迁移到内网 GitLab 的踩坑总结

背景 公司内网环境极差,外网访问几乎不可达,打包机几乎拉不到 GitHub 上的依赖,所以才把一部分依赖镜像到内网 GitLab,供打包机使用。加上部分仓库很大(如 Alamofire、lottie-ios),迁移过程中集中爆发了一批问题。 补充两点前置配置经验: 如果仓库是 Private 的,外部匿名拉取(不携带 token、cookie 等)会失败。需要在 General Settings - Visibility, project features, permissions - Package registry 下打开 Allow anyone to pull from Package Registry; 往 Pod Spec 仓库推送代码,需要 Maintainer 权限的账号,否则无法 push。 对于超大仓库,在网络环境差的情况下 git push --mirror 很容易出现 504 错误,只推我们用到的 tag 即可。 本次迁移踩坑总结 1. Shallow clone 无法推送 Tag GitLab 报 shallow update not allowed,需要先 git fetch --unshallow,再推送标签。 2. Git LFS 对象缺失 GitLab 会拒绝推送并提示 LFS objects are missing,必须同步并执行 git lfs push --all。 ...

October 12, 2026

GitLab 上 KMP 二进制的发布链路与踩坑

背景 把 Kotlin Multiplatform 共享库以 XCFramework 形式发给 iOS 侧使用时,发布链路并不只是「编出来传上去」。它涉及 XCFramework 构建、二进制归档、私有 CocoaPods Specs 仓库、GitLab 包 registry,以及一连串的权限与凭据隔离问题。这里把一次完整发布踩过的坑整理成可复用的清单。 推荐发布链路 flowchart LR A[构建 XCFramework] --> B[打包 ZIP + SHA256] B --> C[生成二进制 Podspec] C --> D[上传 GitLab Generic Package] D --> E[匿名下载并校验 ZIP/SHA] E --> F[pod spec lint] F --> G[push Podspec 到私有 Specs Git] G --> H[重新 clone / readback] H --> I[干净 Podfile 执行 pod install] 名词解释 XCFramework:Apple 的跨平台 / 多架构二进制分发格式,可同时携带真机与模拟器 slice。 Podspec:CocoaPods 的依赖描述文件,声明版本、源码 / 二进制地址与校验和。 Specs 仓库:存放 Podspec 的私有 Git 仓库,相当于私有 CocoaPods 源。 Generic Package Registry:GitLab 提供的通用二进制包仓库,用来托管 ZIP 等任意产物。 Project Access Token:GitLab 的项目级访问令牌,区别于个人令牌,可限定角色与权限范围。 1. 版本必须全链路一致 以下字段必须保持一致:Git tag、VERSION_NAME、Podspec 的 version、Package Registry 路径、ZIP 文件名、checksum sidecar 文件名,以及 Specs 路径(如 UgreenHomeShared/1.7.0.4/UgreenHomeShared.podspec)。 ...

September 22, 2026