AVÍS IMPORTANT: Actualització obligatòria abans del 30 de novembre de 2026

Introducció

Degut a la pròxima actualització d’OpenShift a la versió 4.20, s’ha introduït suport per a cgroup v2. Això implica que caldrà actualitzar Grafana i Prometheus a les versions mínimes compatibles amb cgroupv2:

• Prometheus: versió mínima 2.37.9
• Grafana: versió mínima 9.5.21

Per a tots aquells que hagin desplegat Grafana i Prometheus usant les instruccions disponibles en la documentació, poden realitzar-la basant-se en la següent guia. En qualsevol cas, abans de acomenter qualsevol actualització, és convenient revisar la documentción de Grafana i Prometheus disponible públicament en Internet per si tingués impacte en les personalitzacions i configuracions que s’hagin realitzat. A continuació s’indiquen els passos necessaris per actualitzar des de les versions 2.34.0 de Prometheus i 8.5.4 de Grafana.

Actualització de Prometheus (de 2.34.0 a 2.37.9)

Per actualitzar Prometheus caldrà modificar el fitxer aca.yaml i l’statefulset.

ACA.yaml

Actualitzar la versió de la imatge al fitxer aca.yaml:

version: 2.0.0
info:
  version: '2.37.9'
global-env:
  - CONTAINER_IMAGE_NAME: prometheus
  - CONTAINER_EXTERNAL_REGISTRY: 'docker.io/prom'
  - CONTAINER_IMAGE_TAG: 'v2.37.9'
  - DEPLOYMENT_TYPE: Statefulset

Statefulset

Actualitzar els arguments i la imatge al fitxer de l’statefulset. A partir de la versió 2.37.9, el paràmetre --storage.tsdb.min-block-duration és ignorat i es pot eliminar:

        args:
        - --storage.tsdb.retention.time=7d
        # - --storage.tsdb.min-block-duration=2h
        - --storage.tsdb.max-block-duration=2h
        - --config.file=/etc/prometheus/prometheus.yml
        - --web.enable-lifecycle
        image: docker.io/prom/prometheus:v2.37.9

Actualitzar també la imatge de l’oauth-proxy:

      - name: prom-proxy
        image: quay.io/openshift/origin-oauth-proxy:4.18
        imagePullPolicy: Always
        resources:
          requests:
            cpu: "10m"
            memory: "60Mi"
          limits:
            cpu: "10m"
            memory: "100Mi"

Actualització de Grafana (de 8.5.4 a 9.5.21)

Per actualitzar Grafana caldrà modificar el fitxer aca.yaml i l’statefulset.

ACA.yaml

Actualitzar la versió de la imatge al fitxer aca.yaml:

version: 2.0.0
info:
  version: '9.5.21'
global-env:
  - CONTAINER_IMAGE_NAME: grafana
  - CONTAINER_EXTERNAL_REGISTRY: 'docker.io/grafana'
  - CONTAINER_IMAGE_TAG: '9.5.21'
  - DEPLOYMENT_TYPE: Statefulset

L’actualització a la versió 9.5 requereix afegir variables d’entorn per referenciar el path de la base de dades i altres configuracions. Cal afegir-les al fitxer de l’statefulset.

Statefulset

Afegir les següents variables d’entorn al contenidor de Grafana:

        - name: GF_PATHS_HOME
          value: '/usr/share/grafana'
        - name: GF_PATHS_LOGS
          value: '/tmp/data/log'
        - name: GF_PATHS_PROVISIONING
          value: '/usr/share/grafana/provisioning'
        - name: GF_PATHS_PLUGINS
          value: '/tmp/data/plugins'
        - name: GF_PATHS_CONFIG
          value: '/usr/share/grafana/conf/defaults.ini'
        - name: GF_PATHS_DATA
          value: '/tmp/data'

Actualitzar també la imatge de l’oauth-proxy:

      - name: oauth-proxy
        image: quay.io/openshift/origin-oauth-proxy:4.18
        imagePullPolicy: Always
        resources:
          requests:
            cpu: "10m"
            memory: "60Mi"
          limits:
            cpu: "10m"
            memory: "100Mi"