기술 · 실용 가이드
Podman이 짧은 이미지 이름을 해석하지 못하나요? 전역 검색 변경 전에 registry와 alias를 확인하세요
local image와 remote pull을 나누고 effective alias/cache를 점검한 뒤 fully qualified name, scoped alias, 승인된 search list 중 좁은 해결책을 선택합니다.
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 이미지에는 명확한 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할 수 있습니다.
가장 좁은 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이 과도하지 않아야 완료입니다.
