tallfurryman/kstars-ci

KStars/Ekos 构建镜像

概述

KStars/Ekos构建镜像是一个预配置的Docker环境，专为构建KStars天文软件及其中的Ekos天文摄影与望远镜控制模块设计。该镜像集成了完整的构建依赖、工具链和编译环境，旨在消除因开发环境差异导致的构建问题，为开发者和CI/CD流程提供一致、可靠的构建基础。

核心功能和特性

预配置的构建依赖

• 集成KStars和Ekos编译所需的全部依赖库（如Qt、Indi、CFITSIO等）
• 包含GCC、CMake、Ninja等编译工具链
• 预装版本控制工具（Git）及构建辅助脚本

多版本支持

• 支持构建KStars的稳定版、开发版及特定历史版本
• 兼容Ekos模块的不同功能分支构建需求

轻量级设计

• 基于精简的基础镜像（如Ubuntu LTS）
• 优化依赖安装流程，减少镜像体积

构建流程优化

• 内置构建缓存机制，加速重复构建
• 支持并行编译配置，提升构建效率

使用场景

开发者本地构建

• 为KStars/Ekos开发者提供统一的本地构建环境，避免系统依赖冲突
• 快速验证代码修改后的编译结果

CI/CD流程集成

• 作为持续集成流程的构建节点，自动验证代码提交的可编译性
• 配合GitHub Actions、GitLab CI等工具实现自动化构建与测试

多版本测试

• 在同一环境中构建并测试不同版本的KStars/Ekos，对比功能差异
• 复现特定版本的构建问题，辅助调试

使用方法

镜像拉取

从Docker仓库拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/kstars-ekos-builder:latest

基本构建命令

挂载本地KStars源码目录并执行构建：

bash
docker run -it --rm \
  -v /path/to/local/kstars/source:/kstars-src \
  -v /path/to/build/output:/kstars-build \
  docker.xuanyuan.run/[镜像仓库地址]/kstars-ekos-builder:latest \
  /bin/bash -c "cd /kstars-build && cmake /kstars-src && make -j$(nproc)"

环境变量配置

通过环境变量自定义构建参数：

示例：构建Debug版本并指定CMake参数

bash
docker run -it --rm \
  -e KSTARS_VERSION=v3.6.6 \
  -e BUILD_TYPE=Debug \
  -e CMAKE_FLAGS="-DCMAKE_INSTALL_PREFIX=/usr/local" \
  -v /path/to/local/kstars/source:/kstars-src \
  -v /path/to/build/output:/kstars-build \
  docker.xuanyuan.run/[镜像仓库地址]/kstars-ekos-builder:latest \
  /bin/bash -c "cd /kstars-build && cmake \$CMAKE_FLAGS /kstars-src && make -j$(nproc)"

构建结果输出

构建完成后，编译产物（可执行文件、库等）将保存在挂载的/kstars-build目录中，可直接用于安装或测试。

注意事项

• 本地源码目录需确保具有读写权限，避免容器内构建失败
• 大版本构建可能需要较多系统资源，建议分配足够的CPU和内存
• 构建结果依赖于挂载的源码版本，建议在构建前同步最新代码