Perl是一种高级、通用、解释型动态编程语言,该Docker镜像提供其运行环境,支持Perl应用的开发与运行。
Perl Docker镜像文档
镜像概述和主要用途
注意:此仓库是https://hub.docker.com/_/perl的`amd64`架构构建版本。更多信息请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。
Perl是一种高级、通用、解释型、动态编程语言,借鉴了C、shell脚本(sh)、AWK和sed等语言的特性。本镜像提供了Perl运行环境,适用于开发、测试和部署Perl应用程序。
维护者
https://github.com/Perl/docker-perl
获取帮助
https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic
核心功能和特性
多版本与变体支持
- 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等架构(https://github.com/docker-library/official-images#architectures-other-than-amd64)
工具集成
- 包含
cpanm(CPAN模块安装工具) - 内置Perl标准工具(
prove、perldoc等)
使用场景和适用范围
- 开发环境:快速搭建Perl开发环境,无需本地安装Perl
- 脚本运行:直接运行单个Perl脚本或小型应用
- 应用部署:部署依赖CPAN模块的Perl应用程序
- 依赖管理:结合Carton等工具管理Perl项目依赖
- CI/CD流程:集成到持续集成/部署 pipeline,用于自动化测试和构建
详细的使用方法和配置说明
支持的标签及对应的Dockerfile链接
Perl 5.42.x(稳定版)
- https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-main-trixie/Dockerfile
- https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-main-bookworm/Dockerfile
- https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-main-bullseye/Dockerfile
slim变体:https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-slim-trixie/Dockerfilethreaded变体:https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-main,threaded-trixie/Dockerfileslim-threaded变体:https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.042.000-slim,threaded-trixie/Dockerfile
Perl 5.40.x、5.38.x(旧稳定版)
- 包含类似上述版本格式的标签,如
5.40.3,5.40.3-slim-bookworm,5.38.5-threaded等,具体标签及Dockerfile链接见https://github.com/perl/docker-perl
Perl 5.43.x(开发版)
- https://github.com/perl/docker-perl/blob/9a593371b5b762c4e6247a4b***dfaa0ccaeb8/5.043.002-main-trixie/Dockerfile
基本使用方法
1. 在Perl项目中创建Dockerfile
dockerfileFROM docker.xuanyuan.run/amd64/perl:5.42 # 使用指定版本的Perl镜像 COPY . /usr/src/myapp # 将项目文件复制到容器内目录 WORKDIR /usr/src/myapp # 设置工作目录 CMD ["perl", "./your-daemon-or-script.pl"] # 运行Perl脚本
构建并运行镜像:
console$ docker build -t my-perl-app . # 构建镜像 $ docker run -it --rm --name my-running-app my-perl-app # 运行容器
2. 直接运行单个Perl脚本
对于简单的单文件项目,可直接使用Perl镜像运行脚本,无需编写Dockerfile:
console$ 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):
-
直接运行无信号处理的脚本时,发送信号可能无法终止进程:
console$ docker run -it --name sleeping_beauty --rm amd64/perl:5.42 perl -E 'sleep 300'此时执行
docker exec sleeping_beauty kill 1无法终止进程。 -
需显式设置信号处理函数:
console$ 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)的镜像采用https://wiki.debian.org/UsrMerge,若将项目的`bin`、`sbin`或`lib`目录复制到`WORKDIR /`,可能导致冲突。建议:
- 显式设置
WORKDIR为非根目录(如/usr/src/app,镜像默认工作目录已设为/usr/src/app)
示例:创建可复用的Carton镜像
使用Carton管理Perl依赖的项目,可创建基础镜像简化构建:
- 创建
Dockerfile.carton:
dockerfileFROM docker.xuanyuan.run/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 # 复制项目文件
- 构建Carton基础镜像:
console$ docker build -f Dockerfile.carton -t amd64/perl:carton .
- 项目中直接使用基础镜像:
dockerfileFROM docker.xuanyuan.run/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软件的许可证信息参见http://dev.perl.org/licenses/
- 镜像中包含的其他软件(如Bash、Debian基础包等)可能具有不同许可证
- 镜像元数据和许可证详情可参见https://github.com/docker-library/repo-info/tree/master/repos/perl
使用本镜像需确保遵守所有包含软件的相关许可证要求。
参考链接
- https://github.com/Perl/docker-perl
- https://github.com/docker-library/docs/tree/master/perl
- https://www.perl.org/
amd64 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务