Document all upgrade paths
Existing documentation
There are already a lot of guides written here and there.
- Update guides in the main website (needs refactoring): https://about.gitlab.com/update/
- Update to package repository (needs refactoring): https://about.gitlab.com/upgrade-to-package-repository/
- GitLab EE update guides as well as GitLab CE to EE guides: https://gitlab.com/gitlab-org/gitlab-ee/tree/master/doc/update
- GitLab CE update guides: https://gitlab.com/gitlab-org/gitlab-ce/tree/master/doc/update
- Omnibus GitLab update guides (this needs refactoring): https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/update/README.md
Possible update paths
There are quite a few paths we should take into account depending on how old an installation is.
Categories
- source to source
- source to omnibus
- source to docker
- omnibus to docker
- source CE to source CE
- source CE to omnibus CE
- source mysql to omnibus postgres
- source postgres to omnibus postgres
- source CE to source EE
- source CE to omnibus EE
- source CE to docker CE
- source EE to docker EE
- source CE to docker EE
For example:
- upgrade source installation to a version that omnibus is supported
- convert existing installation to omnibus
- if mysql convert to postgres
- upgrade to latest package and install the repository for further updates
Omnibus packages
Packages and distros found in archives https://about.gitlab.com/downloads/archives/
- 6.6.5 (Ubuntu 1204, CentOS 6)
- 6.7.5 (Ubuntu 1204, CentOS 6)
- 6.8.2 (Ubuntu 1204, CentOS 6, Debian 7)
- 6.9.2 (Ubuntu 1204, CentOS 6, Debian 7)
- 7.0.0 (Ubuntu 1204/1404, CentOS 6, Debian 7)
- 7.1.1 (Ubuntu 1204/1404, CentOS 6, Debian 7)
- 7.2.3 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.3.3 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.4.5 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.5.3 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.6.2 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.7.2 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.8.4 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.9.4 (Ubuntu 1204/1404, CentOS 6/7, Debian 7)
- 7.10.4 (Ubuntu 1204/1404, CentOS 6/7, Debian 7/8)
Links to update docs
Links to forum answers
- https://forum.gitlab.com/t/updating-gitlab-to-last-version/1140
- https://forum.gitlab.com/t/migrate-from-5-3-to-7-8/305
- https://forum.gitlab.com/t/migrate-7-6-2-to-last-omnibus/808
- https://forum.gitlab.com/t/im-on-gitlab-5-with-a-bunch-of-projects-how-do-i-update-and-avoid-catastrophe/1743 (good points in answers)
Links to issues
- https://gitlab.com/gitlab-org/gitlab-ce/issues/2904
- https://gitlab.com/gitlab-org/omnibus-gitlab/issues/932
- https://gitlab.com/gitlab-org/gitlab-ce/issues/2544
- https://gitlab.com/gitlab-org/gitlab-ce/issues/12510