subfuzion/dart

subfuzion/dart:slim

镜像概述和主要用途

subfuzion/dart:slim是一个基于https://hub.docker.com/_/scratch镜像构建的轻量级Dart应用容器基础镜像。它包含运行Dart应用（尤其是服务器应用）所需的最小系统运行时依赖，同时提供TLS根证书 bundle（支持HTTPS请求）和DNS服务支持（允许向外部主机发起HTTP客户端请求）。

该镜像旨在构建极小化的Dart容器，特别适合微服务和无服务器应用场景，可显著减少镜像大小并提升启动速度。仓库中包含测试用例和容器化服务器应用示例，可用于演示基础服务器镜像的大小及启动性能（对比Dart VM和Dart AOT编译器）。

核心功能和特性

• 极小化镜像体积：基于scratch构建，仅包含必要依赖，基础镜像大小约4.09MB
• 完整运行时支持：包含Dart应用运行所需的核心系统依赖
• 网络功能完备：内置TLS根证书（支持HTTPS）和DNS解析（支持外部HTTP请求）
• 灵活部署选项：支持Dart AOT编译（最快启动速度）和JIT编译（需反射支持时）

使用场景和适用范围

推荐使用AOT编译的场景

• 需要最快应用启动速度的场景
• 不需要Dart反射（如注解支持）的应用
• Function-as-a-Service（FaaS）和需快速执行、动态扩展的任务
• 短生命周期容器（执行任务后快速退出）

推荐使用JIT编译的场景

• 应用依赖dart:mirrors（无法使用AOT编译）
• 长运行时容器（可受益于JIT动态优化）
• 需要动态代码优化以提升长期运行性能的应用

详细使用方法和配置说明

Dart AOT编译部署

AOT编译可实现最快启动速度、一致的运行时性能，且无JIT的"预热"延迟。最小服务器应用镜像体积约25MB，容器启动至服务器监听请求时间可控制在亚秒级。

Dockerfile示例

dockerfile
FROM docker.xuanyuan.run/google/dart
# 如需确保使用最新Dart和根证书bundle，取消以下注释
#RUN apt -y update && apt -y upgrade
WORKDIR /app
COPY pubspec.yaml .
RUN dart pub get
COPY . .
RUN dart pub get --offline
RUN dart compile exe /app/bin/server.dart -o /app/bin/server

FROM docker.xuanyuan.run/subfuzion/dart:slim
COPY --from=0 /app/bin/server /app/bin/server
# 复制运行时所需的其他目录或文件，例如：
#COPY --from=0 /app/static/ /app/static/
EXPOSE 8080
ENTRYPOINT ["/app/bin/server"]

Dart VM（JIT编译）部署

当应用依赖dart:mirrors时，需使用JIT编译。通过创建JIT编译快照（kernel文件）可实现接近AOT的加载速度。最小服务器应用镜像体积约50MB，容器启动至监听请求时间为亚秒级。

JIT编译代码有预热时间（动态优化过程），长期运行时可能比AOT更快，但短生命周期容器难以受益。

Dockerfile示例

dockerfile
FROM docker.xuanyuan.run/google/dart
# 如需确保使用最新Dart和根证书bundle，取消以下注释
#RUN apt -y update && apt -y upgrade
WORKDIR /app
COPY pubspec.yaml .
RUN dart pub get
COPY . .
RUN dart pub get --offline
RUN dart compile kernel -o bin/server.dill bin/server.dart

FROM docker.xuanyuan.run/subfuzion/dart:slim
COPY --from=0 /usr/lib/dart/bin/dart /usr/lib/dart/bin/dart
# 可能需要复制一个或多个系统*.dill库
# 可通过以下命令列出google/dart镜像中的可用文件：
# docker run --rm google/dart ls -la /usr/lib/dart/lib/_internal
# 例如，开发工具支持需要dartdev.dill
# 如无法确定具体所需文件，可复制整个目录（会增加约70MB镜像体积）
#COPY --from=0 /usr/lib/dart/lib/_internal/*.dill /usr/lib/dart/lib/_internal/
COPY --from=0 /app/bin/server.dill /app/bin/server.dill
# 复制运行时所需的其他目录或文件，例如：
#COPY --from=0 /app/static/ /app/static/
EXPOSE 8080
ENTRYPOINT ["/usr/lib/dart/bin/dart", "/app/bin/server.dill"]

测试

镜像测试

shell
$ cd test
$ ./dartslim_test.sh
[+] Building 9.7s (15/15) FINISHED

00:00 +0: test/image_test.dart: Is server reachable? ping-test
00:00 +1: test/image_test.dart: Server DNS client tests remote-ping-test
00:00 +2: All tests passed!

计时测试

拉取基础镜像

shell
$ time docker pull docker.xuanyuan.run/subfuzion/dart:slim
slim: Pulling from subfuzion/dart
Digest: sha256:5bf1b8083f40b83c437301da991dbca8901ae48c525f56ccda05669040b93e1a
Status: Downloaded newer image for subfuzion/dart:slim
docker.io/subfuzion/dart:slim

real    0m1.656s
user    0m0.156s
sys     0m0.082s

$ docker image ls subfuzion/dart:slim
REPOSITORY       TAG       IMAGE ID       CREATED        SIZE
subfuzion/dart   slim      d92db830c85b   12 hours ago   4.09MB

AOT编译应用测试

shell
$ cd ./examples/dart-aot-shelf-server
$ docker build -t server-aot .
[+] Building 11.5s (15/15) FINISHED

$ time docker run -it -p 8080:8080 --name server-aot-test server-aot --quit
Starting server
Serving at http://0.0.0.0:8080
time elapsed: 1 ms

real    0m0.643s
user    0m0.152s
sys     0m0.071s

JIT编译应用测试

shell
$ cd ./examples/dart-vm-shelf-server
$ docker build -t server-vm .
[+] Building 4.0s (16/16) FINISHED

$ time docker run -it -p 8080:8080 --name server-vm-test server-vm --quit
Starting server
Serving at http://0.0.0.0:8080
time elapsed: 91 ms

real    0m0.777s
user    0m0.144s
sys     0m0.070s

测试总结

测试环境：

• iMac Pro (2017)，3.2 GHz 8核Intel Xeon W，64 GB 2666 MHz DDR4
• Docker engine 20.10.0-beta1
• Dart SDK version: 2.10.4 (stable) on "linux_x64"

非官方Google项目