Perl Docker镜像文档

镜像概述和主要用途

注意：此仓库是perl官方镜像的amd64架构构建版本。更多信息请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“镜像源在Git中更改后如何处理？”。

Perl是一种高级、通用、解释型、动态编程语言，借鉴了C、shell脚本（sh）、AWK和sed等语言的特性。本镜像提供了Perl运行环境，适用于开发、测试和部署Perl应用程序。

维护者

Perl社区

获取帮助

Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

核心功能和特性

多版本与变体支持

• Perl版本：支持稳定版（如5.42.x、5.40.x、5.38.x）和开发版（5.43.x）
• 基础系统：基于Debian发行版（trixie、bookworm、bullseye）
• 镜像变体：
  • 默认版：包含常用依赖，基于buildpack-deps
  • slim版：最小化镜像，仅含运行Perl的必要依赖
  • threaded版：启用线程支持的Perl构建

架构支持

支持amd64、arm32v5、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x等架构（详细信息）

工具集成

• 包含cpanm（CPAN模块安装工具）
• 内置Perl标准工具（prove、perldoc等）

使用场景和适用范围

• 开发环境：快速搭建Perl开发环境，无需本地安装Perl
• 脚本运行：直接运行单个Perl脚本或小型应用
• 应用部署：部署依赖CPAN模块的Perl应用程序
• 依赖管理：结合Carton等工具管理Perl项目依赖
• CI/CD流程：集成到持续集成/部署 pipeline，用于自动化测试和构建

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

支持的标签及对应的Dockerfile链接

Perl 5.42.x（稳定版）

• 5.42.0, 5.42, 5, latest, stable, 5.42.0-trixie, 5.42-trixie, 5-trixie, trixie, stable-trixie
• 5.42.0-bookworm, 5.42-bookworm, 5-bookworm, bookworm, stable-bookworm
• 5.42.0-bullseye, 5.42-bullseye, 5-bullseye, bullseye, stable-bullseye
• slim变体：5.42.0-slim, 5.42-slim, 5-slim, slim, stable-slim 等
• threaded变体：5.42.0-threaded, 5.42-threaded, 5-threaded, threaded, stable-threaded 等
• slim-threaded变体：5.42.0-slim-threaded, 5.42-slim-threaded, 5-slim-threaded, slim-threaded, stable-slim-threaded 等

Perl 5.40.x、5.38.x（旧稳定版）

• 包含类似上述版本格式的标签，如5.40.3, 5.40.3-slim-bookworm, 5.38.5-threaded等，具体标签及Dockerfile链接见官方仓库

Perl 5.43.x（开发版）

• 5.43.2, 5.43, devel, 5.43.2-trixie, 5.43-trixie, devel-trixie 等

基本使用方法

1. 在Perl项目中创建Dockerfile

FROM amd64/perl:5.42  # 使用指定版本的Perl镜像
COPY . /usr/src/myapp  # 将项目文件复制到容器内目录
WORKDIR /usr/src/myapp  # 设置工作目录
CMD ["perl", "./your-daemon-or-script.pl"]  # 运行Perl脚本

构建并运行镜像：

$ docker build -t my-perl-app .  # 构建镜像
$ docker run -it --rm --name my-running-app my-perl-app  # 运行容器

2. 直接运行单个Perl脚本

对于简单的单文件项目，可直接使用Perl镜像运行脚本，无需编写Dockerfile：

$ docker run -it --rm --name my-running-script \
  -v "$PWD":/usr/src/myapp \  # 挂载当前目录到容器内
  -w /usr/src/myapp \  # 设置工作目录为挂载目录
  amd64/perl:5.42 \  # 使用指定版本镜像
  perl your-daemon-or-script.pl  # 运行脚本

高级配置与注意事项

与Debian系统Perl的共存

• 本镜像的Perl二进制文件安装在/usr/local/bin/perl，并包含prove、perldoc、cpanm等工具
• 容器的PATH环境变量配置为/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin，确保优先使用本镜像的Perl
• 镜像同时包含Debian提供的/usr/bin/perl，用于dpkg/apt等系统工具正常工作，两者因配置不同（如@INC、安装路径、线程支持）不可互换

信号处理行为

Perl默认作为容器的PID 1运行，需注意信号处理（尤其是SIGINT/SIGTERM）：

• 直接运行无信号处理的脚本时，发送信号可能无法终止进程：

  $ docker run -it --name sleeping_beauty --rm amd64/perl:5.42 perl -E 'sleep 300'
  

  此时执行docker exec sleeping_beauty kill 1无法终止进程。

• 需显式设置信号处理函数：

  $ docker run -it --name quick_nap --rm amd64/perl:5.42 \
    perl -E '$SIG{TERM} = sub { exit }; sleep 300'  # 收到TERM信号时退出
  

  此时执行docker stop quick_nap可正常终止容器。

• 对于需要处理信号和 fork 子进程的场景，建议使用--init标志（Docker 1.13+）或添加init工具（如tini）作为ENTRYPOINT。

Debian Bookworm（Perl >= 5.38）中的COPY和WORKDIR行为

基于Debian 12（Bookworm）的镜像采用merged-usr文件系统布局，若将项目的bin、sbin或lib目录复制到WORKDIR /，可能导致冲突。建议：

• 显式设置WORKDIR为非根目录（如/usr/src/app，镜像默认工作目录已设为/usr/src/app）

示例：创建可复用的Carton镜像

使用Carton管理Perl依赖的项目，可创建基础镜像简化构建：

1. 创建Dockerfile.carton：

FROM amd64/perl:5.42

# 安装Carton并设置工作目录
RUN cpanm Carton && mkdir -p /usr/src/app
WORKDIR /usr/src/app

# ONBUILD指令：在派生镜像构建时自动执行
ONBUILD COPY cpanfile* /usr/src/app  # 复制依赖描述文件
ONBUILD RUN carton install  # 安装依赖
ONBUILD COPY . /usr/src/app  # 复制项目文件

2. 构建Carton基础镜像：

$ docker build -f Dockerfile.carton -t amd64/perl:carton .

3. 项目中直接使用基础镜像：

FROM amd64/perl:carton  # 一行即可完成构建
CMD ["carton", "exec", "perl", "app.pl"]  # 使用Carton执行应用

镜像变体说明

amd64/perl:<version>（默认版）

• 基于buildpack-deps镜像构建，包含大量常用Debian包，减少派生镜像的依赖安装需求
• 适合大多数场景，尤其是需要安装额外系统依赖的项目
• 标签中包含Debian发行版名称（如5.42-bookworm），建议显式指定以避免基础系统更新导致的兼容性问题

amd64/perl:<version>-slim（精简版）

• 基于debian:slim镜像构建，仅包含运行Perl的最小必要依赖
• 镜像体积更小，适合空间受限的环境（如边缘设备、轻量级部署）
• 不包含默认版中的常用系统工具，如需额外依赖需手动安装

许可证信息

• Perl软件的许可证信息参见官方页面
• 镜像中包含的其他软件（如Bash、Debian基础包等）可能具有不同许可证
• 镜像元数据和许可证详情可参见repo-info仓库的perl目录

使用本镜像需确保遵守所有包含软件的相关许可证要求。

参考链接

• Perl官方Docker仓库
• Docker官方镜像文档
• Perl官方网站