Harness 使用教程

📖 项目简介

Harness Open Source（开源时期也叫 Gitness）是 Harness 团队推出的 一体化自托管开发平台，可以理解成「自己部署的私有 GitHub + 流水线」。它把 Git 代码托管、CI/CD 流水线、云开发环境（Gitspaces）、制品仓库四大能力打包进一个轻量服务里，用 Go 语言编写，跑起来只要 ~100MB 内存，采用 Apache-2.0 协议，可免费商用。

它特别适合搭配 Codex 这类 AI 编程工具：Codex 负责快速写代码，Harness 负责把代码 托管、自动测试、自动部署上线，再加上云端开发环境和镜像/软件包仓库，一个人也能拥有一整套完整的研发流水线。流水线语法兼容 Drone CI（YAML），熟悉 GitHub Actions 的同学几乎零成本上手。

📎 相关链接与下载地址（点击展开）

GitHub 项目： github.com/harness/harness
官方文档： docs.gitness.com
官网介绍： harness.io/open-source
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🐙

私有 Git 托管

仓库管理、分支保护、Pull Request、代码评审，一应俱全

🔄

内置 CI/CD

基于 Drone 引擎，YAML 定义流水线，构建/测试/部署全自动

☁️

Gitspaces 云开发

浏览器里秒开预配置开发环境，告别"在我机器上没问题"

📦

制品仓库

托管 Docker 镜像、Helm Chart、软件包，统一管理依赖

🪶

极致轻量

Go 编写，约 100MB 内存即可运行，远低于 GitLab 的数 G

🆓

开源免费

Apache-2.0 协议，可自由商用自托管，无功能阉割

🚀 如何使用

💡

环境要求：一台装好 Docker 的机器（Windows / macOS / Linux 均可，支持 Docker Desktop、Rancher Desktop、Colima 等）。流水线运行在 Docker 容器里，无需额外配置。

一行命令启动 Harness

用 Docker 拉起官方镜像即可，数据持久化到本地目录，启动后浏览器访问本机端口即可进入：

                        bash
                        docker run -d \
  --name harness \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v harness-data:/data \
  harness/harness
                    

启动完成后，在浏览器打开本机 3000 端口，注册第一个管理员账号即可。

创建私有仓库，推送 Codex 写的代码

在界面里「新建仓库」，得到一个私有 Git 地址。把 Codex 生成的本地项目推送上去：

                        bash
                        git init
git add .
git commit -m "feat: codex 初始化项目"
git remote add origin <你的-harness-仓库地址>
git push -u origin main
                    

添加流水线，自动测试 + 部署

在仓库根目录新建 .harness/pipeline.yaml（语法兼容 Drone CI），定义构建、测试、部署阶段。每次 push 或合并 PR 都会自动触发流水线：

                        yaml
                        kind: pipeline
type: docker
name: build-test-deploy
steps:
  - name: install
    image: node:20
    commands:
      - npm ci
  - name: test
    image: node:20
    commands:
      - npm test
  - name: deploy
    image: node:20
    commands:
      - npm run build
      - ./scripts/deploy.sh
                    

开通云开发环境 + 制品仓库（可选）

在「Gitspaces」里为仓库一键开通浏览器内的云开发环境，预装好依赖即开即用；构建产物（Docker 镜像、软件包）可推送到内置「制品仓库」统一管理，配合流水线实现从写代码到上线的全流程闭环。

✅

搭配 Codex 的典型玩法：Codex 写代码 → push 到 Harness 私有仓库 → 流水线自动测试部署 → 制品仓库管理镜像，一个人就能跑通完整 DevOps 流程。

❓ 常见问题

Q: 它和 GitHub、GitLab 有什么区别？

Harness 是完全自托管的，代码、流水线、镜像全在你自己的服务器上，数据不出本地，没有云端依赖。相比 GitLab 动辄 4G+ 内存，它只要约 100MB，部署和维护成本低很多，特别适合个人和小团队。

Q: 必须用 Codex 吗？

不是。Harness 是独立的 DevOps 平台，任何方式写的代码都能托管。只是 Codex 这类 AI 编程工具出码速度快，配上 Harness 的自动测试和部署，正好补齐「写完之后怎么上线」这一环，所以两者搭配很顺手。

Q: 流水线语法难学吗？

不难。它兼容 Drone CI 的 YAML 语法，结构和 GitHub Actions 很像（stages / steps / commands），熟悉任意一种 CI 的同学基本看一眼就会写。官方还提供了大量可复用的流水线模板。

Q: 支持从其他平台迁移吗？

支持。Harness Open Source 提供一键导入，可从 GitHub、GitLab、Bitbucket 等平台迁移代码仓库和流水线，迁移成本很低。