Versionen auflisten, echtes Dateinamensschema, Editionsnamen entwirrt
Anlass war der Hinweis auf die tatsaechliche Download-URL. Am echten
Server nachgemessen:
check-mk-raw-docker-2.3.0p9.tar.gz -> 200 (frei)
check-mk-enterprise-docker-2.3.0p9.tar.gz -> 401 (geschuetzt)
check-mk-pro-docker-2.3.0p9.tar.gz -> 404
check-mk-raw-2.3.0p9.docker.tar.gz -> 404
Das bisher zuerst probierte Schema war also schlicht falsch.
Editionsnamen: checkmk.com zeigt nur noch Community/Pro/Ultimate/
Ultimate MT, Dateien und Repositories tragen bis 2.4 weiter
raw/enterprise/cloud/managed. Wer von "Pro" auf check-mk-pro-... schliesst,
bekommt 404. Die Editionsauswahl in der Oberflaeche nennt jetzt beide
Namen, die README hat eine Zuordnungstabelle, und intern werden beide
Varianten durchprobiert.
Neu: "image versions" listet verfuegbare Versionen aus bis zu drei
Quellen - Versionsarchiv von checkmk.com (oeffentlich, ohne
Zugangsdaten), Registry ueber /v2/<repo>/tags/list und das
Verzeichnis-Listing des Downloadportals. Mit --filter, --limit, --all,
--source und --bare fuer die nackte Liste zum Weiterverarbeiten. Am
Ende stehen die fertigen Kommandos zum Uebernehmen.
Das Archiv liefert ausserdem den EXAKTEN Dateinamen je Version und
Edition (data-versions im HTML). Der wird jetzt als erster Kandidat
verwendet, statt ihn zu raten - geprueft fuer raw, enterprise, cloud
und managed auf 2.3.0p9, der erste Kandidat fuer raw liefert am Server
HTTP 200.
In der Oberflaeche: neuer Punkt "Verfuegbare Versionen auflisten", und
beim Holen eines Images muss die Version nicht mehr abgetippt werden -
es erscheint eine Auswahlliste aus dem Archiv.
Gegen Docker Hub verifiziert: 2393 Tags korrekt eingelesen, Filter und
Sortierung stimmen.
Dokumentiert als Abschnitt 8.5 in beiden Sprachfassungen.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
+78
-5
@@ -608,12 +608,32 @@ Hub.** The `checkmk` namespace on Docker Hub contains only:
|
||||
| **`enterprise` (2.0 – 2.4)** | **`registry.checkmk.com/enterprise/check-mk-enterprise`** or an image tarball from the customer portal | **yes** |
|
||||
| `free` (historic, up to 2.1) | `docker.io/checkmk/check-mk-free` | no |
|
||||
|
||||
With Checkmk 2.5 the editions were renamed (Raw → Community,
|
||||
Enterprise → Pro, Managed → Ultimate MT); those images are publicly available
|
||||
With Checkmk 2.5 the editions were renamed; those images are publicly available
|
||||
on Docker Hub again. So if you run **2.5 or newer**, simply use `pro`. For
|
||||
**2.2/2.3/2.4 Enterprise** the only routes are `registry.checkmk.com` or the
|
||||
tarball.
|
||||
|
||||
#### Beware of the names
|
||||
|
||||
The rename is the second big pitfall. **checkmk.com only shows the new names,
|
||||
while files and repositories keep the old ones up to 2.4.** For 2.3.0p9
|
||||
specifically – verified against the version archive:
|
||||
|
||||
| Choice on checkmk.com | `--edition` here | actual file name |
|
||||
|---|---|---|
|
||||
| Community | `raw` | `check-mk-raw-docker-2.3.0p9.tar.gz` |
|
||||
| **Pro** | **`enterprise`** | **`check-mk-enterprise-docker-2.3.0p9.tar.gz`** |
|
||||
| Ultimate | `cloud` | `check-mk-cloud-docker-2.3.0p9.tar.gz` |
|
||||
| Ultimate MT | `managed` | `check-mk-managed-docker-2.3.0p9.tar.gz` |
|
||||
|
||||
Picking "Pro" on the website and deriving
|
||||
`check-mk-pro-docker-2.3.0p9.tar.gz` from it yields an **HTTP 404** – that file
|
||||
does not exist for 2.3.
|
||||
|
||||
The script takes care of this: it reads the real file name from the version
|
||||
archive and additionally tries both naming variants. In the interface the
|
||||
edition list shows both names.
|
||||
|
||||
> Freely downloadable does not mean licence-free – the licence key is entered
|
||||
> inside Checkmk afterwards.
|
||||
|
||||
@@ -758,10 +778,63 @@ In the ncurses interface the test can be reached from two places:
|
||||
After changing a credential field the menu also offers to run the test
|
||||
straight away.
|
||||
|
||||
### 8.5 Fetching the image – three ways
|
||||
### 8.5 Listing the available versions
|
||||
|
||||
Instead of guessing version numbers:
|
||||
|
||||
```bash
|
||||
./scripts/cmk-manage.sh image versions --edition enterprise --filter 2.3.0p
|
||||
```
|
||||
|
||||
Up to three sources are queried:
|
||||
|
||||
| Source | `--source` | Credentials |
|
||||
|---|---|---|
|
||||
| version archive on checkmk.com | `web` | **no** |
|
||||
| registry (Docker Hub or registry.checkmk.com) | `registry` | only for Enterprise |
|
||||
| download portal (directory listing) | `download` | yes |
|
||||
|
||||
Without `--source` all three are tried – so even without stored credentials you
|
||||
get a usable list:
|
||||
|
||||
```
|
||||
Versionsarchiv https://checkmk.com/download/archive
|
||||
(oeffentlich, keine Zugangsdaten noetig)
|
||||
2.3.0p50
|
||||
2.3.0p49
|
||||
2.3.0p48
|
||||
...
|
||||
|
||||
Uebernehmen
|
||||
aus der Registry : ./scripts/cmk-manage.sh image pull --edition enterprise --version <version>
|
||||
als Tarball : ./scripts/cmk-manage.sh image download --edition enterprise --version <version>
|
||||
nur eintragen : ./scripts/cmk-manage.sh config set CMK_VERSION <version>
|
||||
```
|
||||
|
||||
Further options: `--limit N` (default 25), `--all`, `--filter TEXT` and
|
||||
`--bare` for the plain list without any framing – handy for scripting:
|
||||
|
||||
```bash
|
||||
./scripts/cmk-manage.sh image versions --source web --filter 2.3.0p --bare | head -1
|
||||
```
|
||||
|
||||
In the interface there is **image → "Verfügbare Versionen auflisten"**; and
|
||||
when fetching an image the version no longer has to be typed at all – a
|
||||
selection list appears instead.
|
||||
|
||||
### 8.6 Fetching the image – three ways
|
||||
|
||||
**a) From a registry (recommended)**
|
||||
|
||||
For the Enterprise edition this is exactly the following two steps – the script
|
||||
performs them in one call and writes the result into `.env`:
|
||||
|
||||
```bash
|
||||
podman login registry.checkmk.com # or docker login
|
||||
podman pull registry.checkmk.com/enterprise/check-mk-enterprise:2.3.0p9
|
||||
```
|
||||
|
||||
|
||||
```bash
|
||||
# freely available, no login
|
||||
sudo ./scripts/cmk-manage.sh image pull --edition raw --version 2.3.0-latest
|
||||
@@ -809,7 +882,7 @@ typically `localhost/checkmk/check-mk-enterprise:2.3.0p23`) and writes it to
|
||||
sudo ./scripts/cmk-manage.sh up
|
||||
```
|
||||
|
||||
### 8.6 Checking what is in effect
|
||||
### 8.7 Checking what is in effect
|
||||
|
||||
```bash
|
||||
./scripts/cmk-manage.sh image status # configured image + local images
|
||||
@@ -1378,7 +1451,7 @@ A file chooser with directory navigation is built in.
|
||||
| `job list\|add\|set\|del\|run\|auto` | scheduled backups (own target path per job) |
|
||||
| `restore …` | restore a backup |
|
||||
| `import …` | import a migration bundle |
|
||||
| `image status\|list\|pull\|download\|load\|use` | obtain and select the Checkmk image |
|
||||
| `image status\|list\|versions\|test\|pull\|download\|load\|use` | obtain and select the Checkmk image |
|
||||
| `browser [--engine …]` | terminal browser in a container – operate the Proxy Manager locally |
|
||||
| `config list\|get\|set\|edit` | show and change settings in `.env` |
|
||||
| `npm-port [PORT]` | set/show the port of the Proxy Manager interface |
|
||||
|
||||
Reference in New Issue
Block a user