From 0c61fad74c877ff797578a3cb969c6e613b8df00 Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Tue, 21 Jun 2016 19:28:08 +0200 Subject: [PATCH] Move to new location Due to https://gitlab.com/gitlab-org/gitlab-ce/issues/3349 --- doc/README.md | 2 +- .../project/settings}/img/export_1.png | Bin .../project/settings}/img/export_3.png | Bin .../project/settings}/img/export_4.png | Bin .../project/settings}/img/import_1.png | Bin .../project/settings}/img/import_2.png | Bin doc/user/project/settings/import_export.md | 65 ++++++++++++++++++ 7 files changed, 66 insertions(+), 1 deletion(-) rename doc/{workflow/import_export => user/project/settings}/img/export_1.png (100%) rename doc/{workflow/import_export => user/project/settings}/img/export_3.png (100%) rename doc/{workflow/import_export => user/project/settings}/img/export_4.png (100%) rename doc/{workflow/import_export => user/project/settings}/img/import_1.png (100%) rename doc/{workflow/import_export => user/project/settings}/img/import_2.png (100%) create mode 100644 doc/user/project/settings/import_export.md diff --git a/doc/README.md b/doc/README.md index f51069b2c30..495a99d5d9d 100644 --- a/doc/README.md +++ b/doc/README.md @@ -7,7 +7,7 @@ - [GitLab as OAuth2 authentication service provider](integration/oauth_provider.md). It allows you to login to other applications from GitLab. - [GitLab Basics](gitlab-basics/README.md) Find step by step how to start working on your commandline and on GitLab. - [Importing to GitLab](workflow/importing/README.md). -- [Importing and exporting projects between instances](workflow/import_export/README.md). +- [Importing and exporting projects between instances](user/project/settings/import_export.md). - [Markdown](markdown/markdown.md) GitLab's advanced formatting system. - [Migrating from SVN](workflow/importing/migrating_from_svn.md) Convert a SVN repository to Git and GitLab - [Permissions](permissions/permissions.md) Learn what each role in a project (external/guest/reporter/developer/master/owner) can do. diff --git a/doc/workflow/import_export/img/export_1.png b/doc/user/project/settings/img/export_1.png similarity index 100% rename from doc/workflow/import_export/img/export_1.png rename to doc/user/project/settings/img/export_1.png diff --git a/doc/workflow/import_export/img/export_3.png b/doc/user/project/settings/img/export_3.png similarity index 100% rename from doc/workflow/import_export/img/export_3.png rename to doc/user/project/settings/img/export_3.png diff --git a/doc/workflow/import_export/img/export_4.png b/doc/user/project/settings/img/export_4.png similarity index 100% rename from doc/workflow/import_export/img/export_4.png rename to doc/user/project/settings/img/export_4.png diff --git a/doc/workflow/import_export/img/import_1.png b/doc/user/project/settings/img/import_1.png similarity index 100% rename from doc/workflow/import_export/img/import_1.png rename to doc/user/project/settings/img/import_1.png diff --git a/doc/workflow/import_export/img/import_2.png b/doc/user/project/settings/img/import_2.png similarity index 100% rename from doc/workflow/import_export/img/import_2.png rename to doc/user/project/settings/img/import_2.png diff --git a/doc/user/project/settings/import_export.md b/doc/user/project/settings/import_export.md new file mode 100644 index 00000000000..618f9948e12 --- /dev/null +++ b/doc/user/project/settings/import_export.md @@ -0,0 +1,65 @@ +# Project import/export + +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 + +1. Go to the project settings page and find the Export button + + ![export_1](./img/export_1.png) + +1. Once the export is generated, you should receive an e-mail with a link to download the file + + ![export_3](./img/export_3.png) + +1. 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) + +## Importing the project + +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) + +1. After choosing a namespace or path, you can then select the file exported previously + + ![import_2](./img/import_2.png) + +1. Click on Import to begin importing and you will see your newly imported project page soon + + +## Advanced + +The GitLab Import/Export version can be checked by using: + +```bash +sudo gitlab-rake gitlab:import_export:version +``` + +The current list of DB tables that will get exported can be listed by using: + +```bash +sudo gitlab-rake gitlab:import_export:data +``` + +[ce-3050]: https://gitlab.com/gitlab-org/gitlab-ce/issues/3050