这些命令分四种类型:①不需要和其他开发者协作的独立开发者,会经常用到 git init、git show branch、git commit 等命令;②需要和其他人协作的开发者,会常用到 git clone、git push、git pull、git format patch 。③在项目中负责接收其他开发者发来更新的核心开发者,会常用到 git am、git pull、git format patch、git revert、git push;④ 代码仓库管理员常用 git daemon、git shell……
对于任何想做提交的人来说,甚至对于某位单独工作的人来说,【个人开发者(单独开发)】部分命令都是必不可少的。如果你和别人一起工作,你也会需要【个人开发者(参与者)】部分列出的命令。
除了上述的部分,担当【集成人员】角色的人需要知道更多命令。【代码库管理】命令帮助系统管理员负责管理,及向git代码库提交内容。
个人开发者(单独开发)
单独的个人开发者不会与他人交换修补程序,只用到下列命令,独自在单独的代码库上工作:
- git-init(1)用来创建新代码库。
- git-show-branch(1)用来查看你在哪里。
- git-log(1)查看发生过什么。
- git-checkout(1)和git-branch(1)用来切换分支。
- git-add(1)用来管理索引文件。
- git-diff(1)和git-status(1)查看你正在做什么。
- git-commit(1)将内容推进现分支
- git-reset(1)和git-checkout(1)(带路径名 参数)放弃修改。
- git-merge(1)用来合并本地分支
- git-rebase(1)用来维护主题分支
- git-tag(1)用来给已知点打标签
实例
-
用Tar包作为一个新代码库的起始点
- 添加现目录下的所有文件。
- 打一个轻量的无注释的标签。
-
12345678910111213141516
$ git checkout -b alsa-audio <1>
$ edit
/compile/test
$ git checkout -- curses
/ux_audio_oss
.c <2>
$ git add curses
/ux_audio_alsa
.c <3>
$ edit
/compile/test
$ git
diff
HEAD <4>
$ git commit -a -s <5>
$ edit
/compile/test
$ git reset --soft HEAD^ <6>
$ edit
/compile/test
$ git
diff
ORIG_HEAD <7>
$ git commit -a -c ORIG_HEAD <8>
$ git checkout master <9>
$ git merge alsa-audio <10>
$ git log --since=
'3 days ago'
<11>
$ git log v2.43.. curses/ <12>
- 创建一个主题分支。
- 还原你在curses/ux_audio_oss.c文件里搞砸了的修改。
- 如果你要添加一个新文件是,你需要告诉git;之后,如果你使用git commit -a, 删除和修改就会被捕获。
- 查看你正在提交什么修改。
- 提交你已签署了的所有已测试文件。
- 退回到上一个提交,并保留工作树。
- 查看自从上一个不成熟提交后的修改。
- 使用原先写过的信息,重做在之前步骤中撤销了的提交。
- 切换到主干分支。
- 把主题分支合并到你的主分支。
- 回顾提交记录;其他限制输出的形式也可以合并包含: –max-count=10(显示10个提交),–until=2005-12-10等
- 只查看影响到在curses/目录里,从v2.43标签开始的修改。
1
2
3
4
5
6
|
$
tar
zxf frotz.
tar
.gz
$
cd
frotz
$ git init
$ git add . <1>
$ git commit -m
"import of frotz source tree."
$ git tag v2.43 <2>
|
个人开发者(参与开发)
作为在一个团体项目里参与角色的开发人员,需要学习如何与他人沟通,除了那些单独开发者需要掌握的命令以外,还要使用这些命令。
- git-clone(1)从上游代码库填充你的本地代码库。
- git-pull(1)和git-fetch(1)从“origin”得到最新的上游代码库。
- git-push(1)用来共享代码库,如果你采用cvs风格的代码库工作流的话。
- git-format-patch(1)用来准备e-mail提交,如果你使用Linux内核风格的公共论坛工作流的话。
实例
-
复制上游代码库并在其之上工作。提交修改到上游代码库
- 按需重复。
- 从你的分支中提取补丁文件,用于电子邮件提交。
- git pull命令默认从“origin”里取得内容并合并到当前的分支中去。
- 在拉过内容之后,立即查看在上游仓库中从上次我们检查过之后提交的修改,只检查我们关心的区域。
- 从一个指定代码库的一个指定分支获取内容并合并。
- 撤销拉操作。
- 从撤销的拉操作中回收残存的对象。
- 不时地,从origin处获取官方的标签,并保存于.git/refs/tags/ 。
-
123456789101112131415
satellite$ git clone mothership:frotz frotz <1>
satellite$
cd
frotz
satellite$ git config --get-regexp
'^(remote|branch)\.'
<2>
remote.origin.url mothership:frotz
remote.origin.fetch refs
/heads/
*:refs
/remotes/origin/
*
branch.master.remote origin
branch.master.merge refs
/heads/master
satellite$ git config remote.origin.push \
master:refs
/remotes/satellite/master
<3>
satellite$ edit
/compile/test/commit
satellite$ git push origin <4>
mothership$
cd
frotz
mothership$ git checkout master
mothership$ git merge satellite
/master
<5>
- mothership机器在你的home目录下有一个frotz代码库;将它复制,以在satellite机器上启动一个代码库。
- 复制操作默认设定这些配置变量。它安排git pull去抓取并保存mothership机上的分支到本地的remotes/origin/* 的跟踪分支上。
- 安排git push去推送本地的主分支到mothership机的remotes/satellite/master分支
- 推操作会在mothership机的remotes/satellite/master的远程跟踪分支上收藏我们的工作。你可以用此作为一个备用方法。
- 在mothership机上,将satellite机上已完成的工作合并到master分支去。
分支的特定标签
-
12345
$ git checkout -b private2.6.14 v2.6.14 <1>
$ edit
/compile/test
; git commit -a
$ git checkout master
$ git
format
-patch -k -m --stdout v2.6.14..private2.6.14 |
git am -3 -k <2>
- 创建一个私有分支,基于熟知(但稍许过时的)标签。
- 在没有正式的“合并”下,向前移植所有private2.6.14分支的修改到master分支上。
1
|
$ git clone git:
//git
.kernel.org
/pub/scm/
...
/torvalds/linux-2
.6 my2.6
|
1
2
3
4
5
6
7
8
9
|
$
cd
my2.6
$ edit
/compile/test
; git commit -a -s <1>
$ git
format
-patch origin <2>
$ git pull <3>
$ git log -p ORIG_HEAD.. arch
/i386
include
/asm-i386
<4>
$ git pull git:
//git
.kernel.org
/pub/
...
/jgarzik/libata-dev
.git ALL <5>
$ git reset --hard ORIG_HEAD <6>
$ git gc <7>
$ git fetch --tags <8>
|
集成人员
在一个团队项目中担任集成者的是一名相当重要的人员,他接受别人的修改,评审并且集成并且发布结果,供他人使用;除了那些参与者需要的命令之外,还会使用这些命令。
- git-am(1)用来采用你的贡献者发电邮寄来的补丁文件。
- git-pull(1)用来从你的可信任的助手处合并内容。
- git-format-patch(1)用来准备并向你的贡献者发送建议选项。
- git-revert(1)用来撤销不好的提交。
- git-push(1)用来发布最新的内容。
实例
-
我典型的GIT一天。
-
1234567891011121314151617181920
$ git status <1>
$ git show-branch <2>
$ mailx <3>
s 2 3 4 5 ./+to-apply
s 7 8 ./+hold-linus
q
$ git checkout -b topic
/one
master
$ git am -3 -i -s -u ./+to-apply <4>
$ compile
/test
$ git checkout -b hold
/linus
&& git am -3 -i -s -u ./+hold-linus <5>
$ git checkout topic
/one
&& git rebase master <6>
$ git checkout pu && git reset --hard next <7>
$ git merge topic
/one
topic
/two
&& git merge hold
/linus
<8>
$ git checkout maint
$ git cherry-pick master~4 <9>
$ compile
/test
$ git tag -s -m
"GIT 0.99.9x"
v0.99.9x <10>
$ git fetch ko && git show-branch master maint
'tags/ko-*'
<11>
$ git push ko <12>
$ git push ko v0.99.9x <13>
- 查看我正在做什么,如果有的话。
- 查看我拥有的主题分支,并考虑它们的完成度。
- 读邮件,保存合适的,并且保存那些尚未完成的。
- 采用它们,交互式地,带着我的签名。
- 按需创建主题分支,还是由我签名采用。
- 为内部的还未合并到主分支,也没有作为稳定分支的一部分公开的主题分支重定基线。
- 从接下来开始,每次都重启pu。
- 合并仍然在料理中的主题分支
- 向后移植极其重要的修正。
- 创建一个签名的标签。
- 确保我不会意外将主分支回滚到我已经推出来的内容。简写的ko指向我在kernel.org上已有的代码库里,看起来像这样:
123456789
$
cat
.git
/remotes/ko
URL: kernel.org:
/pub/scm/git/git
.git
Pull: master:refs
/tags/ko-master
Pull: next:refs
/tags/ko-next
Pull: maint:refs
/tags/ko-maint
Push: master
Push: next
Push: +pu
Push: maint
在从git show-branch的输出里,主分支应该有所有ko-master有的,并且next应该有ko-next有的所有内容。
- 推出最新内容
- 也推标签
代码库管理
代码库管理员使用下列工具来设置及维护开发者对代码库的访问。
- git-daemon(1)允许匿名者从代码库下载
- git-shell(1)可以被用作为限制登录shell,用于共享中央代码库的用户
update hook howto有一个很好的管理共享中央代码库的实例。
实例
-
我们假设下面的内容均在/etc/services目录下。
-
123456789101112131415
$
cat
/etc/xinetd
.d
/git-daemon
# default: off
# description: The git server offers access to git repositories
service git
{
disable = no
type
= UNLISTED
port = 9418
socket_type = stream
wait = no
user = nobody
server =
/usr/bin/git-daemon
server_args = --inetd --
export
-all --base-path=
/pub/scm
log_on_failure += USERID
}
检查xinetd(8)文档并设置,这个文档来自于Fedora系统。其他也许会不一样。
授予开发者只推/拉访问操作权限。$ grep git /etc/passwd <1> alice:x:1000:1000::/home/alice:/usr/bin/git-shell bob:x:1001:1001::/home/bob:/usr/bin/git-shell cindy:x:1002:1002::/home/cindy:/usr/bin/git-shell david:x:1003:1003::/home/david:/usr/bin/git-shell $ grep git /etc/shells <2> /usr/bin/git-shell
- 登录shell被设置到/usr/bin/git-shell, 不允许git push和git pull以外的任何操作。用户应该会获得一个访问此机器的ssh权限。
- 在许多发布版本中,/etc/shells需要列出作为一个登录shell需要的内容。
CVS风格的共享代码库
1234567891011121314151617181920$
grep
git
/etc/group
<1>
git:x:9418:alice,bob,cindy,david
$
cd
/home/devo
.git
$
ls
-l <2>
lrwxrwxrwx 1 david git 17 Dec 4 22:40 HEAD -> refs
/heads/master
drwxrwsr-x 2 david git 4096 Dec 4 22:40 branches
-rw-rw-r-- 1 david git 84 Dec 4 22:40 config
-rw-rw-r-- 1 david git 58 Dec 4 22:40 description
drwxrwsr-x 2 david git 4096 Dec 4 22:40 hooks
-rw-rw-r-- 1 david git 37504 Dec 4 22:40 index
drwxrwsr-x 2 david git 4096 Dec 4 22:40 info
drwxrwsr-x 4 david git 4096 Dec 4 22:40 objects
drwxrwsr-x 4 david git 4096 Nov 7 14:58 refs
drwxrwsr-x 2 david git 4096 Dec 4 22:40 remotes
$
ls
-l hooks
/update
<3>
-r-xr-xr-x 1 david git 3536 Dec 4 22:40 update
$
cat
info
/allowed-users
<4>
refs
/heads/master
alice\|cindy
refs
/heads/doc-update
bob
refs
/tags/v
[0-9]* david
- 把开发者置于同一git组中。
- 将共享代码库配为可被组写。
- 使用Carl的update-hook实例,这个实例在Documentation/howto/, 讲述了分支策略控制。
- alice和cindy可以推送到主分支,只有bob可以推送进doc-update。david是发布经理,并且是唯一一位可以创建并推送版本标签的人。
支持dumb协议传送的HTTP服务器
123dev$ git update-server-info <1>
dev$
ftp
user@isp.example.com <2>
ftp
>
cp
-r .git
/home/user/myproject
.git
- 确保你的info/refes和objects/info/packs是最新的。
- 上传到由你的ISP拥有的公共HTTP服务器。
1
2
|
$
grep
9418
/etc/services
git 9418
/tcp
# Git Version Control System
|
从inetd运行git-daemon来服务于/pub/scm
$ grep git /etc/inetd.conf git stream tcp nowait nobody \ /usr/bin/git-daemon git-daemon --inetd --export-all /pub/scm
实际的配置应该在1行里。
从xinetd运行git-daemon来服务于/pub/scm