Harness Open Source 代码托管入门教程仓库管理、分支保护与 Git LFS 一次搞懂【免费下载链接】gitnessHarness Open Source is an end-to-end developer platform with Source Control Management, CI/CD Pipelines, Hosted Developer Environments, and Artifact Registries.项目地址: https://gitcode.com/gh_mirrors/gi/gitnessHarness Open Source 是一款开源端到端开发者平台内置代码托管Source Control Management、CI/CD 流水线、托管开发环境Gitspaces和制品库Artifact Registries四大核心能力。对于刚接触自托管 Git 服务的新手来说它相当于一个开源自建的 GitHub。本文带你零基础上手 Harness Open Source 的仓库管理、分支保护与Git LFS 大文件管理三大核心功能读完即可完成一个团队的规范化代码托管落地 1. Harness Open Source 是什么一分钟了解平台Harness Open Source 是 Drone 的下一代演进版本在保留 CI/CD 能力的基础上新增了代码托管、开发环境与制品库形成完整闭环。核心模块与源码目录的对应关系如下方便你按需深入功能模块对应源码目录说明API 层控制器/处理器app/api/对外 REST 接口与请求处理仓库服务app/services/repo/仓库创建、默认分支、仓库大小分支/标签/推送保护app/services/protection/保护规则引擎与校验逻辑Git LFS 传输app/api/handler/lfs/transfer.goLFS 对象上传/下载入口前端界面web/React 构建的 Web UI 平台架构总览与开发指南详见 README.md贡献规范见 CONTRIBUTING.md。2. 最快部署方法一条 Docker 命令跑起来Harness Open Source 官方提供 Docker 镜像一行命令即可在本地部署完整服务docker run -d \ -p 3000:3000 \ -p 3022:3022 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/harness:/data \ --name harness \ --restart always \ harness/harness⚠️ 注意两个关键点-v /tmp/harness:/data用于持久化数据库和仓库数据不加这个挂载容器停止后数据将全部丢失部署完成后浏览器访问http://localhost:3000即可进入 Harness Open Source 代码托管界面http://localhost:3000/swagger可查阅完整 REST API 文档。若需要本地克隆源码研究或二次开发可执行git clone https://gitcode.com/gh_mirrors/gi/gitness.git3. 仓库管理入门从 Space 到代码仓库3.1 先建 Space再建仓库Harness Open Source 采用Space空间→ Repository仓库两级组织结构。Space 是团队或项目的隔离边界权限、保护规则都可以按 Space 批量下发也可以只作用于单个仓库。操作流程全部在 Web 界面完成无需写代码登录界面 → 点击新建Space为团队/项目命名进入 Space → 点击New Repository填写仓库名、描述选择可见性私有/公开创建完成后页面会直接给出git clone地址支持HTTPS与SSH3022 端口两种协议。仓库相关的后端能力创建仓库、修改默认分支、统计仓库体积等实现在 app/services/repo/service.go 与 app/services/repo/reposize.go。3.2 默认分支团队协作的基准线每个仓库都有一个默认分支通常是main它决定了git clone后本地检出的分支未指定 ref 时页面浏览代码的起点保护规则的典型目标分支。默认分支的管理逻辑见 app/services/repo/handlers_default_branch.go。建议项目初期就确定默认分支并开启保护下一节避免主干被随意直推。4. 分支保护规则给 main 分支上三道锁分支保护是 Harness Open Source 最实用的治理能力之一其规则引擎位于 app/services/protection/。系统原生支持3 类保护规则4.1 分支保护Branch Protection核心文件app/services/protection/rule_branch.go、app/services/protection/verify_push.go。典型配置项按分支名 glob 模式匹配如main、release/*✅禁止直推所有变更必须走 Pull Request✅要求 PR 审核合并前需 N 人 approve✅要求状态检查通过CI 流水线绿了才能合并✅限制推送权限仅允许指定用户/用户组推送。4.2 标签保护与推送保护标签保护app/services/protection/rule_tag.go控制谁能打 tag、能删哪些 tag防止版本标签被乱改——对发布流程尤其重要推送保护app/services/protection/rule_push.go按仓库粒度限制推送行为如禁止 force push。4.3 规则的作用域与豁免机制保护规则可以定义在Space 级对整个空间所有仓库生效或仓库级只对单个仓库生效仓库级规则优先级更高。当某次操作违反规则时平台会在服务端直接拒绝并返回明确的违规原因错误信息的生成逻辑见 app/services/protection/service.go 中的GenerateErrorMessageForBlockingViolations。对于紧急变更平台提供了bypass豁免机制拥有相应权限的维护者可临时绕过保护规则合并代码豁免逻辑位于 app/services/protection/bypass.go。建议团队约定bypass 仅限线上事故修复事后必须补 PR 审核记录。 新手推荐配置main分支开启禁止直推 要求 PR 审核release/*分支开启限制推送权限即可覆盖 90% 的日常协作场景。5. Git LFS 大文件管理图片、模型、数据集不再撑爆仓库5.1 为什么需要 Git LFSGit 会把每个版本的文件内容都存进对象库二进制大文件设计稿 PSD、机器学习模型、视频素材、容器镜像层等反复提交会让仓库体积膨胀、clone 变慢。Git LFS 的思路是Git 仓库里只存一个轻量的指针文件pointer真正的文件内容存到 LFS 服务端按需下载。5.2 Harness Open Source 的 LFS 能力平台已内置完整的 Git LFS 服务端支持无需额外部署 LFS 服务能力源码位置说明LFS 对象上传/下载app/api/handler/lfs/transfer.go遵循标准 LFS batch APIapplication/vnd.git-lfsjson指针文件解析git/parser/lfs_pointers.go识别提交中的 LFS 指针传输方式types/enum/git_lfs.go支持basicHTTPS与ssh两种传输协议LFS 文件锁types/lfs.goLFSLock类型防止多人同时编辑同一二进制文件5.3 三步开启 LFS本地操作# 1. 安装 git-lfs 后在本地仓库初始化 git lfs install # 2. 指定需要托管的大文件类型 git lfs track *.psd git lfs track *.bin # 3. 将生成的 .gitattributes 提交后正常 push git add .gitattributes git commit -m chore: enable git-lfs for psd files git push之后 clone 该仓库时执行git lfs pull或新版 Git 自动执行即可拉取真实的大文件内容。 提示通过 SSH 推送大文件时Harness 同样支持 LFS-over-SSHgit-lfs-transfer服务协议解析见 ssh/server.go。6. 团队协作最佳实践清单命名规范Space 按业务线命名仓库名小写短横线分隔如api-gateway分支模型main永远可发布功能开发走feature/*分支 PR 合并保护先行新仓库创建后第一件事就是给main开启分支保护大文件零容忍.gitattributes中用 LFS 规则兜底CI 中定期检查仓库体积参考 app/services/repo/reposize.go 的统计方式标签即版本发布时用 tag 标记版本并配置标签保护防止误删。7. 常见问题 FAQQ1Harness Open Source 和 Drone 是什么关系Harness Open Source 是 Drone 的下一代演进版本最终目标是在流水线能力上与 Drone 完全对齐让 Drone 用户可以平滑迁移详见 README.md 的 Where is Drone? 章节。Q2数据存在哪里怎么备份数据库与仓库文件都存放在容器/data卷中即部署命令里-v /tmp/harness:/data挂载的目录。定期备份该目录即可完整恢复。Q3忘记把大文件加入 LFS 怎么办先删除大文件历史再开启 LFS 重新提交git filter-branch --index-filter git rm --cached --ignore-unmatch bigfile.bin --tag-name-filter cat -- --all。建议同时配合仓库体积检查尽早发现。Q4普通成员被分支保护拦住了怎么解决联系仓库 Owner/Maintainer 走 PR 流程或由有 bypass 权限的成员临时豁免合并见 app/services/protection/bypass.go。结语从一条 Docker 命令部署平台到 Space/仓库两级结构管理代码再到分支保护三道锁与 Git LFS 大文件托管Harness Open Source 用开箱即用的方式覆盖了团队代码托管的核心诉求。建议按本文顺序动手实操一遍部署 → 建仓 → 配保护 → 开 LFS一个下午即可搭建起规范化的私有代码托管环境 【免费下载链接】gitnessHarness Open Source is an end-to-end developer platform with Source Control Management, CI/CD Pipelines, Hosted Developer Environments, and Artifact Registries.项目地址: https://gitcode.com/gh_mirrors/gi/gitness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考