centos/perl-526-centos7

Perl 5.26 容器镜像

该容器镜像包含Perl 5.26，作为https://github.com/openshift/source-to-image基础镜像，用于构建和运行Perl 5.26应用程序。用户可选择基于RHEL、CentOS或Fedora的构建器镜像：RHEL镜像可在Red Hat Container Catalog获取，CentOS镜像在https://quay.io/organization/centos7，Fedora镜像在https://registry.fedoraproject.org/。生成的镜像可使用https://github.com/containers/libpod运行。

注意：本文档示例中使用podman命令，所有此类命令均可替换为docker，参数保持不变。

镜像概述

Perl 5.26容器镜像是构建和运行各类Perl 5.26应用程序及框架的基础平台。Perl是一种高级编程语言，源于C、sed、awk和shell脚本，擅长处理进程、文件及文本，以实用性和高效性为特点，常见应用包括系统管理工具和Web编程。

该容器镜像包含npm工具，用户可用于安装Web应用的JavaScript模块。但不保证镜像中包含特定版本的npm或nodejs，其版本可能随时变更，nodejs仅为支持npm运行而包含。

OpenShift中的使用

以下示例假设使用rhscl/perl-526-rhel7镜像（在OpenShift中通过perl:5.26镜像流标签可用），构建简单的https://github.com/sclorg/dancer-ex.git应用：

bash
oc new-app perl:5.26~https://github.com/sclorg/dancer-ex.git

访问应用

bash
oc get pods
oc exec <pod> -- curl 127.0.0.1:8080

Source-to-Image框架与脚本

该镜像支持OpenShift的Source-to-Image（S2I）策略。S2I是一种OpenShift框架，可轻松构建接收应用源代码、使用构建器镜像（如本Perl容器镜像）并生成运行组装后应用的新镜像。

为支持S2I框架，构建器镜像中包含以下重要脚本：

• /usr/libexec/s2i/assemble：用于生成包含应用制品的新镜像。该脚本接收应用源代码并将其放置到镜像内的适当目录，利用Perl应用开发中的一些常见模式（见下文“环境变量”部分）。

• /usr/libexec/s2i/run：设置为生成的容器镜像（包含应用制品的新镜像）的默认命令，在生产环境中运行httpd。

使用Dockerfile构建应用

与S2I策略相比，使用Dockerfile是构建包含应用的Perl容器镜像的更灵活方式。当S2I不够灵活或在OpenShift环境外构建镜像时，可使用Dockerfile。

使用Dockerfile构建Perl镜像的步骤如下：

1. 拉取基础构建镜像

bash
podman pull rhscl/perl-526-rhel7

本示例使用RHEL7镜像rhscl/perl-526-rhel7。

2. 拉取应用代码

以https://github.com/sclorg/dancer-ex.git为例，可克隆该仓库进行实验：

bash
git clone https://github.com/sclorg/dancer-ex.git app-src

3. 在容器内准备应用

此步骤通常至少包括：将应用源代码放入容器、安装依赖、设置生成镜像的默认命令。用户可通过以下两种方式实现：

3.1 使用自定义设置

创建包含以下内容的Dockerfile：

dockerfile
FROM docker.xuanyuan.run/rhscl/perl-526-rhel7

# 添加应用源代码
ADD app-src .

# 安装依赖
RUN export PATH=${PATH}:/opt/rh/rh-perl526/root/usr/bin/&& \
     export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/opt/rh/rh-perl526/root/usr/lib64 && \
     cpanm --notest -l extlib Module::CoreList && \
     cpanm --notest -l extlib --installdeps .

# 配置Web应用
CMD sed -i '1i<Location/>' /opt/app-root/etc/httpd.d/40-psgi.conf
CMD sed -i '2iSetHandler perl-script' /opt/app-root/etc/httpd.d/40-psgi.conf
CMD sed -i '3iPerlResponseHandler Plack::Handler::Apache2' /opt/app-root/etc/httpd.d/40-psgi.conf
CMD sed -i '4iPerlSetVar psgi_app app.psgi' /opt/app-root/etc/httpd.d/40-psgi.conf
CMD sed -i '5i</Location>' /opt/app-root/etc/httpd.d/40-psgi.conf

# 使用标准方式运行应用
CMD exec httpd -C 'Include /opt/app-root/etc/httpd.conf' -D FOREGROUND

3.2 使用Source-to-Image脚本

创建包含以下内容的Dockerfile：

dockerfile
FROM docker.xuanyuan.run/rhscl/perl-526-rhel7

# 将应用源代码添加到assemble脚本预期的目录，并设置权限以非root用户运行容器
USER 0
ADD app-src /tmp/src
RUN chown -R 1001:0 /tmp/src
USER 1001

# 安装依赖
RUN /usr/libexec/s2i/assemble

# 设置生成镜像的默认命令
CMD /usr/libexec/s2i/run

4. 从Dockerfile构建新镜像

bash
podman build -t perl-app .

5. 运行包含最终应用的镜像

bash
podman run -d perl-app

Source-to-Image环境变量

可在源代码仓库的.s2i/environment文件中以键值对形式设置环境变量。

• ENABLE_CPAN_TEST
  允许安装所有指定的cpan包并运行其测试。默认值为false。

• CPAN_MIRROR
  指定cpanminus用于安装依赖的镜像URL。默认未指定。

• PERL_APACHE2_RELOAD
  设置为“true”可启用修改后的Perl模块自动重载。

• HTTPD_START_SERVERS
  https://httpd.apache.org/docs/2.4/mod/mpm_common.html#startservers指令，设置启动时创建的子服务器进程数。默认值为8。

• HTTPD_MAX_REQUEST_WORKERS
  Apache处理的同时请求数。默认值为256，若内存受限会自动降低。

• PSGI_FILE
  覆盖PSGI应用检测：

  • 若设为空值，不检测PSGI应用，不重新配置mod_perl；
  • 若设为非空值，定义PSGI应用文件路径，不使用检测；
  • 若不存在，自动检测：若存在唯一的./*.psgi文件，配置mod_perl执行该文件。

• PSGI_URI_PATH
  覆盖PSGI应用处理的位置URI路径。默认值为“/”。

另请参见

Dockerfile及其他源代码位于https://github.com/sclorg/s2i-perl-container。该仓库中还包含其他版本的Perl环境Dockerfile：CentOS的Dockerfile名为`Dockerfile`，RHEL7为`Dockerfile.rhel7`，RHEL8为`Dockerfile.rhel8`，Fedora为`Dockerfile.fedora`。