docker-perl-tester

镜像概述和主要用途

本仓库提供预安装了多个常用CPAN模块的Perl Docker镜像。包含aspell和aspell-en包、cpanminus、App::cpm、Devel::Cover、各种测试模块，以及带有部分常用插件的Dist::Zilla（适用于Perl >= 5.14）。

镜像目前每日更新（若未来出现问题可能调整频率），确保您能测试最新的CPAN栈。注意：若某个依赖安装失败，镜像将不会发布，因此不会对您造成影响。

核心功能和特性

Perl模块列表

所有Perl版本可用

Code::TidyAll::Plugin::SortLines::Naturally
Code::TidyAll::Plugin::UniqueLines
Devel::Cover
Devel::Cover::Report::Codecov
Devel::Cover::Report::Coveralls
File::Temp
List::MoreUtils
Module::Build
Pod::Coverage::TrustPod
Test2::Bundle::Extended
Test2::Plugin::NoWarnings
Test2::Suite
Test2::Tools::Explain
Test::Builder
Test::CPAN::Meta
Test::Deep
Test::Differences
Test::EOL
Test::Fatal
Test::MinimumVersion
Test::MockModule
Test::Mojibake
Test::More
Test::Needs
Test::Pod
Test::Pod::Coverage
Test::Portability::Files
Test::RequiresInternet
Test::Spelling
Test::Synopsis
Test::Version
Test::Warnings

仅Perl 5.10及更高版本可用

Code::TidyAll::Plugin::Test::Vars
Pod::Readme
Test::Vars

使用场景和适用范围

适用于Perl项目的测试与持续集成场景，可在不同Perl版本下快速搭建包含常用测试模块的环境，简化测试流程，确保代码在多种Perl版本中兼容。

使用方法和配置说明

镜像获取

镜像可在Docker Hub获取，仓库地址：[***]

可用标签：5.30、5.28、5.26、5.24、5.22、5.20、5.18、5.16、5.14、5.12、5.10、5.8、latest

基础使用示例

通过以下命令启动镜像：

bash
docker run -it perldocker/perl-tester:latest

持续集成配置（GitHub Workflow示例）

以下是在Linux环境下针对Perl 5.8至最新版本的测试工作流配置，可保存为.github/workflow/linux.yml。

注：示例使用cpm从cpanfile安装依赖，支持的Perl版本也可使用Dist::Zilla。

yaml
name: linux

on:
  push:
    branches:
      - '*'
    tags-ignore:
      - '*'
  pull_request:

jobs:
  perl:
    env:
      # 部分插件运行测试时仍需要此环境变量
      PERL_USE_UNSAFE_INC: 0
      AUTHOR_TESTING: 1
      AUTOMATED_TESTING: 1
      RELEASE_TESTING: 1

    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        perl-version:
          - 'latest'
          - '5.28'
          - '5.26'
          - '5.24'
          - '5.22'
          - '5.20'
          - '5.18'
          - '5.16'
          - '5.14'
          - '5.12'
          - '5.10'
          - '5.8'

    container:
      image: perldocker/perl-tester:${{ matrix.perl-version }}

    steps:
      - uses: actions/checkout@v1
      - name: 查看Perl版本信息
        run: perl -V
      - name: 安装依赖
        run: cpm install -g --no-test --show-build-log-on-failure --cpanfile cpanfile
      - name: 生成Makefile
        run: perl Makefile.PL
      - name: 运行测试
        run: make test