summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSytse Sijbrandij <sytse@gitlab.com>2014-10-30 22:51:41 +0000
committerSytse Sijbrandij <sytse@gitlab.com>2014-10-30 22:51:41 +0000
commit5a699090cde818294fca93d2793dd6195c0a7c2d (patch)
tree1bb81a8edd06e84bea64e3e84974de11401cfe68 /doc
parenta1dda564b19ed268a8019a9ac814933ac309a92b (diff)
parent2022754d933176877e9cff1159512e63e9fff2d8 (diff)
downloadgitlab-ce-5a699090cde818294fca93d2793dd6195c0a7c2d.tar.gz
Merge branch 'improve_rake_import_doc' into 'master'
Improve import Documentation Improved the documentation steps for importing bare git repositories to GitLab. @dzaporozhets I added a step to create gitlab-satellites. Is this step really necessary, or do the satellites get created as needed? See merge request !1234
Diffstat (limited to 'doc')
-rw-r--r--doc/raketasks/import.md48
1 files changed, 33 insertions, 15 deletions
diff --git a/doc/raketasks/import.md b/doc/raketasks/import.md
index 5dba8de6d56..153a2e2575b 100644
--- a/doc/raketasks/import.md
+++ b/doc/raketasks/import.md
@@ -1,28 +1,46 @@
-# Import
+# Import bare repositories into your GitLab instance
-## Import bare repositories into GitLab project instance
+### Notes:
-Notes:
+- The owner of the project will be the first admin
+- The groups will be created as needed
+- The owner of the group will be the first admin
+- Existing projects will be skipped
-- project owner will be a first admin
-- groups will be created as needed
-- group owner will be the first admin
-- existing projects will be skipped
+## How to use:
-How to use:
+### Create a new folder inside the git repositories path. This will be the name of the new group.
-1. copy your bare repos under git repos_path (see `config/gitlab.yml` gitlab_shell -> repos_path)
-1. run the command below
+- For omnibus-gitlab, it is located at: `/var/opt/gitlab/git-data/repositories` by default, unless you changed
+it in the `/etc/gitlab/gitlab.rb` file.
+- For manual installations, it is usually located at: `/home/git/repositories` or you can see where
+your repositories are located by looking at `config/gitlab.yml` under the `gitlab_shell => repos_path` entry.
+
+### Copy your bare repositories inside this newly created folder:
+
+```
+$ cp -r /old/git/foo.git/ /home/git/repositories/new_group/
```
-# omnibus-gitlab
-sudo gitlab-rake gitlab:import:repos
-# installation from source or cookbook
-bundle exec rake gitlab:import:repos RAILS_ENV=production
+### Run the command below depending on your type of installation:
+
+#### Omnibus Installation
+
+```
+$ sudo gitlab-rake gitlab:import:repos
+```
+
+#### Manual Installation
+
+Before running this command you need to change the directory to where your GitLab installation is located:
+
+```
+$ cd /home/git/gitlab
+$ sudo -u git -H bundle exec rake gitlab:import:repos RAILS_ENV=production
```
-Example output:
+#### Example output:
```
Processing abcd.git