Fehlendes Tag in der Registry: auf den Tarball verweisen

Die Diagnose auf dem Zielsystem zeigte: enterprise/check-mk-enterprise
fuehrt im Zweig 2.4.0 nur p31 aufwaerts, dazu -latest und die taeglichen
Bauten. 2.4.0p9 ist dort herausgerollt - die Registry haelt nur die
juengsten Patchstaende vor.

Nachgemessen, dass das Downloadportal die Version weiterhin hat:
    .../2.4.0p9/check-mk-enterprise-docker-2.4.0p9.tar.gz   HTTP 401
also vorhanden, nur geschuetzt. Auch das oeffentliche Versionsarchiv
listet sie mit genau diesem Dateinamen.

Das ist kein Randfall, sondern der Normalfall bei einer Migration:
"omd restore" verlangt exakt die Version der Quell-Site, und die ist in
aller Regel aelter als das, was die Registry noch vorhaelt.

image_diagnose_ref sieht deshalb bei einem fehlenden Tag im Archiv nach
und nennt, wenn die Version dort liegt, den Tarball-Weg samt fertigem
Kommando - statt den Benutzer zwischen Registry und Portal suchen zu
lassen. Mit dem Unterschied zwischen beiden Quellen ist das jetzt auch
in beiden Sprachfassungen erklaert.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-20 18:49:27 +02:00
co-authored by Claude Opus 5
parent 43557e9753
commit 7a74042394
3 changed files with 56 additions and 3 deletions
+13
View File
@@ -801,6 +801,19 @@ Up to three sources are queried:
| registry (Docker Hub or registry.checkmk.com) | `registry` | only for Enterprise |
| download portal (directory listing) | `download` | yes |
> **The registry and the download portal do not carry the same thing.** The
> registry usually keeps only the **most recent** patch levels – for `2.4.0`
> roughly `p31` upwards, plus `2.4.0-latest` and the daily builds. Older levels
> have rolled out of it. The download portal, by contrast, is an **archive** and
> still has them.
>
> This matters precisely when a **specific** version is required – during a
> migration, because `omd restore` demands exactly the version of the source
> site ([chapter 17.4](#174-step-3--bring-the-target-system-to-the-right-version)).
> For those cases the tarball is the right route, not the registry. `image why`
> points this out by itself when a tag is missing from the registry but the
> version exists in the archive.
Without `--source` all three are tried – so even without stored credentials you
get a usable list: