Harness 使用教程-cmzhiku

项目简介

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

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

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

核心亮点

🐙 私有 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 容器里，无需额外配置。

步骤 1

一行命令启动 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 端口，注册第一个管理员账号即可。

步骤 2

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

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

bash

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

步骤 3

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

在仓库根目录新建 .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

步骤 4

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

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