Skip to content

Latest commit

 

History

History
81 lines (58 loc) · 2.14 KB

how_to_clone_apollo_repo_from_china.md

File metadata and controls

81 lines (58 loc) · 2.14 KB
Raw

How to Clone Apollo Repository from China

This document describes a smarter approach to clone Apollo repository for users from China.

Pre-requisites

  • Suppose you have forked Apollo Repository on GitHub. This is done by clicking the "Fork" button on the top-right of Apollo's Github Page and follow the instructions there.

First, clone Apollo from Gitee

Apollo on Gitee was one day later than Apollo on GitHub. We can use it as a good start.

git clone https://gitee.com/ApolloAuto/apollo.git

This step takes only serveral minutes, as the download rate can reach up-to > 10MiB/s tested on my machine with

the following console log:

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

Reset origin to your GitHub fork

git remote set-url origin [email protected]:YOUR_GITHUB_USERNAME/apollo.git

Set Apollo GitHub repo as upstream

# Using SSH
git remote add upstream [email protected]:ApolloAuto/apollo.git

# Using HTTPS
git remote add upstream https://github.com/ApolloAuto/apollo.git

You can confirm that the origin/upstream has been setup correctly by running:

git remote -v

It will show the list of remotes similar to the following:

origin	[email protected]:YOUR_GITHUB_USERNAME/apollo.git (fetch)
origin	[email protected]:YOUR_GITHUB_USERNAME/apollo.git (push)
upstream	[email protected]:ApolloAuto/apollo.git (fetch)
upstream	[email protected]:ApolloAuto/apollo.git (push)

Pull latest code from GitHub upstream

git pull --rebase upstream master

You can follow this guide on How to Workaround Slow Pull from CN.

Congrats!

You have successfully cloned Apollo repository. Good luck to your journey of autonomous driving with Apollo!