lsiodev/ci

linuxserver/ci

镜像概述

linuxserver/ci是LinuxServer内部使用的持续集成(CI)容器，不供公众使用。该容器硬编码至LinuxServer的存储端点，用于接收来自内部构建系统https://github.com/linuxserver/pipeline-triggers%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%8C%E5%AF%B9%E6%AD%A3%E5%9C%A8%E6%9E%84%E5%BB%BA%E7%9A%84%E8%BD%AF%E4%BB%B6%E6%89%A7%E8%A1%8C%E5%9F%BA%E6%9C%AC%E6%8C%81%E7%BB%AD%E9%9B%86%E6%88%90%E6%B5%8B%E8%AF%95%EF%BC%8C%E5%B9%B6%E5%B0%86%E7%BB%93%E6%9E%9C%E6%8A%A5%E5%91%8A%E5%AD%98%E5%82%A8%E8%87%B3%E6%8C%87%E5%AE%9A%E7%AB%AF%E7%82%B9%E3%80%82

核心功能与特性

• 环境变量驱动：通过环境变量接收构建系统传递的参数，动态配置CI流程
• 持续集成测试：执行软件构建的基本CI测试，包括容器日志收集、网页应用截图（如适用）等
• 报告存储：将测试结果报告存储至LinuxServer指定的S3端点
• 灵活配置：支持多种自定义参数，如测试延迟、端口设置、SSL启用等，适配不同类型软件测试需求
• 模拟运行模式：支持DRY_RUN模式，用于测试时避免实际上传文件至S3

使用场景与适用范围

该容器专为LinuxServer内部构建流程设计，适用于与pipeline-triggers系统集成，在软件构建过程中自动化执行持续集成测试，确保构建产物的质量。仅用于LinuxServer内部开发团队，不对外提供服务。

使用方法与配置说明

基本运行命令

bash
sudo docker run --rm -i \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /host/path:/ci/output:rw `#可选，存储容器创建的所有文件` \
-e IMAGE="linuxserver/<dockerimage>" \
-e TAGS="<单个标签或用|分隔的标签数组>" \
-e META_TAG=<manifest主dockerhub标签> \
-e BASE=<alpine或debian基础发行版> \
-e SECRET_KEY=<S3密钥> \
-e ACCESS_KEY=<S3访问键> \
-e DOCKER_ENV="<可选，用|分隔的环境变量数组，如test=test|test2=test2，默认空>" \
-e WEB_AUTH="<可选，格式user:password，默认'user:password'>" \
-e WEB_PATH="<可选，格式/yourpath，默认空>" \
-e S3_REGION=<可选，自定义S3区域，默认'us-east-1'> \
-e S3_BUCKET=<可选，自定义S3存储桶，默认'ci-tests.linuxserver.io'> \
-e WEB_SCREENSHOT_DELAY=<可选，截图前延迟秒数，默认30> \
-e WEB_SCREENSHOT=<可选，非网页应用设为false，默认'false'> \
-e DELAY_START=<可选，启动延迟秒数，默认5> \
-e PORT=<可选，网页应用内部端口，默认80> \
-e SSL=<可选，是否启用SSL截图，true/false，默认'false'> \
-e CI_S6_VERBOSITY=<可选，设置S6_VERBOSITY，默认2> \
-e DOCKER_LOGS_DELAY=<可选，日志收集等待秒数，默认300> \
-e DRY_RUN=<可选，测试时设为'true'避免上传至S3> \
-t lsiodev/ci:latest \
python3 test_build.py

参数说明

挂载卷

环境变量

注意事项

• 该容器为LinuxServer内部专用，硬编码了其内部存储端点，不支持公众使用。
• 执行命令时需确保所有必需环境变量已正确配置，尤其是IMAGE、TAGS、SECRET_KEY、ACCESS_KEY等核心参数。
• DRY_RUN模式可用于本地测试CI流程，避免实际上传文件至S3存储桶。