rsyslog 开发环境 Docker 镜像文档

1. 镜像概述和主要用途

该镜像提供 Ubuntu 环境下从源代码构建 rsyslog 所需的完整开发环境，包含构建依赖、rsyslog ***库及第三方组件。主要用途为 rsyslog 源代码开发、编译构建，同时作为 rsyslog 项目 CI（持续集成）流程的标准运行环境，确保构建一致性和稳定性。

2. 核心功能和特性

• 完整依赖集成：包含构建 rsyslog 所需的全部系统依赖和工具链。
• ***库版本控制：rsyslog 提供的库从 Adiscon 最新稳定仓库安装，确保兼容性和安全性。
• 第三方组件更新：关键第三方组件（如 librdkafka）基于最新 Git 版本构建，支持新特性测试。
• 稳定基础环境：基于 Ubuntu 16.04，提供成熟的系统底层支持。
• CI 适配优化：经实际 CI 流程验证，可直接用于自动化构建、测试场景，稳定性已通过长期使用验证。

3. 使用场景和适用范围

• rsyslog 源代码开发：本地或容器化环境中编译、调试 rsyslog 源码。
• CI/CD 自动化流程：集成到 Jenkins、GitHub Actions 等平台，实现 rsyslog 构建、测试自动化。
• 跨环境一致性保障：统一开发、测试、CI 环境，避免“本地可运行，CI 失败”等环境差异问题。

4. 使用方法和配置说明

4.1 Docker Run 命令示例

通过以下命令启动容器，挂载本地源代码目录（假设宿主机源码路径为 ./rsyslog-src）：

bash
docker run -it --rm \
  -v $(pwd)/rsyslog-src:/rsyslog \  # 挂载宿主机源码目录到容器内/rsyslog
  --name rsyslog-dev-env \          # 容器名称（可选）
  [镜像名称]:16.04                  # 镜像标签（仅支持 16.04）

说明：--rm 表示容器退出后自动清理；-it 启用交互终端，用于手动执行构建命令。

4.2 Docker Compose 配置示例

如需集成到多容器环境（如配合数据库、日志收集器测试），可使用 docker-compose.yml：

yaml
version: '3'
services:
  rsyslog-dev:
    image: [镜像名称]:16.04
    volumes:
      - ./rsyslog-src:/rsyslog  # 挂载源码目录
      - ./build-output:/output  # 挂载构建产物目录（可选）
    tty: true  # 保持终端连接
    # 如需网络访问其他服务，可添加 networks 配置

启动命令：docker-compose up -d，进入容器：docker-compose exec rsyslog-dev bash。

4.3 环境变量说明

该镜像未预设强制环境变量，用户可根据需求通过 -e 自定义，例如：

• 代理配置：-e http_proxy=[***]（用于网络受限环境）
• 构建参数：-e CFLAGS="-O2 -g"（自定义编译优化选项）

4.4 基本操作示例

容器启动后，可通过以下步骤构建 rsyslog 源码：

1. 进入容器终端：docker exec -it rsyslog-dev-env bash
2. 切换到源码目录：cd /rsyslog
3. 执行标准构建流程：

   bash
   ./autogen.sh  # 生成配置脚本（首次构建需执行）
   ./configure   # 配置构建选项（可添加 --enable-xxx 启用模块）
   make          # 编译源码
   make install  # 安装到容器内（如需持久化，需挂载输出目录）
   

5. 支持的标签

• 16.04：基于 Ubuntu 16.04 的稳定版本，为当前唯一支持标签。