ehdevops/ownership

Git文件所有权收集工具镜像

镜像概述

本Docker镜像专为解析Git仓库中CODEOWNER文件并收集文件路径所有权信息而设计。通过自动化提取文件路径与负责人（团队或个人）的映射关系，帮助团队高效管理代码责任归属，支持集成到各类开发和协作流程中。

核心功能和特性

• CODEOWNER解析：自动识别并解析Git仓库中的CODEOWNER文件，提取文件路径规则与对应所有者信息
• 文件路径查询：支持指定单个或多个文件路径，返回其对应的所有权信息
• 批量处理：可批量查询目录下所有文件的所有权，生成汇总报告
• 轻量集成：无需本地安装依赖，通过Docker容器化方式快速运行，兼容各类环境
• Git原生支持：直接读取Git仓库结构，确保路径解析与仓库实际结构一致

使用场景和适用范围

• 代码审查自动化：在CI/CD流程中自动识别变更文件的负责人，触发针对性审查通知
• 权限审计：定期检查代码库所有权配置，确保符合团队权限管理规范
• 团队协作管理：明确各模块/文件的责任主体，提升跨团队协作效率
• 合规检查：满足审计要求，记录文件所有权变更历史

使用方法和配置说明

基本使用流程

1. 确保本地已安装Docker并启动
2. 准备包含CODEOWNER文件的Git仓库（本地目录或克隆到本地）
3. 通过docker run命令运行镜像，挂载仓库目录并指定查询参数

常用命令示例

查询单个文件所有权

bash
docker run -v /local/path/to/git/repo:/repo docker.xuanyuan.run/your-image-name \
  --file /repo/src/utils/helpers.js

• 说明：
  -v /local/path/to/git/repo:/repo：将本地Git仓库目录挂载到容器内/repo路径
  --file /repo/src/utils/helpers.js：指定要查询的文件路径（容器内绝对路径，需相对于挂载的仓库根目录）

批量查询目录下所有文件

bash
docker run -v /local/path/to/git/repo:/repo docker.xuanyuan.run/your-image-name \
  --dir /repo/src/components \
  --output /repo/ownership-report.txt

• 说明：
  --dir：指定要批量查询的目录路径
  --output：将查询结果输出到指定文件（需挂载仓库目录以持久化保存结果）

配置参数说明

注意事项

• 确保挂载的Git仓库目录包含完整的.git子目录，以保证路径解析准确性
• CODEOWNER文件需符合Git规范格式（支持标准模式匹配语法）
• 对于大型仓库，建议通过--dir参数分目录查询以提升性能
• 输出文件需确保容器对目标路径有写入权限（可通过挂载本地目录实现）