gitlab-org--gitlab-foss/doc/update/8.17-to-9.0.md
Alejandro Rodríguez 0b9d56f960 Update storage settings to allow extra values per shard
This will be necessary when adding gitaly settings. This version
doesn't make any functional changes, but allows us to include this
breaking change in 9.0 and add the needed extra settings in the future
with backwards compatibility
2017-03-03 12:13:30 -03:00

2.4 KiB

Configuration changes for repository storages

This version introduces a new configuration structure for repository storages. Update your current configuration as follows, replacing with your storages names and paths:

For installations from source

  1. Update your gitlab.yml, from
repositories:
  storages: # You must have at least a 'default' storage path.
    default: /home/git/repositories
    nfs: /mnt/nfs/repositories
    cephfs: /mnt/cephfs/repositories

to

repositories:
  storages: # You must have at least a 'default' storage path.
    default:
      path: /home/git/repositories
    nfs:
      path: /mnt/nfs/repositories
    cephfs:
      path: /mnt/cephfs/repositories

For Omnibus installations

  1. Upate your /etc/gitlab/gitlab.rb, from
git_data_dirs({
  "default" => "/var/opt/gitlab/git-data",
  "nfs" => "/mnt/nfs/git-data",
  "cephfs" => "/mnt/cephfs/git-data"
})

to

git_data_dirs({
  "default" => { "path" => "/var/opt/gitlab/git-data" },
  "nfs" => { "path" => "/mnt/nfs/git-data" },
  "cephfs" => { "path" => "/mnt/cephfs/git-data" }
})

Git configuration

Configure Git to generate packfile bitmaps (introduced in Git 2.0) on the GitLab server during git gc.

cd /home/git/gitlab

sudo -u git -H git config --global repack.writeBitmaps true

Nginx configuration

Ensure you're still up-to-date with the latest NGINX configuration changes:

cd /home/git/gitlab

# For HTTPS configurations
git diff origin/8-17-stable:lib/support/nginx/gitlab-ssl origin/9-0-stable:lib/support/nginx/gitlab-ssl

# For HTTP configurations
git diff origin/8-17-stable:lib/support/nginx/gitlab origin/9-0-stable:lib/support/nginx/gitlab

If you are using Strict-Transport-Security in your installation to continue using it you must enable it in your Nginx configuration as GitLab application no longer handles setting it.

If you are using Apache instead of NGINX please see the updated Apache templates. Also note that because Apache does not support upstreams behind Unix sockets you will need to let gitlab-workhorse listen on a TCP port. You can do this via /etc/default/gitlab.