riscv64/perl

注意：这是https://hub.docker.com/_/perl的`riscv64`架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的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。

快速参考

• 维护者：
  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

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

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.042.001-main-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.042.001-slim-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.042.001-main,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.042.001-slim,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.040.003-main-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.040.003-slim-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.040.003-main,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.040.003-slim,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.038.005-main-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.038.005-slim-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.038.005-main,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.038.005-slim,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.043.008-main-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.043.008-slim-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.043.008-main,threaded-trixie/Dockerfile

• https://github.com/perl/docker-perl/blob/8b707a17ed1380a57b38d2dac8b4effdfd9b5194/5.043.008-slim,threaded-trixie/Dockerfile

快速参考（续）

• 提交issue的位置：
  https://github.com/Perl/docker-perl/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/perl/、https://hub.docker.com/r/arm32v5/perl/、https://hub.docker.com/r/arm32v7/perl/、https://hub.docker.com/r/arm64v8/perl/、https://hub.docker.com/r/i386/perl/、https://hub.docker.com/r/mips64le/perl/、https://hub.docker.com/r/ppc64le/perl/、https://hub.docker.com/r/riscv64/perl/、https://hub.docker.com/r/s390x/perl/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/perl (https://github.com/docker-library/repo-info/commits/master/repos/perl)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fperl
  https://github.com/docker-library/official-images/blob/master/library/perl (https://github.com/docker-library/official-images/commits/master/library/perl)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/perl (https://github.com/docker-library/docs/commits/master/perl)

什么是Perl？

Perl是一种高级、通用、解释型的动态编程语言。Perl语言借鉴了其他编程语言的特性，包括C、shell脚本（sh）、AWK和sed。

***.org/wiki/Perl

如何使用此镜像

在Perl应用项目中创建Dockerfile

dockerfile
FROM docker.xuanyuan.run/riscv64/perl:5.34
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD [ "perl", "./your-daemon-or-script.pl" ]

然后，构建并运行Docker镜像：

console
$ docker build -t my-perl-app .
$ docker run -it --rm --name my-running-app my-perl-app

运行单个Perl脚本

对于许多简单的单文件项目，编写完整的Dockerfile可能不方便。在这种情况下，可以直接使用Perl Docker镜像运行Perl脚本：

console
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp riscv64/perl:5.34 perl your-daemon-or-script.pl

与Debian的/usr/bin/perl共存

为此镜像构建的perl二进制文件安装在/usr/local/bin/perl中，同时包含Perl发行版中的其他标准工具，如prove和perldoc，以及用于安装CPAN模块的https://metacpan.org/pod/App::cpanminus。运行此镜像的容器还会将`PATH`环境变量设置为`/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin`，以确保在正常使用中首先找到此`perl`二进制文件。

由于此Docker官方镜像是使用https://hub.docker.com/_/buildpack-deps镜像（或`-slim`变体使用https://hub.docker.com/_/debian）构建的，因此此镜像还包含https://www.debian.org项目提供的`/usr/bin/perl`。这是底层dpkg/apt)包管理工具正常工作所必需的，因为docker-perl由于配置不同（如`@INC`和安装路径，以及是否包含`-Dusethreads`等其他差异）无法在此处使用。

另请参见https://github.com/Perl/docker-perl/issues/26了解更多讨论。

信号处理行为注意事项

由于Perl默认情况下会作为容器中的PID 1运行（除非设置了https://docs.docker.com/reference/dockerfile/#entrypoint），因此在期望向其发送信号（特别是SIGINT或SIGTERM）时需要特别注意。例如，运行

console
$ docker run -it --name sleeping_beauty --rm riscv64/perl:5.34 perl -E 'sleep 300'

然后在另一个终端执行

console
$ docker exec sleeping_beauty kill 1

不会停止在sleeping_beauty容器中运行的perl（它将继续运行直到sleep 300完成）。要实现此目的，必须设置信号处理程序，如下所示：

console
$ docker run -it --name quick_nap --rm riscv64/perl:5.34 perl -E '$SIG{TERM} = sub { $sig++; say "recv TERM" }; sleep 300; say "waking up" if $sig'

这样执行docker exec quick_nap kill 1（或更简单的docker stop quick_nap）将立即停止容器，并在另一个终端中打印recv TERM。请注意，除非信号处理程序调用die或exit，否则它不会停止perl进程本身；在这种情况下，perl将继续并在收到信号后打印waking up。

如果您的Perl程序需要处理信号并 fork 子进程，建议使用类似init的程序作为ENTRYPOINT，例如https://github.com/Yelp/dumb-init或https://github.com/krallin/tini（后者自Docker 1.13起可通过docker run --init标志使用）。

另请参见perlipc中的信号以及https://github.com/Perl/docker-perl/issues/44。

基于Debian Bookworm的镜像（Perl >= 5.38）中的COPY和WORKDIR行为

由于我们的Perl镜像基于标准buildpack-deps和debian镜像，它们继承了Debian 12（Bookworm）中引入的新https://wiki.debian.org/UsrMerge，这可能会影响某些将自己的`bin`、`sbin`或`lib`目录`COPY`到`WORKDIR /的构建上下文。建议用户尽可能将WORKDIR显式设置为/以外的路径，例如示例中显示的/usr/src/app，不过在当前版本中，我们的镜像现在默认设置为WORKDIR /usr/src/app`。