[Docker] 이미지 및 컨테이너 이름 변경 방법

Docker를 사용하다 보면 이미 생성된 이미지나 컨테이너의 이름을 변경해야 할 때가 있습니다.

 

회사에서 외부 프로젝트를 진행할 때, 내부에서는 필요할 때마다 명령어를 검색할 수 있지만, 고객사 환경에서는 제약이 많아 쉽게 검색하기 어려웠습니다.

그래서 명령어를 외우거나 기록해 두는 것이 중요하다고 생각해 정리해 둡니다.

 

Docker에서는 컨테이너와 이미지를 직접적으로 "이름 변경"하는 기능을 제공하지 않지만, 적절한 명령어 조합을 사용하면 간단히 해결할 수 있습니다.

 

Docker 이미지 이름(Tag) 변경하기

Docker 이미지는 특정한 태그(Tag) 를 가질 수 있으며, 이 태그는 이미지의 별칭(Alias) 역할을 합니다. 따라서 Docker에서 이미지의 이름을 바꾸려면 새로운 태그를 부여한 후 기존 태그를 삭제하는 방식을 사용해야 합니다.

 

1. 새로운 태그(Tag) 추가

docker image tag <기존 이미지>:<기존 태그> <새로운 이미지>:<새로운 태그>


예제: docker image tag myapp:1.0 myapp:latest

 

이렇게 하면 myapp:1.0 이미지와 동일한 ID를 가진 myapp:latest 태그가 생성됩니다.

2. 기존 태그 삭제

기존 태그를 유지하고 싶다면 삭제하지 않아도 됩니다. 하지만 원래 태그를 제거하고 싶다면 다음 명령어를 실행합니다.

docker rmi <기존 이미지>:<기존 태그>


예제: docker rmi myapp:1.0

삭제 후 docker images를 실행하면 myapp:latest만 남아 있는 것을 확인할 수 있습니다.

 

Docker 컨테이너 이름 변경하기

Docker 컨테이너는 실행 시 특정한 이름을 부여할 수 있으며, 실행 후에도 docker rename 명령어를 사용하여 이름을 변경할 수 있습니다.

 

1. 컨테이너 이름 변경

docker rename <기존 컨테이너 이름> <새 컨테이너 이름>


예제: docker rename old_container new_container

 

2. 변경된 컨테이너 확인

docker ps -a

이 명령어를 실행하면 new_container라는 새로운 이름이 적용된 것을 볼 수 있습니다.

---

정리

Docker에서 직접적으로 이미지나 컨테이너 이름을 변경하는 기능은 없지만, 다음과 같은 방법을 활용하면 쉽게 원하는 결과를 얻을 수 있습니다.

✅ 이미지 이름 변경: docker image tag로 새로운 태그를 생성 후 기존 태그 삭제

✅ 컨테이너 이름 변경: docker rename을 사용하여 즉시 변경 가능

이 방법을 활용하면 Docker 이미지를 관리할 때 더 유연하게 운영할 수 있다.