Git笔记（36）打包

曾经终败给现在 2023-07-14 14:58 14阅读 0赞

### Git笔记（36） 打包 ###

*  1. 打包
 *  2. 举例

--------------------

# 1. 打包 #

虽然我们已经了解了网络传输 Git 数据的常用方法（如 HTTP，SSH 等）  
但还有另外一种不太常见却又十分有用的方式  
Git 可以将它的数据“打包”到一个文件中  
这在许多场景中都很有用

有可能你的网络中断了，但你又希望将你的提交传给你的合作者们  
可能你不在办公网中并且出于安全考虑没有给你接入内网的权限  
可能你的无线、有线网卡坏掉了  
可能你现在没有共享服务器的权限，又希望通过邮件将更新发送给别人  
却不希望通过 format-patch 的方式传输 40 个提交

这些情况下 `git bundle` 就会很有用

bundle 命令会将 git push 命令所传输的所有内容打包成一个二进制文件  
可以将这个文件通过邮件或者闪存传给其他人，然后解包到其他的仓库中

--------------------

# 2. 举例 #

来看看一个简单的例子  
假设你有一个包含两个提交的仓库：

$ git log
    commit 9a466c572fe88b195efd356c3f2bbeccdb504102
    Author: Scott Chacon <schacon@gmail.com>
    Date:   Wed Mar 10 07:34:10 2010 -0800
    
        second commit
    
    commit b1ec3248f39900d2a406049d762aa68e9641be25
    Author: Scott Chacon <schacon@gmail.com>
    Date:   Wed Mar 10 07:34:01 2010 -0800
    
        first commit

如果你想把这个仓库发送给其他人但你没有其他仓库的权限，或者就是懒得新建一个仓库  
你就可以用 `git bundle create` 命令来打包

$ git bundle create repo.bundle HEAD master
    Counting objects: 6, done.
    Delta compression using up to 2 threads.
    Compressing objects: 100% (2/2), done.
    Writing objects: 100% (6/6), 441 bytes, done.
    Total 6 (delta 0), reused 0 (delta 0)

然后就会有一个名为 `repo.bundle` 的文件，该文件包含了所有重建该仓库 `master` 分支所需的数据  
在使用 `bundle` 命令时，需要列出所有你希望打包的引用或者提交的区间

如果你希望这个仓库可以在别处被克隆，你应该像例子中那样增加一个 HEAD 引用

你可以将这个 `repo.bundle` 文件通过邮件或者U盘传给别人

另一方面，假设别人传给你一个 `repo.bundle` 文件并希望你在这个项目上工作  
你可以从这个二进制文件中克隆出一个目录，就像从一个 URL 克隆一样

$ git clone repo.bundle repo
    Cloning into 'repo'...
    ...
    $ cd repo
    $ git log --oneline
    9a466c5 second commit
    b1ec324 first commit

如果你在打包时没有包含 HEAD 引用，还需要在命令后指定一个 `-b master` 或者其他被引入的分支  
否则 Git 不知道应该检出哪一个分支

现在假设你提交了 3 个修订，并且要用邮件或者U盘将新的提交放在一个包里传回去

$ git log --oneline
    71b84da last commit - second repo
    c99cf5b fourth commit - second repo
    7011d3d third commit - second repo
    9a466c5 second commit
    b1ec324 first commit

首先需要确认我们希望被打包的提交区间  
和网络协议不太一样，网络协议会自动计算出所需传输的最小数据集，而需要手动计算  
当然你可以像上面那样将整个仓库打包  
但最好仅仅打包变更的部分 —— 就是我们刚刚在本地做的 3 个提交

为了实现这个目标，需要计算出差别  
就像我们在 提交区间 介绍的，你有很多种方式去指明一个提交区间  
可以使用 `origin/master..master` 或者 `master ^origin/master` 之类的方法  
来获取那 3 个在我们的 master 分支而不在原始仓库中的提交

可以用 log 命令来测试。

$ git log --oneline master ^origin/master
    71b84da last commit - second repo
    c99cf5b fourth commit - second repo
    7011d3d third commit - second repo

这样就获取到我们希望被打包的提交列表，让我们将这些提交打包  
可以用 `git bundle create` 命令，加上我们想用的文件名，以及要打包的提交区间

$ git bundle create commits.bundle master ^9a466c5
    Counting objects: 11, done.
    Delta compression using up to 2 threads.
    Compressing objects: 100% (3/3), done.
    Writing objects: 100% (9/9), 775 bytes, done.
    Total 9 (delta 0), reused 0 (delta 0)

现在在目录下会有一个 `commits.bundle` 文件  
如果我们把这个文件发送给我们的合作者，她可以将这个文件导入到原始的仓库中  
即使在这期间已经有其他的工作提交到这个仓库中

当她拿到这个包时，她可以在导入到仓库之前查看这个包里包含了什么内容  
`bundle verify` 命令可以检查这个文件是否是一个合法的 Git 包，是否拥有共同的祖先来导入

$ git bundle verify ../commits.bundle
    The bundle contains 1 ref
    71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master
    The bundle requires these 1 ref
    9a466c572fe88b195efd356c3f2bbeccdb504102 second commit
    ../commits.bundle is okay

如果打包工具仅仅把最后两个提交打包，而不是三个，原始的仓库是无法导入这个包的  
因为这个包缺失了必要的提交记录  
这时候 verify 的输出类似：

$ git bundle verify ../commits-bad.bundle
    error: Repository lacks these prerequisite commits:
    error: 7011d3d8fc200abe0ad561c011c3852a4b7bbe95 third commit - second repo

而我们的第一个包是合法的，所以我们可以从这个包里提取出提交  
如果你想查看这边包里可以导入哪些分支，同样有一个命令可以列出这些顶端：

$ git bundle list-heads ../commits.bundle
    71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master

`verify` 子命令同样可以告诉你有哪些顶端

该功能的目的是查看哪些是可以被拉入的  
所以你可以使用 fetch 或者 pull 命令从包中导入提交  
这里我们要从包中取出 master 分支到我们仓库中的 other-master 分支：

$ git fetch ../commits.bundle master:other-master
    From ../commits.bundle
     * [new branch]      master     -> other-master

可以看到我们已经将提交导入到 `other-master` 分支，以及在这期间我们自己在 master 分支上的提交

$ git log --oneline --decorate --graph --all
    * 8255d41 (HEAD, master) third commit - first repo
    | * 71b84da (other-master) last commit - second repo
    | * c99cf5b fourth commit - second repo
    | * 7011d3d third commit - second repo
    |/
    * 9a466c5 second commit
    * b1ec324 first commit

因此，当你在没有合适的网络或者可共享仓库的情况下  
`git bundle` 很适合用于共享或者网络类型的操作

--------------------

参考： [git][]  
以上内容，均根据git官网介绍删减、添加和修改组成

--------------------