From b2732f3af104fe31aed126505a5b7e4fa1a62f71 Mon Sep 17 00:00:00 2001 From: Achilleas Pipinellis Date: Tue, 21 Jun 2016 20:07:52 +0200 Subject: [PATCH] Refactor project import/export documentation --- .../raketasks/project_import_export.md | 28 +++++++ .../settings/img/settings_edit_button.png | Bin 0 -> 19392 bytes doc/user/project/settings/import_export.md | 76 +++++++++--------- 3 files changed, 66 insertions(+), 38 deletions(-) create mode 100644 doc/administration/raketasks/project_import_export.md create mode 100644 doc/user/project/settings/img/settings_edit_button.png diff --git a/doc/administration/raketasks/project_import_export.md b/doc/administration/raketasks/project_import_export.md new file mode 100644 index 00000000000..e5cb0308cbb --- /dev/null +++ b/doc/administration/raketasks/project_import_export.md @@ -0,0 +1,28 @@ +# 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 diff --git a/doc/user/project/settings/img/settings_edit_button.png b/doc/user/project/settings/img/settings_edit_button.png new file mode 100644 index 0000000000000000000000000000000000000000..3c0cee536de250ac9db41b895c39b6a94ca20c68 GIT binary patch literal 19392 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:** + - 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 + +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 by clicking on **Edit Project** + + ![Project settings button](img/settings_edit_button.png) + +1. Scroll down to find the **Export project** 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 +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 +1. Alternatively, you can come back to the project settings and download the + file from there, or generate a new export ![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 +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** ![import_1](./img/import_1.png) -1. After choosing a namespace or path, you can then select the file exported previously +1. You can see where the project will be imported to. You can now select 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 -``` +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