Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Tatuya Kamada
gitlab-ce
Commits
b2732f3a
Commit
b2732f3a
authored
Jun 21, 2016
by
Achilleas Pipinellis
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Refactor project import/export documentation
parent
0c61fad7
Changes
3
Show whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
66 additions
and
38 deletions
+66
-38
doc/administration/raketasks/project_import_export.md
doc/administration/raketasks/project_import_export.md
+28
-0
doc/user/project/settings/img/settings_edit_button.png
doc/user/project/settings/img/settings_edit_button.png
+0
-0
doc/user/project/settings/import_export.md
doc/user/project/settings/import_export.md
+38
-38
No files found.
doc/administration/raketasks/project_import_export.md
0 → 100644
View file @
b2732f3a
# 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
0 → 100644
View file @
b2732f3a
18.9 KB
doc/user/project/settings/import_export.md
View file @
b2732f3a
# Project import/export
# 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:**
>**Note:**
-
This feature was
[
introduced
][
ce-3050
]
in GitLab 8.9
-
This feature was
[
introduced
][
ce-3050
]
in GitLab 8.9
-
Importing will not be possible if the import instance version is lower
-
Importing will not be possible if the import instance version is lower
than that of the exporter.
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.
## Exported contents
## Exported contents
-
The following items will be exported:
The following items will be exported:
-
Project and wiki repositories
-
Project uploads
-
Project and wiki repositories
-
Project configuration including web hooks and services
-
Project uploads
-
Issues with comments, merge requests with diffs and comments, labels, milestones, snippets,
-
Project configuration including web hooks and services
-
Issues with comments, merge requests with diffs and comments, labels, milestones, snippets,
and other project entities
and other project entities
-
The following items will NOT be exported:
-
Build traces and artifacts
The following items will NOT be exported:
-
LFS objects
-
Build traces and artifacts
-
LFS objects
## Exporting a project and its data
## Exporting a project and its data
1.
Go to the project settings page and find the Export button
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)
![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)
![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
1.
Alternatively, you can come back to the project settings and download the
can be generated again
file from there, or generate a new export
![export_4](./img/export_4.png)
![export_4](./img/export_4.png)
## Importing the project
## 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)
![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)
![import_2](./img/import_2.png)
1.
Click on Import to begin importing and you will see your newly imported project page soon
1.
Click on
**Import project**
to begin importing. Your newly imported project
page will appear 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
[
ce-3050
]:
https://gitlab.com/gitlab-org/gitlab-ce/issues/3050
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment