denoland/deno Docker 镜像 - 轩辕镜像

Deno Docker镜像使用文档

镜像概述和主要用途

denoland/deno 是 Deno 官方提供的 Docker 镜像，用于简化 Deno 应用的容器化部署和运行。该镜像基于多种基础系统构建，满足不同场景下的环境需求，支持本地开发、生产部署及云服务集成等场景。

核心功能和特性

• 多基础镜像支持：提供 Alpine、Debian（默认）、Distroless、Ubuntu 等多种基础镜像，适配不同轻量化或兼容性需求。
• 安全运行环境：内置 deno 用户，默认以非 root 权限运行，降低安全风险。
• 依赖缓存机制：支持通过 deno cache 预编译依赖，减少容器启动时间。
• 灵活的目录配置：默认设置 DENO_DIR 为 /deno-dir/（可覆盖），支持挂载为共享卷实现多实例依赖共享。
• 二进制单独分发：提供仅包含 Deno 二进制文件的 bin 标签，便于集成到自定义基础镜像中。

支持的镜像标签

使用场景和适用范围

• 本地开发与测试：快速启动 Deno 环境，无需本地安装 Deno。
• Deno 应用容器化：通过 Dockerfile 构建包含 Deno 应用的镜像，用于生产部署。
• 自定义基础镜像集成：通过 bin 标签将 Deno 二进制集成到用户自有基础镜像（如 CentOS、Fedora）。
• 云服务部署：适配 Google Cloud Run 等云平台，支持依赖缓存优化。

详细使用方法和配置说明

一、本地运行

1. 启动 Deno 交互式解释器（REPL）

sh
docker run -it denoland/deno:2.5.4 repl

2. 进入容器 shell

sh
docker run -it denoland/deno:2.5.4 sh

3. 运行本地脚本

将主机当前目录挂载到容器 /app，并映射端口（如 1993）：

sh
docker run -it -p 1993:1993 -v $PWD:/app denoland/deno:2.5.4 run --allow-net /app/main.ts

• -p 1993:1993：将容器端口 1993 映射到主机端口 1993。
• -v $PWD:/app：挂载主机当前目录到容器 /app 目录。
• --allow-net：Deno 权限标志，允许网络访问。

二、通过 Dockerfile 构建应用

示例 Dockerfile

Dockerfile
FROM denoland/deno:2.5.4

# 暴露应用监听端口
EXPOSE 1993

# 设置工作目录
WORKDIR /app

# 非 root 用户运行（推荐）
USER deno

# 缓存依赖（仅当 deps.ts 修改时重新执行）
COPY deps.ts .
RUN deno install --entrypoint deps.ts

# 复制应用代码并预编译
COPY . .
RUN deno cache main.ts

# 启动命令
CMD ["run", "--allow-net", "main.ts"]

构建并运行

sh
docker build -t app . && docker run -it -p 1993:1993 app

三、使用自定义基础镜像

如需将 Deno 集成到自定义基础镜像（如 Ubuntu），可使用 bin 标签：

Dockerfile
FROM ubuntu
# 从 bin 镜像复制 Deno 二进制到目标路径
COPY --from=denoland/deno:bin-2.5.4 /deno /usr/local/bin/deno

四、在 Google Cloud Run（GCR）上运行

GCR 的缓存机制可能与默认 DENO_DIR 冲突，需在 Dockerfile 中修改 DENO_DIR 路径：

Dockerfile
# 设置自定义 DENO_DIR 避免缓存冲突
ENV DENO_DIR=./.deno_cache

说明：未设置时，GCR 实例可能重复下载依赖；使用 --cached-only 时可能提示“缓存中未找到指定文件”。

五、（可选）为 Shell 添加 deno 别名

通过 shell 配置文件（如 .bashrc）添加 deno 命令别名，简化本地调用：

sh
deno () {
  docker run \
    --interactive \
    --tty \
    --rm \
    --volume $PWD:/app \
    --volume $HOME/.deno:/deno-dir \
    --workdir /app \
    denoland/deno:2.5.4 \
    "$@"
}

生效并使用

sh
source ~/.bashrc
deno --version  # 查看版本
deno run ./main.ts  # 运行脚本

注意事项

• DENO_DIR 默认路径：镜像默认设置 DENO_DIR=/deno-dir/，可通过环境变量覆盖。
• 多实例共享依赖：如需多个 Deno 实例共享依赖缓存，可将 /deno-dir/ 挂载为共享卷。
• 权限管理：默认用户为 deno，如需 root 权限，可在 Dockerfile 中使用 USER root。

致谢

感谢 Andy Hayden 对本镜像的初始搭建和维护。