技术文档丨国内环境下如何克隆Apollo仓库

本文档描述了在国内环境下既快又好地克隆Apollo仓库的方法。

  ENJOY THE FOLLOWING  

假设你已经「fork」了GitHub上的Apollo代码库。这可以通过点击GitHub上的Apollo页面右上角的「Fork」按钮并遵照随后的提示来完成。

码云上的Apollo仓库通常比GitHub上的Apollo仓库更新晚一个月左右。

我们可以以它为起点，克隆码云上的Apollo仓库。

执行命令：

git clone https://gitee.com/baidu/apolloauto.git apollo

<左右滑动以查看完整代码>

这一步通常很快，只需十数分钟。在本文作者所在的百度内部，下载速度可达10多MiB/s，终端输出如下：

1Cloning into 'apollo'...
2remote: Enumerating objects: 313277, done.
3remote: Counting objects: 100% (313277/313277), done.
4remote: Compressing objects: 100% (66199/66199), done.
5remote: Total 313277 (delta 245822), reused 310653 (delta 243198), pack-reused 0
6Receiving objects: 100% (313277/313277), 2.19 GiB | 11.10  MiB/s, done.
7Resolving deltas: 100% (245822/245822), done.
8Checking out files: 100% (9124/9124), done.

<左右滑动以查看完整代码>

上述步骤完成后，就可以「过河拆桥」，将远程分支origin重置为你刚 「fork」的GitHub分支。

git remote set-url origin [e-mail]:<你的GitHub 用户名>/apollo.git

<左右滑动以查看完整代码>

1采用SSH的方式
2git remote add upstream [e-mail]:ApolloAuto/apollo.git
3
4# 采用HTTPS的方式
5git remote add upstream https://github.com/ApolloAuto/apollo.git    

<左右滑动以查看完整代码>

你可以运行如下命令来确认远程分支origin和upstream已被正确设置：

git remote -v

<左右滑动以查看完整代码>

如果之前的操作正确，它将列出如下的远端分支：

1origin    [e-mail]:<你的GitHub 用户名>/apollo.git (fetch)
2origin    [e-mail]:<你的GitHub 用户名>/apollo.git (push)
3upstream    [e-mail]:ApolloAuto/apollo.git (fetch)
4upstream    [e-mail]:ApolloAuto/apollo.git (push)

<左右滑动以查看完整代码>

it pull --rebase upstream master

<左右滑动以查看完整代码>

如果遇到问题，你可以参考这篇文档：《国内环境拉取GitHub仓库慢的缓解方案》（链接见文末）。

恭喜你成功地克隆了Apollo Gitee/GitHub仓库，并由此开启你的Apollo自动驾驶之旅！

*《国内环境拉取GitHub仓库慢的缓解方案》

https://github.com/ApolloAuto/apollo/blob/master/docs/howto/how_to_solve_slow_pull_from_cn.md

以上是"国内环境下如何克隆Apollo仓库"的全部内容，更多话题讨论、技术交流可以扫描下方二维码添加『Apollo小哥哥』为好友，进开发者交流群。