Dart Docker 镜像文档

镜像概述和主要用途

Dart 镜像是***提供的 Docker 镜像，用于在容器环境中运行 Dart 应用程序。Dart 是一种针对客户端优化的语言，用于在任何平台上开发快速应用。其目标是提供最高效的跨平台开发编程语言，并配合灵活的应用框架执行运行时平台。

该镜像支持多种架构，包括 amd64、arm32v7、arm64v8 和 riscv64，并提供稳定版和测试版等多个标签版本。通过利用 Dart 对提前编译(AOT)为可执行文件的支持，可以创建非常小的运行时镜像（约10 MB）。

核心功能和特性

• 提供完整的 Dart SDK 环境，支持开发和构建 Dart 应用
• 支持提前编译(AOT)为可执行文件，显著减小运行时镜像体积
• 多架构支持，可在不同硬件平台上运行
• ***维护，确保与最新 Dart 版本同步更新
• 轻量级设计，优化容器化部署体验

支持的标签和版本

• 稳定版:

  • 3.9.4-sdk, 3.9-sdk, 3-sdk, stable-sdk, sdk, 3.9.4, 3.9, 3, stable, latest
  • Dockerfile

• 测试版:

  • 3.10.0-290.2.beta-sdk, beta-sdk, 3.10.0-290.2.beta, beta
  • Dockerfile

支持的架构

• amd64 - amd64/dart
• arm32v7 - arm32v7/dart
• arm64v8 - arm64v8/dart
• riscv64 - riscv64/dart

使用场景和适用范围

• Dart 应用程序的开发和测试环境
• 构建轻量级 Dart 微服务
• 部署基于 Shelf 或其他框架的 Dart 服务器应用
• 跨平台持续集成/持续部署(CI/CD)流程
• 教育和学*** Dart 编程语言的环境

详细的使用方法和配置说明

创建 Dart 服务器应用

首先安装 Dart SDK (2.14 或更高版本)，然后使用以下命令创建新的服务器应用：

shell
dart create -t server-shelf myserver

使用 Docker 构建和运行

Dockerfile

Dart 工具创建的 Dockerfile 执行两个步骤：

1. 使用 dart:stable 镜像中的 Dart SDK，将服务器应用(bin/server.dart)编译为可执行文件(server)
2. 通过组合编译后的服务器与 Dart VM 运行时及其所需依赖，构建最小化的运行时镜像

dockerfile
# 指定 Dart SDK 基础镜像版本，格式为 dart:<version> (例如: dart:2.12)
FROM dart:stable AS build

# 解析应用依赖
WORKDIR /app
COPY pubspec.* ./
RUN dart pub get

# 复制应用源代码并进行 AOT 编译
COPY . .
# 确保依赖项是最新的（如果有任何更改）
RUN dart pub get --offline
RUN dart compile exe bin/server.dart -o bin/server

# 从 AOT 编译的 `/server` 和构建阶段中存储在 `/runtime/` 中的所需系统库和配置文件构建最小化服务镜像
FROM scratch
COPY --from=build /runtime/ /
COPY --from=build /app/bin/server /app/bin/

# 启动服务器
EXPOSE 8080
CMD ["/app/bin/server"]

.dockerignore 文件

同时会创建推荐的 .dockerignore 文件，列出应从构建的 Docker 镜像中排除的文件：

.dockerignore
Dockerfile
build/
.dart_tool/
.git/
.github/
.gitignore
.packages

构建和运行命令

如果已安装 Docker Desktop，可以使用 docker 命令在本地构建和运行：

shell
# 构建镜像
docker build -t dart-server .

# 运行容器
docker run -it --rm -p 8080:8080 --name myserver dart-server

完成后，可以使用提供的名称停止容器：

shell
docker kill myserver

配置参数

环境变量

该镜像未定义特定的环境变量，但可以根据应用需求在 Dockerfile 或运行时添加自定义环境变量。

暴露端口

默认情况下，示例 Dockerfile 暴露 8080 端口，可根据应用需求修改 EXPOSE 指令。

镜像维护和支持

• 维护者: Dart Docker 团队
• 获取帮助: Docker Community Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 问题反馈: [***]
• 镜像更新: official-images repo's library/dart label
• 镜像元数据: repo-info repo's repos/dart/ directory

许可证信息

该镜像中包含的软件的许可证信息，请查看 [***]

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的 Bash 等，以及所包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可证信息可以在 repo-info 仓库的 dart/ 目录 中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。