linuxserver/ci

镜像概述

linuxserver/ci是LinuxServer内部使用的持续集成(CI)容器，不供公众使用。该容器硬编码至LinuxServer的存储端点，用于接收来自内部构建系统linuxserver/pipeline-triggers的环境变量，对正在构建的软件执行基本持续集成测试，并将结果报告存储至指定端点。

核心功能与特性

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

使用场景与适用范围

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

使用方法与配置说明

基本运行命令

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存储桶。