diff options
-rw-r--r-- | doc/administration/img/export_1.png | bin | 0 -> 84637 bytes | |||
-rw-r--r-- | doc/administration/img/export_2.png | bin | 0 -> 13023 bytes | |||
-rw-r--r-- | doc/administration/img/export_3.png | bin | 0 -> 44012 bytes | |||
-rw-r--r-- | doc/administration/img/export_4.png | bin | 0 -> 86500 bytes | |||
-rw-r--r-- | doc/administration/img/import_1.png | bin | 0 -> 43574 bytes | |||
-rw-r--r-- | doc/administration/img/import_2.png | bin | 0 -> 46292 bytes | |||
-rw-r--r-- | doc/administration/import_export.md | 50 |
7 files changed, 50 insertions, 0 deletions
diff --git a/doc/administration/img/export_1.png b/doc/administration/img/export_1.png Binary files differnew file mode 100644 index 00000000000..1f7bdd21b0d --- /dev/null +++ b/doc/administration/img/export_1.png diff --git a/doc/administration/img/export_2.png b/doc/administration/img/export_2.png Binary files differnew file mode 100644 index 00000000000..ac866d7063d --- /dev/null +++ b/doc/administration/img/export_2.png diff --git a/doc/administration/img/export_3.png b/doc/administration/img/export_3.png Binary files differnew file mode 100644 index 00000000000..c123f83eb8e --- /dev/null +++ b/doc/administration/img/export_3.png diff --git a/doc/administration/img/export_4.png b/doc/administration/img/export_4.png Binary files differnew file mode 100644 index 00000000000..36568729abd --- /dev/null +++ b/doc/administration/img/export_4.png diff --git a/doc/administration/img/import_1.png b/doc/administration/img/import_1.png Binary files differnew file mode 100644 index 00000000000..b3a7f201018 --- /dev/null +++ b/doc/administration/img/import_1.png diff --git a/doc/administration/img/import_2.png b/doc/administration/img/import_2.png Binary files differnew file mode 100644 index 00000000000..f31832af3e1 --- /dev/null +++ b/doc/administration/img/import_2.png diff --git a/doc/administration/import_export.md b/doc/administration/import_export.md new file mode 100644 index 00000000000..b8ec12bbd05 --- /dev/null +++ b/doc/administration/import_export.md @@ -0,0 +1,50 @@ +# Project import/export + +Existing projects running on any GitLab instance or GitLab.com can be exported +with all its related data and moved into a new GitLab instance. + +## Requirements + +- You will need at least GitLab version 8.9 running on both instances +- Importing may not be possible if the import instance version is lower + than 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 + +1. Go to the project settings page and find the Export button. + + ![export_1](./img/export_1.png) + +2. Once the export is generated, you should receive an e-mail with a link to download the file. + + ![export_3](./img/export_3.png) + +3. You can come back to project settings and download the file from there, or delete it so it +can be generated again. + + ![export_4](./img/export_4.png) + +## Import + +1. The new GitLab project import feature is at the far right of the import options on New Project. + + ![import_1](./img/import_1.png) + +2. After choosing a namespace or path, you can then select the file prevoiusly exported. + + ![import_2](./img/import_2.png) + + +3. Click on Import and the import now begins and you will see your newly imported project page soon. |