OCP 학습 2일차 · 이미지 이름과 태그 읽기

오늘의 학습 목표

• 이미지 주소를 레지스트리·네임스페이스·저장소·태그로 나눠 읽습니다.
• 같은 로컬 이미지에 이름을 추가하고 IMAGE ID를 비교합니다.
• 태그와 digest의 차이를 설명합니다.

1. 이미지 주소 읽기

1일차에서는 이미지와 컨테이너를 구분했습니다. 오늘은 OpenShift Container Platform(OCP)을 배우기에 앞서 Podman으로 이미지 이름을 읽어 봅니다.

registry.access.redhat.com/ubi9/ubi:latest

전체 저장소 경로는 ubi9/ubi입니다. UBI는 Red Hat Universal Base Image의 약자입니다.

태그는 이미지에 붙이는 변경 가능한 이름표입니다. 여러 태그가 같은 이미지를 가리킬 수 있고, 같은 태그가 나중에 다른 이미지를 가리킬 수도 있습니다.

latest는 특별한 안전 인증이나 항상 최신이라는 보장이 아닙니다. 버전처럼 보이는 태그도 변경될 수 있습니다. 특정 이미지 내용을 고정해서 참조하려면 태그 대신 검증된 digest를 사용합니다.

podman images의 로컬 IMAGE ID와 레지스트리에서 참조하는 manifest digest는 구분해야 합니다. 로컬 목록의 ID를 그대로 digest 주소에 넣지는 않습니다.

2. 같은 이미지에 이름 하나 더 붙이기

학습 기준: OCP 4.20 · 참고 문서: RHEL 9 · 검증 환경: Rocky Linux 9.8 / Podman 5.8.2 / ARM64 / root

Podman이 설치된 개인 학습용 Linux에서 진행합니다. 환경이 없다면 아래의 실제 결과와 비교 방법을 읽으며 학습해도 됩니다.

먼저 로컬 이미지 목록을 확인합니다.

podman images

registry.access.redhat.com/ubi9/ubi의 latest가 없다면 학습용 이미지를 가져옵니다. 이번 검증에서는 기존 로컬 이미지를 사용했으므로 다운로드하지 않았습니다.

podman pull registry.access.redhat.com/ubi9/ubi:latest

목록에 localhost/ocp-study-ubi:day2가 이미 있다면 가리키는 이미지를 먼저 확인하세요. 다른 이미지라면 덮어쓰지 말고 다른 실습용 태그를 선택합니다.

기존 이미지에 학습용 이름을 추가합니다.

podman tag registry.access.redhat.com/ubi9/ubi:latest localhost/ocp-study-ubi:day2

이 명령은 로컬 이미지에 이름을 추가합니다. 레지스트리로 업로드하거나 컨테이너를 실행하는 명령은 아닙니다.

다시 목록을 확인합니다.

podman images

실제 검증 결과 — 2026-11-01

맥미니의 VMware Fusion 학습용 VM에서 원본 latest가 있고 실습용 day2 이름은 없는 상태를 확인한 뒤 실행했습니다. podman tag는 출력 없이 종료 코드 0으로 완료됐습니다. 아래는 이어서 실행한 podman images의 실제 출력이며, 이 명령도 종료 코드 0으로 완료됐습니다.

REPOSITORY                            TAG     IMAGE ID      CREATED     SIZE
localhost/ocp-study-ubi                day2    4df3d65a2ea5  4 days ago  236 MB
registry.access.redhat.com/ubi9/ubi    latest  4df3d65a2ea5  4 days ago  236 MB

두 행의 이름과 태그는 다르지만 IMAGE ID는 4df3d65a2ea5로 같습니다. 같은 로컬 이미지에 이름이 추가된 것입니다. 이미지 파일 전체가 두 벌 복제되거나 원격 레지스트리로 전송된 것이 아닙니다.

CREATED와 SIZE는 이번 관측값입니다. 실행 시점이나 이미지 갱신에 따라 달라질 수 있습니다. 이번 작업에서는 다운로드·push·삭제 없이 이름만 추가했고, 추가한 태그는 로컬에 남겨 두었습니다.

3. 실패했을 때 확인할 것

• command not found: Podman 설치와 현재 셸의 실행 경로를 확인합니다.
• 원본 이미지를 찾지 못함: podman images에서 저장소 이름과 태그를 확인합니다.
• 다운로드 실패: 실제 오류 메시지와 DNS·인터넷 연결을 확인합니다.
• 종료 상태 확인: 확인할 명령 직후, 다른 명령을 실행하기 전에 아래 명령을 사용합니다. 0은 성공을 뜻합니다. 이름 추가 후에는 이미지 목록도 함께 확인합니다.

echo $?

4. 확인 퀴즈

1. 여러 태그의 IMAGE ID가 같으면 파일 전체가 복제된 것일까요? 아닙니다. 같은 로컬 이미지에 여러 이름이 연결된 것입니다.
2. latest를 쓰면 다음에도 같은 이미지가 보장될까요? 아닙니다. 태그가 가리키는 이미지는 변경될 수 있습니다.

세 줄 정리

• 이미지 주소는 레지스트리·저장소 경로·태그로 읽습니다.
• 태그는 이름표이며, 여러 이름이 같은 이미지를 가리킬 수 있습니다.
• 재현성을 위해 내용을 고정할 때는 검증된 digest를 사용합니다.

다음 3일차에는 이미지 레지스트리의 역할을 학습합니다.

공식 참고 문서

• Red Hat: RHEL 9 컨테이너 이미지 작업
• Red Hat: OCP 4.20 이미지 개요
• Podman: tag
• Podman: images
• Podman: image inspect