Commit 98ea660b authored by Nick Gaskill's avatar Nick Gaskill

Merge branch 'docs-update-gitea-import' into 'master'

Style updates to Gitea import page

See merge request gitlab-org/gitlab!71418
parents 7e2be326 68ac54b9
--- ---
type: reference, howto
stage: Manage stage: Manage
group: Import group: Import
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
...@@ -10,30 +9,30 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -10,30 +9,30 @@ info: To determine the technical writer assigned to the Stage/Group associated w
Import your projects from Gitea to GitLab with minimal effort. Import your projects from Gitea to GitLab with minimal effort.
NOTE: NOTE:
This requires Gitea `v1.0.0` or newer. This requires Gitea `v1.0.0` or later.
The Gitea importer can import: The Gitea importer can import:
- Repository description (GitLab 8.15+) - Repository description
- Git repository data (GitLab 8.15+) - Git repository data
- Issues (GitLab 8.15+) - Issues
- Pull requests (GitLab 8.15+) - Pull requests
- Milestones (GitLab 8.15+) - Milestones
- Labels (GitLab 8.15+) - Labels
When importing, repository public access is retained. If a repository is private in Gitea, it's When importing, repository public access is retained. If a repository is private in Gitea, it's
created as private in GitLab as well. created as private in GitLab as well.
## How it works ## How it works
Since Gitea is currently not an OAuth provider, author/assignee cannot be mapped Because Gitea isn't an OAuth provider, author/assignee can't be mapped to users
to users in your GitLab instance. This means that the project creator (most of in your GitLab instance. This means the project creator (usually the user that
the times the current user that started the import process) is set as the author, started the import process) is set as the author. A reference, however, is kept
but a reference on the issue about the original Gitea author is kept. on the issue about the original Gitea author.
The importer creates any new namespaces (groups) if they don't exist or in The importer creates any new namespaces (groups) if they don't exist. If the
the case the namespace is taken, the repository is imported under the user's namespace is taken, the repository is imported under the user's namespace
namespace that started the import process. that started the import process.
## Import your Gitea repositories ## Import your Gitea repositories
...@@ -41,7 +40,7 @@ The importer page is visible when you create a new project. ...@@ -41,7 +40,7 @@ The importer page is visible when you create a new project.
![New project page on GitLab](img/import_projects_from_new_project_page.png) ![New project page on GitLab](img/import_projects_from_new_project_page.png)
Click the **Gitea** link and the import authorization process starts. Select the **Gitea** link to start the import authorization process.
![New Gitea project import](img/import_projects_from_gitea_new_import.png) ![New Gitea project import](img/import_projects_from_gitea_new_import.png)
...@@ -52,13 +51,13 @@ GitLab access your repositories: ...@@ -52,13 +51,13 @@ GitLab access your repositories:
1. Go to `https://your-gitea-instance/user/settings/applications` (replace 1. Go to `https://your-gitea-instance/user/settings/applications` (replace
`your-gitea-instance` with the host of your Gitea instance). `your-gitea-instance` with the host of your Gitea instance).
1. Click **Generate New Token**. 1. Select **Generate New Token**.
1. Enter a token description. 1. Enter a token description.
1. Click **Generate Token**. 1. Select **Generate Token**.
1. Copy the token hash. 1. Copy the token hash.
1. Go back to GitLab and provide the token to the Gitea importer. 1. Go back to GitLab and provide the token to the Gitea importer.
1. Hit the **List Your Gitea Repositories** button and wait while GitLab reads 1. Select **List Your Gitea Repositories** and wait while GitLab reads
your repositories' information. Once done, you are taken to the importer your repositories' information. After it's done, GitLab displays the importer
page to select the repositories to import. page to select the repositories to import.
### Select which repositories to import ### Select which repositories to import
...@@ -66,19 +65,19 @@ GitLab access your repositories: ...@@ -66,19 +65,19 @@ GitLab access your repositories:
After you've authorized access to your Gitea repositories, you are After you've authorized access to your Gitea repositories, you are
redirected to the Gitea importer page. redirected to the Gitea importer page.
From there, you can see the import statuses of your Gitea repositories. From there, you can view the import statuses of your Gitea repositories:
- Those that are being imported show a _started_ status, - Those that are being imported show a _started_ status.
- those already successfully imported are green with a _done_ status, - Those already successfully imported are green with a _done_ status.
- whereas those that are not yet imported have an **Import** button on the - Those that aren't yet imported have an **Import** button on the
right side of the table. right side of the table.
You also can: You also can:
- Import all your Gitea projects in one go by hitting **Import all projects** in - Import all of your Gitea projects in one go by selecting **Import all projects**
the upper left corner. in the upper left corner.
- Filter projects by name. If filter is applied, hitting **Import all projects** - Filter projects by name. If filter is applied, selecting **Import all projects**
only imports matched projects. imports only matched projects.
![Gitea importer page](img/import_projects_from_gitea_importer_v12_3.png) ![Gitea importer page](img/import_projects_from_gitea_importer_v12_3.png)
......
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