テクノロジー · 実用ガイド
Podman で短いイメージ名を解決できない?グローバル検索を変える前に registry と alias を確認
local image と remote pull を分け、effective alias と cache を調べ、fully qualified name・scoped alias・承認済み search list を選んで identity を検証します。

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 が過剰でない時だけ完了です。
