linuxserver/d2-builder 镜像文档

镜像概述和主要用途

linuxserver/d2-builder 是 LinuxServer.io (LSIO) CI 流程的专用组件，设计用于内部持续集成流程。该镜像并非为公众使用而开发，主要服务于 LSIO 内部自动化构建或处理流程。

核心功能和特性

• CI 流程集成：作为 LSIO CI 流程的一部分，支持自动化任务执行
• 本地测试支持：提供本地运行能力，便于功能测试和验证
• 文件输出管理：可将生成的文件（如 SVG）输出到指定目录

使用场景和适用范围

• 主要场景：LSIO 内部持续集成流程中的自动化任务处理
• 适用范围：仅限 LSIO 内部开发和 CI 环境使用，不建议公众部署或用于生产环境

使用方法和配置说明

本地测试运行

若需测试镜像功能，可通过以下步骤本地运行：

1. 拉取镜像

bash
docker pull lscr.io/linuxserver/d2-builder:latest

2. 启动容器

bash
docker run -d --rm -v /tmp/d2:/output -e PUID=1000 -e PGID=1000 lscr.io/linuxserver/d2-builder:latest ***:latest

参数说明

• 容器运行参数：
  -d：后台运行容器
  --rm：容器停止后自动删除
  -v /tmp/d2:/output：挂载本地目录（/tmp/d2）到容器内 /output 目录，用于获取生成文件

• 环境变量：
  PUID=1000：指定运行容器的用户 UID（避免权限问题）
  PGID=1000：指定运行容器的用户组 GID

• 命令参数：
  ***:latest：示例任务参数（具体需根据实际使用场景调整）

输出说明

运行后，生成的 SVG 文件将保存至本地挂载目录（如示例中的 /tmp/d2）。

版本说明

• 01.01.50：内部仓库发布版本，包含基础 CI 流程适配功能。