centos/perl-530-centos7

Perl 5.30 容器镜像

此容器镜像包含Perl 5.30，作为https://github.com/openshift/source-to-image%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%9E%84%E5%BB%BAPerl 5.30应用程序。用户可选择基于RHEL、CentOS或Fedora的构建器镜像。RHEL镜像可在Red Hat容器目录获取，CentOS镜像可在Quay.io获取，Fedora镜像可在Fedora Registry获取。生成的镜像可使用https://github.com/containers/libpod%E8%BF%90%E8%A1%8C%E3%80%82

注意：虽然本README中的示例使用podman，但您可以用docker替换所有此类调用，参数保持不变。

镜像概述

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

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

在OpenShift中使用

本示例假设您使用centos/perl-530-centos7镜像，可通过OpenShift中的perl:5.30镜像流标签获取。

构建简单应用

构建https://github.com/sclorg/dancer-ex.git%E5%BA%94%E7%94%A8%EF%BC%9A

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

访问应用

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

源到镜像（S2I）框架和脚本

此镜像支持OpenShift中的源到镜像（S2I）策略。S2I是一种OpenShift框架，可简化将应用源代码作为输入、使用构建器镜像（如本Perl容器镜像）生成运行应用的新镜像的过程。

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

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

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

使用Dockerfile构建应用

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

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

1. 拉取基础构建器镜像

bash
podman pull quay.io/centos7/perl-530-centos7

本示例使用CentOS镜像quay.io/centos7/perl-530-centos7。

2. 获取应用代码

使用示例应用（https://github.com/sclorg/dancer-ex.git%EF%BC%89%EF%BC%8C%E5%8F%AF%E5%85%8B%E9%9A%86%E8%AF%A5%E4%BB%93%E5%BA%93%E8%BF%9B%E8%A1%8C%E5%AE%9E%E9%AA%8C%EF%BC%9A

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

3. 在容器内准备应用

此步骤通常至少包括以下部分：将应用源代码放入容器、安装依赖、设置生成镜像的默认命令。用户可选择手动设置并在Dockerfile中显式使用perl和cpanm命令（见3.1），或使用镜像中的源到镜像脚本（见3.2，有关这些脚本的更多信息见“源到镜像框架和脚本”部分）。

3.1 使用自定义设置

创建如下Dockerfile：

dockerfile
FROM quay.io/centos7/perl-530-centos7

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

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

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 使用源到镜像脚本

创建如下Dockerfile：

dockerfile
FROM quay.io/centos7/perl-530-centos7

# 将应用源代码添加到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

源到镜像的环境变量

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

ENABLE_CPAN_TEST

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

CPAN_MIRROR

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

PERL_APACHE2_RELOAD

设为“true”以启用修改后的Perl模块自动重载。

HTTPD_START_SERVERS

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%E8%8E%B7%E5%8F%96%E3%80%82%E8%AF%A5%E4%BB%93%E5%BA%93%E4%B8%AD%E8%BF%98%E5%8C%85%E5%90%AB%E5%85%B6%E4%BB%96%E7%89%88%E6%9C%AC%E7%9A%84Perl%E7%8E%AF%E5%A2%83Dockerfile%EF%BC%9ACentOS%E7%9A%84Dockerfile%E5%90%8D%E4%B8%BA%60Dockerfile%60%EF%BC%8CRHEL7%E7%9A%84%E5%90%8D%E4%B8%BA%60Dockerfile.rhel7%60%EF%BC%8CFedora%E7%9A%84%E5%90%8D%E4%B8%BA%60Dockerfile.fedora%60%E3%80%82