tangentsoft/fossil

Fossil 版本控制镜像文档

镜像概述

本镜像基于Fossil项目的官方Dockerfile构建，通过自定义构建系统生成标签化镜像，适用于Podman自动化部署场景。镜像标签与上游Fossil提交名称对应，提供清晰的版本管理策略。

标签说明

镜像标签分为以下三种类型：

• Version标签：格式为version-*，对应上游Fossil的最新稳定版本。仅保留最新稳定版，因通常无需使用旧版本。
• Check-In标签：12字符十六进制前缀，对应上游提交ID的唯一前缀。用于测试新功能、变更和修复的临时构建，发布后不久即会移除，通常仅保留最新构建及前一个构建作为应急回退版本。
• Latest标签：通常作为最新hex标签镜像的别名；在新版本发布至首个测试构建的短时间窗口内，指向发布版本镜像。

核心功能与特性

• 静态二进制构建：提供简洁、单一的Fossil版本控制功能，无多余依赖。
• 清晰的版本策略：通过标签明确区分稳定版本（Version）和测试版本（Check-In），满足不同场景需求。
• 临时构建管理：自动清理过期测试构建，仅保留必要版本，优化存储占用。
• Podman兼容：支持Podman自动化部署流程，适应现代容器化部署需求。

使用场景与适用范围

• 自动化部署环境：适用于采用Podman进行自动化部署的系统。
• 版本控制测试：需要验证Fossil新功能、变更或修复的开发/测试场景。
• 稳定版本管理：适合需要使用最新稳定版Fossil进行版本控制的生产或开发环境。

使用方法与配置说明

基本要求

容器期望版本库路径为/museum/repo.fossil，必须通过绑定挂载目录（而非单个文件） 提供，以支持WAL模式。建议在主机侧将目录命名为更具描述性的名称。

部署示例

Docker运行命令：

bash
docker run \
    --publish localhost:9999:8080 \
    --name fossil-myproject \
    --volume ~/museum/myproject:/museum \
    tangentsoft/fossil

• --publish localhost:9999:8080：将容器8080端口绑定到主机localhost的9999端口，适合前端代理场景。
• --volume ~/museum/myproject:/museum：将主机~/museum/myproject目录挂载到容器/museum，其中应包含repo.fossil版本库文件。

部署建议

• 若需集成到现有服务架构，建议将容器部署在前端代理之后，通过绑定localhost高端口（如示例中的9999）提高安全性。
• 选择标签时，生产环境推荐使用version-*标签；测试新功能时可使用Check-In标签，但需注意其临时性。

参考文档

更多详细配置与使用说明，请参考Fossil容器官方文档。