mirror of
https://github.com/jlengrand/gitlab-recipes.git
synced 2026-03-10 08:11:17 +00:00
Merge branch 'add/homedirChange' of /mnt/ebs/repositories/arifali1/gitlab-recipes
This commit is contained in:
243
misc/homedir/movedir.md
Normal file
243
misc/homedir/movedir.md
Normal file
@@ -0,0 +1,243 @@
|
||||
# Move home directory from /home/git to /var/lib/git
|
||||
|
||||
### 0. Stop services
|
||||
|
||||
```bash
|
||||
service gitlab stop
|
||||
service nginx stop
|
||||
```
|
||||
|
||||
### 1. Update passwd/group file
|
||||
|
||||
Update the `/etc/group` file, and change the gid of the group
|
||||
|
||||
```bash
|
||||
git:x:500:
|
||||
```
|
||||
or you can run the following command
|
||||
|
||||
```bash
|
||||
groupmod -g 500 git
|
||||
```
|
||||
|
||||
Amended the `/etc/passwd` file to change the uid, gid and the home directory for git
|
||||
|
||||
```bash
|
||||
git:x:500:500:GitLab,,,:/var/lib/git:/bin/bash
|
||||
```
|
||||
or you can run the following command
|
||||
|
||||
```bash
|
||||
usermod -d /var/lib/git -g 500 -u 500 git
|
||||
```
|
||||
|
||||
### 2. Move the git folder
|
||||
|
||||
```bash
|
||||
cp -r /home/git /var/lib/
|
||||
```
|
||||
|
||||
### 3. Change permissions to use the new uid/gid
|
||||
|
||||
```bash
|
||||
chown -R git:git /var/lib/git
|
||||
```
|
||||
|
||||
### 4. Update Gitlab config files
|
||||
update `~git/gitlab/config/gitlab.yml`, using the following command
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' ~git/gitlab/config/gitlab.yml
|
||||
```
|
||||
|
||||
You should see the following difference after running the command
|
||||
|
||||
```diff
|
||||
--- gitlab.yml.example 2013-12-20 16:27:14.784403409 -0500
|
||||
+++ gitlab.yml 2014-01-05 15:11:17.706013229 -0500
|
||||
@@ -165,7 +166,7 @@
|
||||
# GitLab Satellites
|
||||
satellites:
|
||||
# Relative paths are relative to Rails.root (default: tmp/repo_satellites/)
|
||||
- path: /home/git/gitlab-satellites/
|
||||
+ path: /var/lib/git/gitlab-satellites/
|
||||
|
||||
## Backup
|
||||
@@ -174,11 +175,11 @@
|
||||
|
||||
## GitLab Shell settings
|
||||
gitlab_shell:
|
||||
- path: /home/git/gitlab-shell/
|
||||
+ path: /var/lib/git/gitlab-shell/
|
||||
|
||||
# REPOS_PATH MUST NOT BE A SYMLINK!!!
|
||||
- repos_path: /home/git/repositories/
|
||||
- hooks_path: /home/git/gitlab-shell/hooks/
|
||||
+ repos_path: /var/lib/git/repositories/
|
||||
+ hooks_path: /var/lib/git/gitlab-shell/hooks/
|
||||
|
||||
# Git over HTTP
|
||||
upload_pack: true
|
||||
```
|
||||
Update `~git/gitlab/config/unicorb.rb`, using the following command
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' ~git/gitlab/config/unicorn.rb
|
||||
```
|
||||
|
||||
You should see the following difference after running the command
|
||||
|
||||
```diff
|
||||
--- unicorn.rb.example 2013-12-20 16:27:14.795402739 -0500
|
||||
+++ unicorn.rb 2014-01-07 07:47:33.786389865 -0500
|
||||
@@ -32,24 +32,24 @@
|
||||
|
||||
# Help ensure your application will always spawn in the symlinked
|
||||
# "current" directory that Capistrano sets up.
|
||||
-working_directory "/home/git/gitlab" # available in 0.94.0+
|
||||
+working_directory "/var/lib/git/gitlab" # available in 0.94.0+
|
||||
|
||||
# listen on both a Unix domain socket and a TCP port,
|
||||
# we use a shorter backlog for quicker failover when busy
|
||||
-listen "/home/git/gitlab/tmp/sockets/gitlab.socket", :backlog => 64
|
||||
+listen "/var/lib/git/gitlab/tmp/sockets/gitlab.socket", :backlog => 64
|
||||
listen "127.0.0.1:8080", :tcp_nopush => true
|
||||
|
||||
# nuke workers after 30 seconds instead of 60 seconds (the default)
|
||||
timeout 30
|
||||
|
||||
# feel free to point this anywhere accessible on the filesystem
|
||||
-pid "/home/git/gitlab/tmp/pids/unicorn.pid"
|
||||
+pid "/var/lib/git/gitlab/tmp/pids/unicorn.pid"
|
||||
|
||||
# By default, the Unicorn logger will write to stderr.
|
||||
# Additionally, some applications/frameworks log to stderr or stdout,
|
||||
# so prevent them from going to /dev/null when daemonized here:
|
||||
-stderr_path "/home/git/gitlab/log/unicorn.stderr.log"
|
||||
-stdout_path "/home/git/gitlab/log/unicorn.stdout.log"
|
||||
+stderr_path "/var/lib/git/gitlab/log/unicorn.stderr.log"
|
||||
+stdout_path "/var/lib/git/gitlab/log/unicorn.stdout.log"
|
||||
|
||||
# combine Ruby 2.0.0dev or REE with "preload_app true" for memory savings
|
||||
# http://rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
|
||||
```
|
||||
|
||||
### 5. Update Gitlab shell config file
|
||||
update `~git/gitlab-shell/config.yml`, using the following command
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' ~git/gitlab-shell/config.yml
|
||||
```
|
||||
|
||||
You should see the following difference after running the command
|
||||
|
||||
```diff
|
||||
--- config.yml.old 2014-01-07 09:00:41.522352570 -0500
|
||||
+++ config.yml 2014-01-05 15:12:59.695840545 -0500
|
||||
@@ -15,10 +15,10 @@
|
||||
# Give the canonicalized absolute pathname,
|
||||
# REPOS_PATH MUST NOT CONTAIN ANY SYMLINK!!!
|
||||
# Check twice that none of the components is a symlink, including "/home".
|
||||
-repos_path: "/home/git/repositories"
|
||||
+repos_path: "/var/lib/git/repositories"
|
||||
|
||||
# File used as authorized_keys for gitlab user
|
||||
-auth_file: "/home/git/.ssh/authorized_keys"
|
||||
+auth_file: "/var/lib/git/.ssh/authorized_keys"
|
||||
|
||||
# Redis settings used for pushing commit notices to gitlab
|
||||
redis:
|
||||
```
|
||||
|
||||
### 6. Update authorized_keys
|
||||
|
||||
Update the `/var/lib/git/.ssh/authorized_keys`, using the following command
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' ~git/.ssh/authorized_keys
|
||||
```
|
||||
|
||||
### 7. Update nginx config file
|
||||
|
||||
update `/etc/nginx/sites-enabled/gitlab`, using the following command
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' /etc/nginx/sites-enabled/gitlab
|
||||
```
|
||||
|
||||
### 8. Add/Update gitlab service and default files
|
||||
|
||||
We need to apply the following patch to `/etc/init.d/gitlab`, This has been submitted as a
|
||||
PR already to gitlabhq. This enables to read the default file, and initialises other variables.
|
||||
Without this diff, other variables then also need to be defined in `/etc/default/gitlab`
|
||||
|
||||
```diff
|
||||
--- gitlab 2013-12-20 16:27:14.919395198 -0500
|
||||
+++ /etc/init.d/gitlab 2014-01-06 08:51:18.253120785 -0500
|
||||
@@ -31,14 +31,15 @@
|
||||
# internal /bin/sh variables such as PATH, EDITOR or SHELL.
|
||||
app_user="git"
|
||||
app_root="/home/$app_user/gitlab"
|
||||
+
|
||||
+# Read configuration variable file if it is present
|
||||
+test -f /etc/default/gitlab && . /etc/default/gitlab
|
||||
+
|
||||
pid_path="$app_root/tmp/pids"
|
||||
socket_path="$app_root/tmp/sockets"
|
||||
web_server_pid_path="$pid_path/unicorn.pid"
|
||||
sidekiq_pid_path="$pid_path/sidekiq.pid"
|
||||
|
||||
-# Read configuration variable file if it is present
|
||||
-test -f /etc/default/gitlab && . /etc/default/gitlab
|
||||
-
|
||||
# Switch to the app_user if it is not he/she who is running the script.
|
||||
if [ "$USER" != "$app_user" ]; then
|
||||
sudo -u "$app_user" -H -i $0 "$@"; exit;
|
||||
```
|
||||
|
||||
If you haven't already, copy the service default file, then do so, and then update the file to point to the new home directory
|
||||
|
||||
```bash
|
||||
cp ~git/gitlab/lib/support/init.d/gitlab.default.example /etc/default/gitlab
|
||||
sed -i -e 's/\/home/\/var\/lib/g' /etc/default/gitlab
|
||||
```
|
||||
|
||||
### 9. Update gitlab-shell hooks
|
||||
|
||||
The file `~git/gitlab-shell/support/rewrite-hooks.sh`, has the home directory hardcoded, so we need to update this file as well
|
||||
|
||||
```bash
|
||||
sed -i -e 's/\/home/\/var\/lib/g' ~git/gitlab-shell/support/rewrite-hooks.sh
|
||||
```
|
||||
|
||||
Now we update all the hooks
|
||||
|
||||
```bash
|
||||
cd ~git
|
||||
sudo -u git -H gitlab-shell/support/rewrite-hooks.sh
|
||||
```
|
||||
|
||||
### 10. Restart application
|
||||
|
||||
```bash
|
||||
sudo service gitlab restart
|
||||
sudo service nginx restart
|
||||
```
|
||||
|
||||
### 11. Check application status
|
||||
|
||||
Check if GitLab and its environment are configured correctly:
|
||||
|
||||
cd ~git/gitlab
|
||||
sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production
|
||||
|
||||
To make sure you didn't miss anything run a more thorough check with:
|
||||
|
||||
cd ~git/gitlab
|
||||
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production
|
||||
|
||||
### 12. Remove old home
|
||||
|
||||
Once you are happy that everything is now working in the new directory, you can remove the old `/home/git`
|
||||
|
||||
rm -rf /home/git
|
||||
Reference in New Issue
Block a user