安装与配置

安装 git-repo

依赖

git-repo 依赖 git,在安装 git-repo 之前,需要确保已经安装了 git。

下载和安装 git-repo

  1. 访问 git-repo 的下载页面: https://git-repo.info/zh_cn/。根据您的平台类型(Linux、Mac、或是 Windows),CPU 类型(amd64 或 386)下载合适的软件包。

  2. 如果是 Linux 或者 Mac OS X 平台,为下载文件设置可执行权限。例如:

    $ chmod a+x git-repo
  3. 将下载的可执行文件复制到可执行目录。对于 Linux 和 Mac OS X 平台,这个目录可以是/usr/local/bin 或者其他目录。对于 Windows 平台,这个目录可能是 C:\Windows\system32

    $ git repo --version

运行 git-repo

安装完毕,尝试执行下面命令。注意下面命令中 git 和 repo 之间可以不再需要短线,因为repo 命令已经自动注册为 git 的一个子命令。

$ git repo --version

运行后,可以查看 git-repo 帮助

$ git repo -h

或者

$ git repo
注意

:如果使用 git repo --help 或者 git help repo,则无法显示 git-repo 的帮助,因为这些命令激活了 git 的 man 手册,而非 git-repo 内置的帮助系统。

git repo 有很多子命令。可以用如下命令查看子命令的帮助:

$ git repo help sync

配置 git-repo

在用户主目录下的 .git-repo/config.yml 文件,可以修改 git-repo 默认设置。如:

  • verbose: 1 1: 显示 Info 级别日志;2: 显示 Debug 级别数据。

  • loglevel: warning 设置打印到日志时的日志级别

  • logrotate: <size> 日志回滚大小,默认 20MB

  • logfile: <file> 设置日志文件名称

软件升级

运行下面命令升级 git-repo:

$ git repo upgrade

升级服务器自动下载相应平台的 git-repo 升级包,完成应用的替换和升级。

如果由于文件权限或者其它原因导致升级失败,会给出错误提示。例如:

$ git repo upgrade
    Download git-repo: ############################################################ 100%
    +--------------------------------------------------------------------------------+
    | Fail to upgrade. Please copy                                                   |
    |         /var/folders/5d/21v9l2z12j/T/git-repo-0.2.0-619707833                  |
    | to                                                                             |
    |         /usr/bin/git-repo                                                      |
    | by hands                                                                       |
    +--------------------------------------------------------------------------------+
    Error: upgrade failed

遇到类似上面的错误提示,手工完成文件复制。例如:

sudo cp /var/folders/5d/21v9l2z12j/T/git-repo-0.2.0-619707833 /usr/bin/git-repo

命令格式

git repo upgrade [options...]

选项

主要的选项如下://todo 修改下载地址

  • --url <URL>:使用指定的升级服务器地址。默认使用https://github.com/alibaba/git-repo-go/releases作为升级服务器地址。

  • --test:升级到测试版本。测试版本是由升级服务器的 version.yml 的 test 字段定义的。