Kai Ole Hartwig
5 Min. Lesezeit
Niedrig
Von

Das strengere Label gewinnt

Eine Versionsnummer ist eine Behauptung des Herstellers. Meistens stimmt sie. Manchmal hebt ein Hersteller die Major-Version bei jedem Release, auch wenn sich kaum etwas ändert. Und manchmal ist ein Patch in Wahrheit ein Bruch.

pinup misst deshalb nach, wo es kann. Und es hat eine Meinung dazu, was dann gilt: Lockern darf die Messung nur, wenn man ihr ausdrücklich vertraut. Sonst gewinnt das strengere Label.

01 — Die Meinung in einem Satz

Ein Update trägt zwei Labels. Eine Analyse darf eine Entscheidung nur lockern, wenn die Regel ihr ausdrücklich vertraut. Sonst gilt das strengere, deklarierte Label.

Das deklarierte Label kommt aus den Versionsnummern: major, minor, patch und so weiter. Das effektive Label kommt aus einer Analyse dessen, was sich wirklich geändert hat. Es ist unknown, solange keine Regel die Analyse anfordert.

In der .pinup.yaml sieht das so aus:

 

packageRules:
  - matchDatasources: [docker]
    matchPackageNames: ["registry-1.docker.io/bitnamicharts/**"]
    versioning: semver
    analyze: true
  - matchDatasources: [docker]
    matchUpdateTypes: [major]
    matchEffective: [patch, minor]
    trustEffective: true
    automerge: true
    dependencyDashboardApproval: false

 

Ohne trustEffective bleibt ein solcher Automerge aus. Der Merge-Request nennt dann die Regel, die ihn eingeschaltet hat, und dass trustEffective fehlt.

02 — Die Alternative: Merge Confidence

Renovate löst eine ähnliche Frage mit Merge Confidence, einem Dienst von Mend. Er wertet aus, wie alt eine Version ist, wie viele Projekte sie schon nutzen und wie oft Updates darauf durchlaufen. Das ist für verbreitete öffentliche Pakete ein starkes Signal. Die Menge der Nutzer weiß oft mehr als jede Analyse.

Für meinen Bestand passte das nicht. Viele Abhängigkeiten sind interne Pakete oder Charts, zu denen es keine Menge gibt. Und ich wollte keine Entscheidung von einem externen Dienst abhängig machen, dessen Grundlage ich nicht selbst prüfen kann. pinup hat Merge Confidence deshalb bewusst nicht nachgebaut und misst stattdessen selbst.

03 — Der Preis

Eine Analyse lädt beide Versionen. Das kostet Zeit und Netzwerk. Deshalb ist sie standardmäßig aus und läuft nur für Abhängigkeiten, die eine Regel mit analyze markiert.

Es gibt erst einen Analyzer. Er liest Helm-Charts. Für alles andere bleibt das effektive Label unknown, und damit gilt das deklarierte.

Vertrauen muss man aussprechen. Eine Analyse allein lockert nichts. Das ist gewollt, bedeutet aber eine Regel mehr in der Konfiguration.

04 — Der Anlass

Der Anlass war ein Chart-Hersteller, der bei jedem Release die Major-Version hebt. Unter dem deklarierten Label ist jedes dieser Updates ein Major und wartet auf Freigabe. Die Anwendung darin und die Werte, die ich setze, sind oft dieselben.

Der Helm-Analyzer vergleicht appVersion, die Schlüssel in values.yaml, kubeVersion und die Abhängigkeiten beider Versionen. Gemessen am Redis-Chart von Bitnami, von 20.13.4 auf 28.1.0: Die Anwendung springt von 7.4.3 auf 8.10.1, und zwei Schlüssel fehlen in den Werten. Das ergibt breaking-values, das strengste Label. Kein Automerge.

In einem Test mit einer konstruierten 21.0.0, bei der Anwendung und Werte gleich bleiben, ergibt sich patch. Nur dieser Fall darf mit trustEffective automatisch durchgehen.

Was die Analyse nebenbei zeigt

Ein Chart bringt eigene Container-Images mit. Die stehen in keiner Datei des Repositories, also liest sie kein Manager. Der Analyzer nennt sie als Hinweis im Merge-Request, mit jeder Referenz, die sich zwischen den Versionen bewegt hat.

05 — Die Durchsetzung

Häufige Fragen

Kann das effektive Label ein Update auch strenger machen?+

Nein. Die Analyse kann eine Entscheidung nur lockern, und nur mit trustEffective. Meldet sie breaking-values für ein Minor, bleibt es bei dem, was die Regeln sagen. Der Befund steht als Evidenz im Merge-Request, und eine Regel kann mit matchEffective: [breaking-values] darauf reagieren.

Gibt es Analyzer für Container-Images oder npm-Pakete?+

Noch nicht. Der Helm-Analyzer ist der erste. Geplant sind ein Vergleich der gerenderten Manifeste mit den eigenen Werten und ein Analyzer für Images über OCI-Labels und Attestierungen. Ein Analyzer ist ein eigenes Paket hinter einer festen Schnittstelle.

Funktioniert das auch mit einer renovate.json?+

Ja. pinup liest die Regeln aus einer .pinup.yaml genauso wie aus einer renovate.json. analyze, matchEffective und trustEffective gibt es aber nur in pinup. Renovate kennt sie nicht.

Fazit

Eine Versionsnummer ist eine Behauptung, eine Analyse ist eine Messung. Eine Analyse allein darf kein Update durchwinken. Lockern darf sie nur, wo die Konfiguration ihr ausdrücklich vertraut. Sonst bleibt es beim strengeren Label.

Nächste Woche geht es um den Plan, der vor jeder Änderung entsteht. Die Übersicht aller Teile und die Begriffe, die öfter vorkommen, stehen im Auftakt der Serie.

Warten deine Charts auf Freigaben, die sie nicht brauchen? Ich messe nach.

Eine Analyse deiner Helm-Charts mit pinup: welche Major-Updates in Wahrheit Patches sind, welche Werte wegfallen und wo sich ein Automerge mit gutem Gewissen lohnt.

Termin buchen →

Über den Autor

Photo of Kai Ole Hartwig.

Kai Ole Hartwig

Freelance DevSecOps consultant · OnlyOle Consulting

Programming since 2002 – self-taught, set up my own business with KO-Web in 2012. Over 100 projects, with a focus on security, performance, automation and quality. Today freelance: DevSecOps consulting, training and software development.