Docker docker container rename : 이름을 통일성 있게 바꾸고 싶어~

docker container rename 명령어는 실행 중이거나 중지된 컨테이너의 이름을 다른 이름으로 변경할 수 있게 해주는 Docker CLI 명령입니다. 이 기능은 특히 컨테이너 이름을 더 명확하게 관리하고자 할 때 유용하며, 실수로 생성된 이름을 바꾸고 싶은 경우에 자주 사용됩니다.

---

🔧 Docker docker container rename 명령어 완벽 가이드

📌 개요

Docker에서는 컨테이너를 생성할 때 --name 옵션을 사용해 이름을 지정할 수 있지만, 이미 생성된 컨테이너에 대해서는 이름을 바꾸는 방법이 따로 필요합니다. 바로 이럴 때 사용하는 명령어가 docker container rename입니다.

✅ 문법

docker container rename <현재_이름> <새_이름>

• <현재_이름>: 바꾸고자 하는 컨테이너의 기존 이름 또는 ID
• <새_이름>: 새로 지정할 이름

---

🧪 실전 예제

1. 컨테이너 생성

docker run -d --name old-name nginx

이제 old-name이라는 이름의 컨테이너가 실행 중입니다.

2. 이름 변경

docker container rename old-name new-name

이제 해당 컨테이너는 new-name으로 이름이 변경되었습니다.

3. 확인

docker ps

출력 예시:

CONTAINER ID   IMAGE     COMMAND                  NAMES
3a1b2c3d4e5f   nginx     "/docker-entrypoint.…"   new-name

---

반응형

 

📦 컨테이너 ID로도 사용 가능

컨테이너의 이름 대신 ID로도 이름을 변경할 수 있습니다.

docker container rename 3a1b2c3d4e5f my-nginx

단, ID의 처음 몇 글자만 입력해도 인식합니다.

---

⚠️ 주의사항

1. 실행 중이든 중지 상태든 모두 변경 가능

docker stop old-name
docker container rename old-name new-name

이렇게 중지된 컨테이너도 이름을 바꿀 수 있습니다.

2. 이름 중복은 불가

이미 존재하는 이름으로는 바꿀 수 없습니다.

docker run -d --name existing nginx
docker container rename new-name existing

오류: Error response from daemon: Conflict. The container name "/existing" is already in use

3. 컨테이너 이름은 네트워크 설정 등에서 사용될 수 있음

일부 도커 네트워크 구성에서는 컨테이너 이름이 DNS와 연결되어 동작할 수 있으므로 이름 변경 시 주의가 필요합니다.

---

🔁 리네이밍 자동화 예시

배포 환경에서 자동으로 생성된 컨테이너 이름을 보다 명확하게 바꾸고 싶다면 스크립트를 사용할 수 있습니다.

#!/bin/bash

CONTAINER_ID=$(docker ps -qf "ancestor=nginx")
docker container rename $CONTAINER_ID my-nginx

위 스크립트는 nginx 이미지를 기반으로 실행 중인 컨테이너를 찾아 my-nginx로 이름을 변경합니다.

---

📘 이름 관리 팁

• 컨테이너 이름은 가시성 측면에서 매우 중요합니다.
• 의미 있는 이름을 사용하면 docker logs, docker exec, docker stop 등 명령어에서 관리가 쉬워집니다.
• 운영 환경에서는 고정된 이름을 유지하는 것이 스크립트 자동화 및 배포 관리에 유리합니다.

---

🧠 함께 알아두면 좋은 명령어

명령어 설명

docker ps	실행 중인 컨테이너 목록 확인
docker inspect <이름>	컨테이너의 세부 정보 확인
docker container ls -a	모든 컨테이너 확인
docker container stop <이름>	컨테이너 중지
docker container rm <이름>	컨테이너 삭제

---

📝 마무리

docker container rename 명령어는 단순하지만 실무에서 매우 유용하게 활용됩니다. 복잡한 프로젝트에서는 컨테이너가 여러 개 생기기 때문에 이름을 명확하게 관리하는 것이 중요하며, 잘못 생성된 컨테이너 이름을 바꿔가며 유지보수하기 위해 반드시 알아둬야 할 명령어입니다.

---