2020-10-23 10:59:45 -05:00
|
|
|
---
|
|
|
|
date: "2019-04-15T17:29:00+08:00"
|
|
|
|
title: "Migrations Interfaces"
|
|
|
|
slug: "migrations-interfaces"
|
2023-04-04 08:47:31 -05:00
|
|
|
weight: 55
|
2020-12-09 01:47:06 -05:00
|
|
|
toc: false
|
2020-10-23 10:59:45 -05:00
|
|
|
draft: false
|
|
|
|
menu:
|
|
|
|
sidebar:
|
2023-03-23 10:18:24 -05:00
|
|
|
parent: "development"
|
2020-10-23 10:59:45 -05:00
|
|
|
name: "Migrations Interfaces"
|
|
|
|
weight: 55
|
|
|
|
identifier: "migrations-interfaces"
|
|
|
|
---
|
|
|
|
|
|
|
|
# Migration Features
|
|
|
|
|
|
|
|
Complete migrations were introduced in Gitea 1.9.0. It defines two interfaces to support migrating
|
2022-07-27 20:22:47 -05:00
|
|
|
repository data from other Git host platforms to Gitea or, in the future, migrating Gitea data to other Git host platforms.
|
|
|
|
|
2021-12-23 22:56:57 -05:00
|
|
|
Currently, migrations from GitHub, GitLab, and other Gitea instances are implemented.
|
2020-10-23 10:59:45 -05:00
|
|
|
|
2022-07-27 20:22:47 -05:00
|
|
|
First of all, Gitea defines some standard objects in packages [modules/migration](https://github.com/go-gitea/gitea/tree/main/modules/migration).
|
2020-10-23 10:59:45 -05:00
|
|
|
They are `Repository`, `Milestone`, `Release`, `ReleaseAsset`, `Label`, `Issue`, `Comment`, `PullRequest`, `Reaction`, `Review`, `ReviewComment`.
|
|
|
|
|
|
|
|
## Downloader Interfaces
|
|
|
|
|
2021-12-23 22:56:57 -05:00
|
|
|
To migrate from a new Git host platform, there are two steps to be updated.
|
2020-10-23 10:59:45 -05:00
|
|
|
|
|
|
|
- You should implement a `Downloader` which will be used to get repository information.
|
|
|
|
- You should implement a `DownloaderFactory` which will be used to detect if the URL matches and create the above `Downloader`.
|
2022-07-27 20:22:47 -05:00
|
|
|
- You'll need to register the `DownloaderFactory` via `RegisterDownloaderFactory` on `init()`.
|
2020-10-23 10:59:45 -05:00
|
|
|
|
2021-11-17 02:17:37 -05:00
|
|
|
You can find these interfaces in [downloader.go](https://github.com/go-gitea/gitea/blob/main/modules/migration/downloader.go).
|
2020-10-23 10:59:45 -05:00
|
|
|
|
|
|
|
## Uploader Interface
|
|
|
|
|
|
|
|
Currently, only a `GiteaLocalUploader` is implemented, so we only save downloaded
|
|
|
|
data via this `Uploader` to the local Gitea instance. Other uploaders are not supported at this time.
|
|
|
|
|
2021-11-17 02:17:37 -05:00
|
|
|
You can find these interfaces in [uploader.go](https://github.com/go-gitea/gitea/blob/main/modules/migration/uploader.go).
|