imglife status

Synopsis

imglife status [flags]

Generates a Markdown README summarising the state of all images across the three tiers: mirrors, base images, and applicative images.

Flags

Flag	Default	Description
--output string	stdout	Write the report to a file

Examples

# Print to stdout
imglife status

# Write to a file
imglife status --output README.md

# Commit the report to git (typical CI usage)
imglife status --output README.md
git add README.md
git commit -m "chore: update status report"
git push

Report structure

The generated report includes:

1. Table of contents
2. Mirror images — all entries in sync.entries
3. Base images — all entries in build.images of type core or spe
4. Applicative images — all build records from the Package Registry
5. Legend
6. Custom block — status.client_zone content if configured

Example output

## Base images

| Image  | Tag                         | Platforms     | EOL        | Status |
| ------ | --------------------------- | ------------- | ---------- | ------ |
| alpine | 3.21.3-core1.0.0            | amd64 · arm64 | 2026-11-01 | ✅     |
| golang | 1.22.3-alpine3.21-core1.0.0 | amd64         | 2026-02-01 | ⚠️     |
| ubuntu | 22.04-core1.0.0             | amd64         | ❌ EOL     | ❌     |

## Applicative images

| Project          | Image           | Base                    | Built      | Status           |
| ---------------- | --------------- | ----------------------- | ---------- | ---------------- |
| myteam/myservice | myservice:1.2.0 | alpine:3.21.3-core1.0.0 | 2026-04-01 | ✅ up-to-date    |
| myteam/api       | api:2.0.0       | alpine:3.19.4-core1.0.0 | 2026-01-15 | ⚠️ base outdated |

Status indicators

Icon	Meaning
✅	OK — within EOL, up-to-date
⚠️	Warning — EOL within alert threshold, or base outdated
❌	Error — EOL expired

Customising the report

Add a status.client_zone block in imglife.yaml to append custom Markdown:

status:
  client_zone: |
    ---
    Pipeline runs daily at 06:00 UTC.
    Contact #platform-images for questions.

See status configuration.

Exit codes

Code	Meaning
0	Report generated successfully
1	Error generating the report