fit命令行使用手册 分享链接

安装

普通安装

从官网下载后，执行安装命令

chmod +x ./fit-installer
./fit-installer

安装将执行以下步骤：

1. 初始化配置文件 $HOME/.fit.yaml

2. 在用户家目录创建 bin 文件夹，并且将当前二进制命令拷贝至该目录下

3. 修改了 PATH 环境变量，确保$HOME/bin 处于第一优先级

   1. linux 通过修改 ~/.bashrc 或 ~/.zshrc
   2. Windows 会修改系统环境变量

4. 在用户家目录 bin下创建 git软链接，指向同级目录的 fit

禅道下载安装

从禅道下载个人 fit 命令行工具，执行命令

chmod +x ./fit-installer
./fit-installer

与普通安装过程相比，通过此途径下载的命令，会自动登陆到禅道（todo）和 gitfox，

相关帐号和服务器信息可在配置文件 $HOME/.fit.yaml 看到

重载会话

打开新的终端，使修改的环境变量生效。

此时应能执行 fit命令了

可以输入 fit version进行确认

Fit info:
  Release: 0.2.0
  BuildTime: 2024092615
  GitCommit: a3f06b4
  Platform: linux/amd64
------------------
git version 2.44.0

确认git 命令已被指向到 fit命令

通过 which git 确认 git 命令的路径是 $HOME/bin/git

通过 ls -l $(which git)来确认生成了软链接且指向了 fit

使用说明

可以用 fit 执行原生 git命令的所有子命令，并对部分子命令设置了 hook，在调用原生的 git 命令前，加入一些自定义功能

hook 的触发：

1. 仅对 gitfox 服务器的仓库生效
   1. 属于其它 git 服务器的仓库会透明传递参数给原生 git 命令
   2. 本地仓库的 url 与 fit 配置文件的主机匹配，才会被识别为 gitfox 的仓库
2. 部分 hook 需要该仓库在 gitfox 里开启了对应的高级设置

fit 拦截了以下子命令

• clone
• pull
• commit
• push
• version

自身提供的子命令

• login
• cred
• version

其它的子命令都会透明传递给原生 git命令行来处理

子命令详解

登陆

fit 专属

fit login --host http://127.0.0.1:3000 -u  -p

该命令适用场景：

• 主动添加一个 gitfox 服务器
• 修改现有某个 gitfox 服务器的用户信息

克隆

git clone http://:/.git

拦截

将解析 git url，如果主机存在于 fit 配置文件中，将执行免密克隆

拉取

git pull

拦截

将检查仓库配置，确保由 fit 来处理拉取代码时的帐号认证

将检查该仓库在服务端配置，如果开启了 代码强制评审 功能，将修改拉取参数，从而能正确变基合并

提交

git commit

拦截

会检查本地仓库 git conifg 的用户信息，如果邮箱与服务端对应用户的邮箱不一致，则拒绝提交。

判断仓库在服务端是否开启了 提交行数限制 ，如开启，将对当前缓冲区的代码变更进行统计，如果超出限制，则拒绝提交。

推送

git push

拦截

将检查该仓库在服务端配置，如果开启了 代码强制评审 功能，将修改推送参数，推到评审分支上

版本

git version

拦截

用于输出当前命令行版本信息，将首先输出 Fit 相关的构建信息，包括版本号、构建日志、提交id、操作系统和架构，

然后将执行原生 git version 命令显示其版本号

凭据管理

fit专属

fit cred

fit 命令行实现了凭据管理器接口，通过 cred 子命令提供。用来提供在 clone,pull,push时的帐号认证。

仅对 fit 管理的 gitfox 代码仓库有效。

FAQ

Q: 我想用回系统原生的 git 命令

A: 删除家目录下的 bin/git 文件，该文件是一个软链接

Q: 如何确认我的 git 命令是 fit 代理的

A: 执行 git version，如果显示了 Fit Info 相关内容，便是 fit 代理了

Q: 我的 GitFox 密码修改了，如何让 fit 更新密码

A: 执行 fit login 输入你的主机地址、用户名和密码，验证通过后将更新到配置文件中

Q: 我有一个新的 GitFox 服务想要加入到 fit 管理

A:

方法1: 执行 fit login 输入你的主机地址、用户名和密码，验证通过后将添加到配置文件中

方法2: 从禅道进入该服务器的某个仓库，下载 fit-installer，执行该程序，会将该服务器的配置添加或更新到配置文件中