代码库

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

作者:赵红梅 最后编辑:赵红梅 于 2024-10-10 15:40:16 浏览量:62

安装

普通安装

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

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,首次使用需登陆 gitfox

用来添加或修改一个 gitfox 服务器配置,指定服务器地址,用户名和密码

其中密码必须是令牌


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,执行该程序,会将该服务器的配置添加或更新到配置文件中

返回顶部
杨苗
高级客户经理
13165050229
2692096539
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。