Commit 557f96ff authored by Laurent Heirendt's avatar Laurent Heirendt
Browse files

Merge branch 'mirror-fork' into 'develop'

add howto card for mirroring fork

See merge request R3/howto-cards!225
parents f07f438c 897e7ae5
Pipeline #36400 passed with stages
in 1 minute and 20 seconds
......@@ -37,7 +37,7 @@ save:commitIndex:
entrypoint: [""]
stage: save
- if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_COMMIT_MESSAGE !~ /tmpBranch/ && $CI_COMMIT_MESSAGE !~ /Update index/'
- if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $CI_COMMIT_MESSAGE !~ /tmpBranch/ && $CI_COMMIT_MESSAGE !~ /Update index/ && $CI_PROJECT_NAMESPACE == "R3" && $CI_PROJECT_NAMESPACE == "R3-core"'
- apk add git-lfs
- git fetch --all
layout: page
permalink: /external/contribute/mirror-fork/
shortcut: contribute:mirror-fork
- /cards/contribute:mirror-fork
- /external/cards/contribute:mirror-fork
# How to mirror your fork automatically
In order to keep your fork up-to-date automatically with the main (also called `upstream`) repository,
you should follow the follow simple steps.
1. Go to `Settings > Repository`
2. Expand the section on `Mirroring repositories`
3. In the field `Git repository URL`, enter the SSH clone address from the main repository. In case of this repository, the address is `ssh://`
4. Select `Mirror Direction` as `Pull`
5. `Authentication method` should be selected as `SSH public key`
6. Then, click on the green button `Mirror repository`
You will see an entry in the table below the green button. Often, there is an error appearing. Now, in order to be able to perform the mirror, you need to set the SSH key.
1. Copy the SSH public key by clicking on the copy button (next to the sync button) located next to the red paper bin.
<img src="img/copy-ssh-key.png" height="80">
2. Then, browse to your profile picture (top right) and click on `Settings`
3. On the left of the page, click on `SSH keys`
4. Paste the key (using CTRL+V or CMD+V) into the SSH field
5. Click on `Add key`
Now, the synchronization of the fork should perform successfully. You can click on the sync button or wait a few minutes. :white_check_mark:
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment