テクノロジー · 実用ガイド

Podman で短いイメージ名を解決できない?グローバル検索を変える前に registry と alias を確認

local image と remote pull を分け、effective alias と cache を調べ、fully qualified name・scoped alias・承認済み search list を選んで identity を検証します。

Podman で短いイメージ名を解決できない?グローバル検索を変える前に registry と alias を確認
オリジナル概念図: Podman image identity resolution ledger. Watch at Ease

short-name failure は設定より先に identity の問題です。literal reference と失敗 context を保存します。

安全な順序は local image、effective alias/cache、registry policy、狭い修正、source verification です。

literal reference と context を保存

command、image text、version、user、rootless/rootful、TTY、完全な error を保存します。

docker.io を推測しません。distro defaults は異なり CI/systemd は prompt に答えられません。

local image を証明

local repository、tag、ID、digest を列挙し、build/load/commit の image には明確な local name を付けます。

local image が目的ならここで止めます。registry edit は wrong tag を直しません。

effective config と cache を監査

対象 user の user/system/drop-in config と cache を読み、search list、mode、alias を記録します。

alias key/value に tag/digest は不可で、user config は system policy を override できます。

最も狭い deterministic remedy を選択

automation は fully qualified reference、安定 shorthand は scoped alias、global search は明示承認時だけです。

prompt は CI contract ではなく、error を消すだけの policy 弱化はしません。

resolved source を検証

同じ user/launcher で再実行し qualified name、ID、repository digest を確認します。

original context が意図した image を deterministic に取得し rule が過剰でない時だけ完了です。

local image と remote pull を分け、effective alias と cache を調べ、fully qualified name・scoped alias・承認済み search list を選んで identity を検証します。
オリジナル概念図: Podman short-name remedy scope decision. Watch at Ease