diff options
Diffstat (limited to 'doc/user/project/repository/mirror/pull.md')
| -rw-r--r-- | doc/user/project/repository/mirror/pull.md | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/user/project/repository/mirror/pull.md b/doc/user/project/repository/mirror/pull.md index 1463e0de0f1..56e85157c03 100644 --- a/doc/user/project/repository/mirror/pull.md +++ b/doc/user/project/repository/mirror/pull.md @@ -15,13 +15,16 @@ branches, tags, and commits from an upstream repository to yours. Unlike [push mirrors](push.md), pull mirrors retrieve changes from an upstream (remote) repository on a scheduled basis. To prevent the mirror from diverging from the upstream repository, don't push commits directly to the downstream mirror. Push commits to -the upstream repository instead. Changes in the remote repository are pulled into the GitLab repository, either: +the upstream repository instead. Changes in the remote repository are pulled into the GitLab repository: -- Automatically in a certain period of time. Self-managed instances can - configure [pull mirroring intervals](../../../../administration/instance_limits.md#pull-mirroring-interval). +- Automatically, 30 minutes after a previous pull. This cannot be disabled. - When an administrator [force-updates the mirror](index.md#force-an-update). - When an [API call triggers an update](#trigger-an-update-by-using-the-api). +UI and API updates are subject to default +[pull mirroring intervals](../../../../administration/instance_limits.md#pull-mirroring-interval) +of 5 minutes. This interval can be configured by self-managed instances. + By default, if any branch or tag on the downstream pull mirror diverges from the local repository, GitLab stops updating the branch. This prevents data loss. Deleted branches and tags in the upstream repository are not reflected in the @@ -52,13 +55,14 @@ After you configure a GitLab repository as a pull mirror: ## Configure pull mirroring -Prerequisite: +Prerequisites: - If your remote repository is on GitHub and you have [two-factor authentication (2FA) configured](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa), create a [personal access token for GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) with the `repo` scope. If 2FA is enabled, this personal access token serves as your GitHub password. +- [GitLab Silent Mode](../../../../administration/silent_mode/index.md) is not enabled. 1. On the left sidebar, at the top, select **Search GitLab** (**{search}**) to find your project. 1. Select **Settings > Repository**. |