mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-11-16 19:25:09 +00:00
bd4c7ce578
This PR cleans up the docs in a way to make them simpler to ingest by our [docs repo](https://gitea.com/gitea/gitea-docusaurus). 1. It includes all of the sed invocations our ingestion did, removing the need to do it at build time. 2. It replaces the shortcode variable replacement method with `@variable@` style, simply for easier sed invocations when required. 3. It removes unused files and moves the docs up a level as cleanup. --------- Signed-off-by: jolheiser <john.olheiser@gmail.com>
4.8 KiB
4.8 KiB
| date | title | slug | sidebar_position | toc | draft | aliases | menu | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-05-23T09:00:00+08:00 | 仓库镜像 | repo-mirror | 45 | false | false |
|
|
仓库镜像
仓库镜像允许将仓库与外部源之间进行镜像。您可以使用它在仓库之间镜像分支、标签和提交。
使用场景
以下是一些仓库镜像的可能使用场景：
- 您迁移到了 Gitea，但仍需要在其他源中保留您的项目。在这种情况下，您可以简单地设置它以进行镜像到 Gitea（拉取），这样您的 Gitea 实例中就可以获取到所有必要的提交历史、标签和分支。
- 您在其他源中有一些旧项目，您不再主动使用，但出于归档目的不想删除。在这种情况下，您可以创建一个推送镜像，以便您的活跃的 Gitea 仓库可以将其更改推送到旧位置。
从远程仓库拉取
对于现有的远程仓库，您可以按照以下步骤设置拉取镜像：
- 在右上角的“创建...”菜单中选择“迁移外部仓库”。
- 选择远程仓库服务。
- 输入仓库的 URL。
- 如果仓库需要身份验证，请填写您的身份验证信息。
- 选中“该仓库将是一个镜像”复选框。
- 选择“迁移仓库”以保存配置。
现在，该仓库会定期从远程仓库进行镜像。您可以通过在仓库设置中选择“立即同步”来强制进行同步。
❗❗ **注意：**您只能为尚不存在于您的实例上的仓库设置拉取镜像。一旦仓库创建成功，您就无法再将其转换为拉取镜像。❗❗
推送到远程仓库
对于现有的仓库，您可以按照以下步骤设置推送镜像：
- 在仓库中，转到设置 > 仓库，然后进入镜像设置部分。
- 输入一个仓库的 URL。
- 如果仓库需要身份验证，请展开授权部分并填写您的身份验证信息。请注意，所请求的密码也可以是您的访问令牌。
- 选择添加推送镜像以保存配置。
该仓库现在会定期镜像到远程仓库。您可以通过选择立即同步来强制同步。如果出现错误，会显示一条消息帮助您解决问题。
❗❗ 注意： 这将强制推送到远程仓库。这将覆盖远程仓库中的任何更改！ ❗❗
从 Gitea 向 GitHub 设置推送镜像
要从 Gitea 设置镜像到 GitHub，您需要按照以下步骤进行操作：
- 创建一个具有选中 public_repo 选项的 GitHub 个人访问令牌。
- 在 GitHub 上创建一个同名的仓库。与 Gitea 不同，GitHub 不支持通过推送到远程来创建仓库。如果您的现有远程仓库与您的 Gitea 仓库具有相同的提交历史，您也可以使用现有的远程仓库。
- 在您的 Gitea 仓库设置中，填写Git 远程仓库 URL：
https://github.com/<your_github_group>/<your_github_project>.git。 - 使用您的 GitHub 用户名填写授权字段，并将个人访问令牌作为密码。
- （可选，适用于 Gitea 1.18+）选择
当推送新提交时同步，这样一旦有更改，镜像将会及时更新。如果您愿意，您还可以禁用定期同步。 - 选择添加推送镜像以保存配置。
仓库会很快进行推送。要强制推送，请选择立即同步按钮。
从 Gitea 向 GitLab 设置推送镜像
要从 Gitea 设置镜像到 GitLab，您需要按照以下步骤进行操作：
- 创建具有 write_repository 作用域的 GitLab 个人访问令牌。
- 填写Git 远程仓库 URL：
https://<destination host>/<your_gitlab_group_or_name>/<your_gitlab_project>.git。 - 在授权字段中填写
oauth2作为用户名，并将您的 GitLab 个人访问令牌作为密码。 - 选择添加推送镜像以保存配置。
仓库会很快进行推送。要强制推送，请选择立即同步按钮。
从 Gitea 向 Bitbucket 设置推送镜像
要从 Gitea 设置镜像到 Bitbucket，您需要按照以下步骤进行操作：
- 创建一个具有选中 Repository Write 选项的 Bitbucket 应用密码。
- 填写Git 远程仓库 URL：
https://bitbucket.org/<your_bitbucket_group_or_name>/<your_bitbucket_project>.git。 - 使用您的 Bitbucket 用户名填写授权字段，并将应用密码作为密码。
- 选择添加推送镜像以保存配置。
仓库会很快进行推送。要强制推送，请选择立即同步按钮。