- 1. 禅道DevOps解决方案介绍
- 1.1 关于禅道DevOps解决方案
- 2. 安装与升级
- 2.1 快速安装
- 3. 应用
- 3.1 管理应用
- 4. 代码库
- 5. 流水线
- 6. 制品库
- 6.1 管理制品库
- 7. 部署
- 8. DevOps设置
- 9. 命令行工具
- 9.1 安装及升级
- 9.2 status子命令说明
fit命令行使用手册 分享链接
本篇目录
安装
普通安装
从官网下载后,执行安装命令
chmod +x ./fit-installer
./fit-installer
安装将执行以下步骤:
-
初始化配置文件
$HOME/.fit.yaml
-
在用户家目录创建
bin
文件夹,并且将当前二进制命令拷贝至该目录下 -
修改了
PATH
环境变量,确保$HOME/bin
处于第一优先级-
linux 通过修改
~/.bashrc
或~/.zshrc
- Windows 会修改系统环境变量
-
linux 通过修改
-
在用户家目录
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 的触发:
-
仅对 gitfox 服务器的仓库生效
- 属于其它 git 服务器的仓库会透明传递参数给原生 git 命令
- 本地仓库的 url 与 fit 配置文件的主机匹配,才会被识别为 gitfox 的仓库
- 部分 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
,执行该程序,会将该服务器的配置添加或更新到配置文件中