Technology · 实用指南
Docker pull 报 manifest unknown？清理前先证明远端引用
保存展开后的 registry、repository、tag 或 digest；先证明远端 descriptor 与认证视图，再清缓存或改平台。
manifest unknown 不是本地缓存的泛化错误，而是 registry 对请求名称和 tag 的结果。
按引用、descriptor、平台和运行环境依次核验，避免误修。
保存展开后的镜像引用
复制完整错误和实际命令，记录 registry、namespace、image、tag 或 digest，并打印 CI 变量。
不要先 prune 或清 builder cache；本地删除无法创建远端 manifest。
拆开短名称的默认值
把引用拆为 registry、repository、image、tag；未写 tag 时通常请求 latest。
逐字比较大小写、分隔符和变量；登录或别的 tag 成功不能证明本引用存在。
拉取前查询 tag 与 descriptor
用 registry UI 或认证的 inspect 查询精确 tag，记录 digest 与 media type。
若已固定 digest 就直接查询 digest；保留失败引用，不要凭空编 digest。
分离 tag 查找和平台选择
tag 指向 index 时检查目标 OS/architecture descriptor；缺平台是另一分支。
不要因一个平台能拉取就假设另一个存在；只按 workload 选择或发布平台。
核验 CI、mirror 与私库视图
交互成功但 CI 失败时比较展开字符串、凭据、hostname、proxy 与网络路径。
最终在同一 runtime 和 registry 路径证明精确 tag/digest 可解析，并记录 descriptor。
