Commit b2732f3a authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Refactor project import/export documentation

parent 0c61fad7
# Project import/export
>**Note:**
- This feature was [introduced][ce-3050] in GitLab 8.9
- Importing will not be possible if the import instance version is lower
than that of the exporter.
The GitLab Import/Export version can be checked by using:
```bash
# Omnibus installations
sudo gitlab-rake gitlab:import_export:version
# Installations from source
bundle exec rake gitlab:import_export:version RAILS_ENV=production
```
The current list of DB tables that will get exported can be listed by using:
```bash
# Omnibus installations
sudo gitlab-rake gitlab:import_export:data
# Installations from source
bundle exec rake gitlab:import_export:data RAILS_ENV=production
```
[ce-3050]: https://gitlab.com/gitlab-org/gitlab-ce/issues/3050
doc/user/project/settings/img/settings_edit_button.png

18.9 KB

# Project import/export
>**Note:**
- This feature was [introduced][ce-3050] in GitLab 8.9
- Importing will not be possible if the import instance version is lower
than that of the exporter.
- You can find some useful raketasks if you are an administrator in the
[project_import_export](../../../administration/raketasks/project_import_export.md)
raketask.
Existing projects running on any GitLab instance or GitLab.com can be exported
with all their related data and be moved into a new GitLab instance.
>**Note:**
- This feature was [introduced][ce-3050] in GitLab 8.9
- Importing will not be possible if the import instance version is lower
than that of the exporter.
## Exported contents
- The following items will be exported:
- Project and wiki repositories
- Project uploads
- Project configuration including web hooks and services
- Issues with comments, merge requests with diffs and comments, labels, milestones, snippets,
and other project entities
- The following items will NOT be exported:
- Build traces and artifacts
- LFS objects
## Exporting a project and its data
The following items will be exported:
1. Go to the project settings page and find the Export button
- Project and wiki repositories
- Project uploads
- Project configuration including web hooks and services
- Issues with comments, merge requests with diffs and comments, labels, milestones, snippets,
and other project entities
![export_1](./img/export_1.png)
The following items will NOT be exported:
1. Once the export is generated, you should receive an e-mail with a link to download the file
- Build traces and artifacts
- LFS objects
![export_3](./img/export_3.png)
## Exporting a project and its data
1. You can come back to project settings and download the file from there, or delete it so it
can be generated again
1. Go to the project settings page by clicking on **Edit Project**
![export_4](./img/export_4.png)
![Project settings button](img/settings_edit_button.png)
## Importing the project
1. Scroll down to find the **Export project** button
1. The new GitLab project import feature is at the far right of the import options on New Project
![export_1](./img/export_1.png)
![import_1](./img/import_1.png)
1. Once the export is generated, you should receive an e-mail with a link to
download the file
1. After choosing a namespace or path, you can then select the file exported previously
![export_3](./img/export_3.png)
![import_2](./img/import_2.png)
1. Alternatively, you can come back to the project settings and download the
file from there, or generate a new export
1. Click on Import to begin importing and you will see your newly imported project page soon
![export_4](./img/export_4.png)
## Importing the project
## Advanced
1. The new GitLab project import feature is at the far right of the import
options when creating a New Project. Make sure you are in the right namespace
and you have entered a project name. Click on **GitLab export**
The GitLab Import/Export version can be checked by using:
![import_1](./img/import_1.png)
```bash
sudo gitlab-rake gitlab:import_export:version
```
1. You can see where the project will be imported to. You can now select file
exported previously
The current list of DB tables that will get exported can be listed by using:
![import_2](./img/import_2.png)
```bash
sudo gitlab-rake gitlab:import_export:data
```
1. Click on **Import project** to begin importing. Your newly imported project
page will appear soon
[ce-3050]: https://gitlab.com/gitlab-org/gitlab-ce/issues/3050
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