GitLab Cloud Native Chart 9.0

Along with the 18.0 release of GitLab, we have bumped the chart version to 9.0.

Summary of major changes

  • The bundled Prometheus chart was updated from 15.3 to 27.1.
  • Along with the Prometheus chart upgrade, the Prometheus version was updated from 2.38 to 3.0.

Upgrade path from 8.x

Prometheus upgrade

You can skip this section if you’re not using the Prometheus subchart bundled with the GitLab chart.

The bundled Prometheus subchart was updated from 15.3 to 27.1, which now bundles Prometheus 3 instead of Prometheus 2.x. Please check the Prometheus 3 migration guide, if any of the features you use are impacted.

We are highlighting here some information we consider most critical, but for a fully comprehensive list of changes, please refer to the upstream Prometheus chart upgrade documentation.

  • The Prometheus chart updates several (selector) labels to align with Helm and Kubernetes labeling best practices. Before upgrading you need to delete the old workloads.

    kubectl delete deployment  -l app=prometheus,heritage=Helm,release=<release name>
    kubectl delete statefulset -l app=prometheus,heritage=Helm,release=<release name>
    kubectl delete daemonset   -l app=prometheus,heritage=Helm,release=<release name>
    

    If you have other services depending on the labels on the Prometheus resources, please update these accordingly.

  • If you enabled the bundled kube-state-metrics, alertmananger, node exporter or pushgateway, you need to update your values per the upstream upgrade changelogs:

  • The configmapReload.prometheus.extraArgs is not anymore compatible, as per upgrade to 20.0.