当前位置: 首页 > 工具软件 > repo > 使用案例 >

linux命令行使用repo

习华灿
2023-12-01

repo简介

repo是谷歌用python脚本写的调用git的一个脚本,并不是用于取代git,它简化了对多个git版本库的管理。用repo管理的版本库都需要使用git命令来进行操作。
大型项目模块化/组件化之后,各模块也作为独立的 git 仓库从主项目里剥离了出去,各模块各自管理自己的版本。每一个子项目都是一个git仓库,每个git仓库都有很多分支版本,为了方便统一管理各个子项目的git仓库,需要一个上层工具批量进行处理,因此诞生了repo。

安装repo

由于repo归根究底是用来简化对git的管理所以使用repo时必须保证已经安装了git。公版的repo可以使用命令下载:

sudo apt-get install repo

或者:

curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo  

可以通过curl工具从http://commondatastorage.googleapis.com/git-repo-downloads/repo获得,并且保存在文件~/bin/repo中我们也可以保存在任何路径中。由于~/bin/repo是一个python脚本,我们通过chmod命令赋予它可执行的权限,以便接下来我们可以通过repo命令来运行它。

在工作中公司很可能会给你提供一个公司用的repo,公版的repo会访问一些谷歌的网站有些是国家禁止的除非你翻墙否则repo init的时候就会报Errno 110 无法连接。因为组成repo工具的那些Python脚本本身也是一个git仓库,每次运行repo的时候都会去repo这个脚本中有个REPO_URL的地址中去安装repo自己的这个git仓库,公版的repo设置的repo git仓库的地址是一个谷歌的地址,国家禁止访问。一般公司都会将REPO_URL设置成一个自己公司的repo git地址。
repo个人理解就是一个可执行脚本,放在/usr/bin/比较好可以直接使用,如果你的系统中有很多个版本的repo,你也可以通过绝对路径选择使用哪个repo。作者都是下载下来公司提供的一个repo放到一个不容易被修改的地方,然后在/usr/bin/创建一个软连接,链接到我想使用的那个repo。

repo涉及到的仓库

repo也建立一个Git仓库,用来记录当前项目下各个子项目的git仓库分别处于哪一个分支,这个仓库通常叫做:manifest仓库(清单库)。
组成repo工具的那些Python脚本本身也是一个git仓库,我们称之为repo 仓库。
我们整个这个大项目的很多子项目也是git仓库。
到目前为止,我们提到了三种类型的git仓库,分别是repo仓库、manifest仓库和子项目仓库。
repo仓库通过manifest仓库可以获得所有子项目仓库的元信息。有了这些元信息之后,我们就可以通过repo仓库里面的python脚本来操作子项目。

manifest仓库(项目清单库)采用一个default.xml的文件来管理各个子项目:
default.xml

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <default remote="origin" sync-j="4" revision="master" />
  <remote fetch="git@XXX.XXX.XX.XX:XXX/" name="XXX" review="XXX.XXX.XX.XX:XXXX" />
  <remote fetch="git@XXX.XXX.XX.XX:XXX/" name="XXX" />

  <project groups='XXX' remote="XXX" revision="XXX" name="XXX" path="XXX">
    <copyfile dest="XXX" src="XXX" />
    <linkfile dest="XX/XX/" src="XXX"/>
  </project>
  
  <project remote="XXX" revision="XXX" name="XXX" path="XXX" />
  <repo-hooks enabled-list="post-sync" in-project="XXX/repohooks"/>
</manifest>

下面简单说明下default.xml中常用的参数:
default:default标签定义的属性,将作为标签的默认属性,在标签中,也可以重写这些属性。

  1. revision:默认分支
  2. remote:默认的远程版本库名称
  3. sync-j:表示在同步远程代码时,并发的任务数量

remote:描述了远程仓库的基本信息

  1. name:远程仓库的名称,通常我们看到的命名是origin
  2. fetch:git库地址
  3. review:用作code review的server地址

project:每一个repo管理的git库,就是对应到一个标签

  1. path:把代码下载到指定目录下
  2. name:该项目远程版本库的相对路径的名字
  3. groups:该项目远程版本库所属组
  4. revision:单独指定分支
  5. remote:单独指定远程版本库名称
  6. copyfile:project元素下的子元素copyfile,定义clone后从src到dest拷贝操作。
  7. linkfile:project元素下的子元素linkfile,定义clone后dest到src的软连接。

repo-hooks:repo钩子,in-project下面应该有一个与钩子同名的python文件。因此,如果您想支持预上传钩子,您需要创建一个名为post-sync.py的文件。Repo将在处理钩子时动态加载该模块,然后调用其中的主函数。

  1. in-project:定义挂钩的项目。该值必须与先前定义的元素的name属性(而不是属性)匹配。
  2. enabled-list:要使用的钩子列表,空格或逗号分隔。

repo 原理浅析

repo init执行过程,是会先在本地获取repo仓库,然后会去manifest仓库获取子项目仓库的元信息,进而去访问我们所需要的子项目仓库。
执行repo init -u <url>这里指定的url实际上就是manifest仓库的地址。执行这句运行了两个操作,安装了repo仓库和manifest仓库。repo init命令后面通过-b指定要在Manifest仓库中checkout出来的分支。
如果在执行repo sync命令时,没有指定–local-only选项,那么就下载远程仓库更新到本地仓库来。
repo脚本执行过程讲解可以参考:https://blog.csdn.net/sunjing_/article/details/93496344

常用命令

命令注释
repo init -u <url> -b <branch>初始化,-u指定manifest项目清单库地址,-b指定manifest仓库的分支,不指定分支会选择默认的分支
repo sync同步代码
repo start <branch> <project>创建并切换分支,类似git checkout -b
repo checkout <branch> <project>切换分支,类似git checkout。检出之前由repo start创建的分支。
repo status <project>状态查询,用于查看指定仓的工作空间,类似git status,如果不添加参数,则是查看所有仓 。
repo branchs <project>分支查询,类似git branch
repo diff <project>文件对比,类似git diff
repo upload <project>上传代码,将本地的新增或者修改代码上传到远程服务器。执行repo upload之前,需保证代码已经commit。
 类似资料: