swiftlang/swift

Swift Docker 镜像文档

镜像概述和主要用途

Swift Docker 镜像是官方提供的 Docker 镜像，用于 Swift 应用程序的开发、测试和部署。该镜像基于 Swift 编程语言，包含 Swift 编译器、工具链及运行时环境，支持 nightly 开发快照版本。提供标准镜像（含完整开发工具）和 slim 镜像（仅含运行时依赖）两种类型，满足从开发到生产部署的全流程需求。

Docker Hub 仓库地址：https://hub.docker.com/_/swift/

核心功能和特性

• 完整开发环境：标准镜像包含 Swift 编译器、调试工具及完整工具链，支持应用开发和构建。
• 轻量级部署镜像：slim 镜像仅包含运行时依赖，不含编译器，显著减小部署体积。
• 多阶段构建支持：可通过多阶段 Dockerfile 结合标准镜像（构建）和 slim 镜像（部署），优化最终镜像大小。
• nightly 开发版本：提供 Swift 开发快照（nightly snapshots），支持尝鲜最新特性。
• 跨平台兼容：适配 Linux 和 macOS Docker 环境，运行 Swift REPL 需特定权限配置。

使用场景和适用范围

• Swift 应用开发：快速搭建一致的开发环境，避免本地环境配置差异。
• CI/CD 流程：在持续集成/部署 pipeline 中用于自动化构建、测试和打包。
• 生产环境部署：通过 slim 镜像部署已构建的 Swift 应用，减少资源占用。
• 新特性验证：利用 nightly 版本测试 Swift 新功能或修复。

详细使用方法和配置说明

1. 获取镜像

从 Docker Hub 拉取最新版标准镜像：

bash
docker pull swift:latest

如需特定版本（如 5.9、nightly 或 slim），指定标签即可：

bash
# 拉取 slim 镜像
docker pull swift:slim

# 拉取 nightly 开发快照
docker pull swift:nightly

2. 运行容器

2.1 基本交互模式

创建容器并进入 bash 终端（适用于常规开发操作）：

bash
docker run -it swift /bin/bash

2.2 运行 Swift REPL

Swift REPL（交互式解释器）需要额外权限才能正常运行，具体配置因 Docker 运行环境而异：

• Linux 环境：需禁用默认 seccomp 配置：

  bash
  docker run --security-opt seccomp=unconfined -it swift
  

• macOS 环境：需以特权模式运行：

  bash
  docker run --privileged -it swift
  

进入容器后，直接输入 swift 即可启动 REPL。

3. 多阶段构建示例

结合标准镜像（构建）和 slim 镜像（部署），生成轻量级部署镜像：

dockerfile
# 阶段 1：使用标准镜像构建应用
FROM swift:latest as builder
WORKDIR /app
COPY . .  # 复制项目源码
RUN swift build -c release  # 编译 release 版本

# 阶段 2：使用 slim 镜像部署
FROM swift:slim
WORKDIR /app
# 从构建阶段复制编译产物
COPY --from=builder /app/.build/release /app
# 运行应用（替换为实际可执行文件名）
CMD ["./your-app-executable"]

说明：

• builder 阶段使用完整工具链编译应用；
• 最终镜像仅包含运行时依赖和编译产物，体积显著减小。

贡献

欢迎通过 Pull Request 参与贡献。

许可

本项目基于 Apache License 2.0 许可。