- Summary of major changes
- Problematic Helm 2.15
- Upgrade path from 3.x
- Upgrade from 3.3.x
- Major Changes
- Upgrade path from 2.x
- Upgrade path from 1.x
- Known issues and limitations
- Release cadence
- Kubernetes deployment support
- Technical support
Along with the
13.0 release of GitLab, we have bumped the chart version to
- The bundled PostgreSQL database is upgraded to 11.7
- Replaced Unicorn chart with Webservice chart
- Default webserver switched from Unicorn to Puma
Helm v2.15.x has a severe bug, and absolutely should not be used.
If you are to use Helm 2, use
In order to upgrade to the
4.0 version of the chart, you first need to upgrade to the latest
release of the chart. Check the version mapping details for the latest patch.
If you don’t first upgrade to the latest
3.3.x patch, you will see the following error from
Error: UPGRADE FAILED: Job failed: BackoffLimitExceeded
You can then confirm you are in this situation by looking for pods in error with the text
gitlab-upgrade-check in the name.
If you check the logs for those pods will see the version upgrade error message:
It seems you are upgrading the GitLab Helm Chart from X (GitLab X) to 4.0.0 (GitLab 13.0.0). It is required to upgrade to the latest 3.3.x version first before proceeding. Please follow the upgrade documentation at https://docs.gitlab.com/charts/releases/3_0.html and upgrade to GitLab Helm Chart version 3.3.x before upgrading to 4.0.0.
Please follow the upgrade steps for 4.0 release.
As part of the
4.0.0 release of this chart, we upgraded the bundled PostgreSQL chart
8.9.4. This updates the PostgreSQL version from
11.7. This is not a drop in replacement. Manual
steps need to be performed to upgrade the database.
The 4.0 upgrade steps includes the manual steps required during upgrade.
The Unicorn subchart has been renamed to Webservice. When upgrading, Helm will remove all the Kubernetes resources for Unicorn and create new ones under the Webservice name. The chart was renamed to reflect the fact that both Unicorn and Puma are supported webservers by this chart. More details can be found in the Merge Request introducing the change.
The Unicorn webserver will remain supported for now, and can be configured using:
gitlab: webservice: webServer: unicorn
For more details see the webServer options.
You first need to upgrade to the
3.3.x release of the charts, before upgrading to
4.0. Please follow the
3.0 upgrade documentation.
You first need to upgrade to the
2.6.x release of the charts, then to
3.3.x before upgrading to
3.0. Please follow
the 2.0 upgrade documentation.
Below is a list of the known issues and limitations, although it may not be exhaustive.
Helm Chart Issues/Limitations:
- No GitLab Pages support: https://gitlab.com/gitlab-org/charts/gitlab/-/issues/37
- Restoring backups taken from install types other than this GitLab chart require you to migrate the original instance to object storage first: https://gitlab.com/gitlab-org/charts/gitlab/-/issues/646
- Smartcard authentication
Features that are currently out of scope:
- Relative URL as the GitLab Endpoint: https://gitlab.com/gitlab-org/charts/gitlab/-/issues/406
We will be releasing a new version of the chart with each new GitLab patch.
More information on how we are versioning the chart can be found in the release documentation.
Along with the issues and merge requests in this repo, a changelog is available to more easily follow along with updates.
GitLab is tested against:
Other Kubernetes deployments should also work. In the event of a specific non-GKE deployment issue, please raise an issue.
This release has automated CI testing for Kubernetes version
We greatly appreciate the wider testing of the community, and encourage detailed issues to be reported so we can address them.