Docker 与 Swift：高级应用容器化

引言：为什么 Swift 容器化既是挑战也是优势

长期以来，为 iOS 和 macOS 容器化 Swift 应用被认为是爱好者的领域。与 Go 或 Node.js 不同，Swift 需要在目标平台上进行编译，而官方的 Docker 镜像在很长一段时间内都显得很另类。然而，随着 Swift 5.x 的发布以及官方镜像 swift:5.10（及更新版本）的出现，情况发生了根本性的变化。如今，Docker 不仅可以用于运行基于 Vapor 的服务器后端，还可以自动化构建 CLI 工具、在隔离环境中测试代码，甚至为部署到 macOS 准备二进制工件。

在本文中，我们将深入探讨高级技术：多阶段构建、依赖关系的激进缓存、镜像大小优化以及与 Swift Package Manager 的集成。示例面向实际项目——从简单的 HTTP 服务器到复杂的微服务。

1. 多阶段构建：分离编译与运行时

新手常犯的一个错误是使用同一个镜像进行构建和运行。结果，由于包含了 SDK、工具和源代码，镜像大小超过 2 GB。正确的方法是分两个阶段：构建阶段和运行阶段。

Vapor 应用的 Dockerfile 示例

# 阶段 1：构建\nFROM swift:5.10 AS builder\nWORKDIR /app\nCOPY Package.swift Package.resolved ./\nRUN swift package resolve --cache-path .build/artifacts\nCOPY Sources Sources\nCOPY Tests Tests\nRUN swift build -c release --static-swift-stdlib\n\n# 阶段 2：最小化运行时\nFROM ubuntu:22.04\nRUN apt-get update && apt-get install -y libicu70 libxml2 ca-certificates && rm -rf /var/lib/apt/lists/*\nWORKDIR /app\nCOPY --from=builder /app/.build/release/Run .\nEXPOSE 8080\nCMD ["./Run"]

关键点：

\n
• 依赖缓存 — 在复制源代码之前，先复制 Package.swift 和 Package.resolved。Docker 会缓存这一层，当仅修改代码时，只会重新构建二进制文件。
\n
• --static-swift-stdlib 标志 — 静态链接 Swift 标准库。这降低了对运行时的要求，但会使二进制文件大小增加约 30%。
\n
• 最小化镜像 — 使用包含必要系统库（libicu、libxml2）的 Ubuntu。最终镜像大小 小于 150 MB，而单阶段构建则为 2 GB。
\n

2. 通过 BuildKit 和 SSH 代理实现激进缓存

在 CI/CD（GitHub Actions、GitLab CI）环境中工作时，每次运行都会重新下载依赖项。使用 Docker BuildKit 来挂载 Swift PM 的缓存。

使用 BuildKit 缓存的 Dockerfile

# syntax=docker/dockerfile:1\nFROM swift:5.10 AS builder\nWORKDIR /app\nRUN --mount=type=cache,target=/app/.build/artifacts \\\n    --mount=type=bind,source=Package.swift,target=Package.swift \\\n    --mount=type=bind,source=Package.resolved,target=Package.resolved \\\n    swift package resolve\nCOPY Sources Sources\nRUN --mount=type=cache,target=/app/.build/artifacts \\\n    swift build -c release --static-swift-stdlib

优势：

\n
• 持久化缓存 — 依赖项的工件在同一主机上的构建之间得以保留。
\n
• SSH 代理 — 如果你的 Package.swift 引用了私有仓库，使用 --mount=type=ssh 进行身份验证，无需在镜像中存储密钥。
\n

对于 macOS 主机（例如 MacStadium），务必添加 --platform linux/amd64，因为 ARM（M1/M2）上的 Swift 需要模拟。

3. 与 Swift Package Manager 的高级集成

Swift PM 不仅仅是依赖管理器，它还是容器内测试和代码检查的强大工具。

在支持代码覆盖率的容器中运行测试

FROM swift:5.10 AS te