jjmerelo/raku-test

jjmerelo/raku-test Docker镜像文档

镜像概述

jjmerelo/raku-test是一个用于Raku应用测试和持续集成的Docker容器，主要适用于Travis等CI环境。该镜像基于轻量级Alpine Linux的https://hub.docker.com/r/jjmerelo/alpine-raku/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%ABRaku%E8%A7%A3%E9%87%8A%E5%99%A8%E5%8F%8A%E6%B5%8B%E8%AF%95%E6%89%80%E9%9C%80%E5%B7%A5%E5%85%B7%E3%80%82%E9%95%9C%E5%83%8F%E4%BC%9A%E5%9C%A8%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%9B%B4%E6%96%B0%E6%97%B6%E8%87%AA%E5%8A%A8%E9%87%8D%E5%BB%BA%EF%BC%8C%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://hub.docker.com/r/jjmerelo/raku-test/%EF%BC%8CDockerfile%E6%BA%90%E7%A0%81%E4%BD%8D%E4%BA%8Ehttps://github.com/JJ/docker-raku-test%E3%80%82

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 自动更新：基础镜像更新时自动重建，确保依赖最新
• 多环境支持：可用于本地测试和主流CI/CD平台（Travis、GitHub Actions等）
• 测试工具集成：内置zef包管理器，支持prove6测试框架
• 安全运行：默认使用非特权用户raku（及同名组）执行测试

使用场景

• 本地Raku模块开发测试
• Travis CI持续集成流程
• GitHub Actions工作流
• 需要隔离环境的Raku应用测试
• 依赖系统库的Raku项目测试（需额外配置）

使用方法与配置说明

本地使用

1. 拉取镜像

bash
docker pull jjmerelo/raku-test

2. 运行测试容器

将本地Raku模块目录映射到容器的/test目录，自动安装依赖并执行测试：

bash
docker run -t -v /path/to/module-dir:/test jjmerelo/raku-test

当前目录测试（Linux/macOS）：

bash
docker run -t -v $PWD:/test jjmerelo/raku-test

提示：若系统需要，需在docker命令前添加sudo

3. 传递测试参数

可添加zef test标志，如启用详细输出：

bash
docker run -t -v $PWD:/test jjmerelo/raku-test --verbose

4. 权限说明

默认使用非特权用户raku运行测试。如需以root权限执行（如安装系统依赖），需指定--user root参数。

Travis CI集成

基础配置示例

yaml
language: minimal
services: docker
install:
  - docker pull jjmerelo/raku-test
  - docker images  # 可选，显示镜像版本
script: docker run -t -v $TRAVIS_BUILD_DIR:/test jjmerelo/raku-test

安装系统依赖

若模块需要Alpine系统库（如openssl-dev），需以root用户运行并安装依赖：

yaml
script: docker run -t --user root --entrypoint="/bin/sh" \
  -v $TRAVIS_BUILD_DIR:/test jjmerelo/raku-test \
  -c "apk add --update --no-cache openssl-dev make build-base && zef install --deps-only . && zef test ."

处理构建超时

若测试耗时较长，使用travis_wait避免超时：

yaml
script: travis_wait docker run -t -v $TRAVIS_BUILD_DIR:/test jjmerelo/raku-test

无META6.json文件时的测试

直接使用prove6测试：

yaml
script: docker run -t --entrypoint="/bin/sh" \
  -v $TRAVIS_BUILD_DIR:/test jjmerelo/raku-test \
  -c "prove6 --lib"

GitHub Actions集成

基础工作流配置

yaml
name: "Test"
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    container:
      image: jjmerelo/raku-test:latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Install modules
        run: zef install --deps-only .
      - name: Test
        run: zef test .

相关镜像

• https://hub.docker.com/r/jjmerelo/perl6-test-openssl%EF%BC%9A%E5%B7%B2%E9%A2%84%E8%A3%85OpenSSL%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E4%BE%9D%E8%B5%96OpenSSL%E7%9A%84Raku%E9%A1%B9%E7%9B%AE
• https://hub.docker.com/r/jjmerelo/rakudo-nostar%EF%BC%9A%E9%9D%9EAlpine%E5%9F%BA%E7%A1%80%E7%9A%84Raku%E9%95%9C%E5%83%8F%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%85%B6%E4%BB%96Linux%E5%8F%91%E8%A1%8C%E7%89%88%E7%9A%84%E5%9C%BA%E6%99%AF

Travis配置示例（使用rakudo-nostar）：

yaml
language: minimal
services: docker
install:
  - docker pull jjmerelo/rakudo-nostar
script: docker run --entrypoint sh -t -v $TRAVIS_BUILD_DIR:/home/raku jjmerelo/rakudo-nostar -c "zef install --deps-only . && zef build . && zef test ."