도커 컨테이너 이름 바꾸기 - 3가지 방법으로 완벽 정복

“컨테이너 이름이 cranky_euler라니, 도대체 뭐하는 앤데?” 도커를 처음 사용할 때 누구나 한 번쯤 겪는 당혹스러운 순간입니다. 도커는 컨테이너 생성 시 자동으로 랜덤한 이름을 부여하는데요, 프로젝트가 커지면서 수십 개의 컨테이너를 관리해야 할 때 이런 이름들은 혼란만 가중시킵니다. 이 가이드 하나로 도커 컨테이너 이름 변경을 마스터하세요.

Table of Contents

도커 컨테이너 이름, 왜 중요할까?

실무에서 컨테이너 이름은 단순한 식별자가 아닙니다. 팀원들과의 협업, 로그 추적, 모니터링 시스템 연동 등 모든 과정에서 명확한 네이밍은 생산성을 좌우합니다. 통계에 따르면 명확한 네이밍 규칙을 따르는 팀은 디버깅 시간을 평균 40% 단축한다고 합니다.

도커가 자동으로 생성하는 이름의 비밀

도커는 재미있는 과학자 이름과 형용사를 조합해서 컨테이너 이름을 자동 생성합니다. happy_turing, eloquent_morse 같은 식이죠. 하지만 이런 이름은 프로덕션 환경에서는 전혀 유용하지 않습니다.

# 컨테이너 목록 확인
docker ps -a

# 출력 예시
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS   NAMES
a1b2c3d4e5f6   nginx     ...       ...       ...      cranky_euler

이름 컬럼을 보세요. 이게 웹서버인지 데이터베이스인지 전혀 알 수 없죠.

방법 1: docker rename으로 즉시 변경하기 (가장 권장)

도커 버전 1.10부터 추가된 docker rename 명령어는 가장 간단하고 안전한 방법입니다.

기본 사용법

docker rename <기존_이름_또는_ID> <새_이름>

실전 예제로 배우기

시나리오 1: 웹서버 컨테이너 이름 정리

# 현재 상태: cranky_euler라는 nginx 컨테이너
docker ps

# 명확한 이름으로 변경
docker rename cranky_euler production-webserver

# 결과 확인
docker ps
# NAMES 컬럼이 production-webserver로 변경됨

시나리오 2: 컨테이너 ID로 변경하기

이름을 모르거나 특수문자가 포함된 경우 ID 사용이 편리합니다.

# 컨테이너 ID 확인
docker ps -a

# ID로 이름 변경
docker rename a1b2c3d4e5f6 dev-database

# 즉시 적용되어 다음 명령어부터 새 이름 사용 가능
docker logs dev-database

실행 중인 컨테이너도 변경 가능

놀랍게도 컨테이너를 중지하지 않고도 이름을 바꿀 수 있습니다.

# 실행 중인 웹서버의 이름 변경
docker rename running-app new-app-name

# 서비스 중단 없이 즉시 적용
docker exec new-app-name ps aux

방법 2: 컨테이너 재생성으로 이름 설정하기

구버전 도커를 사용하거나, 컨테이너를 완전히 새로 시작하고 싶을 때 유용한 방법입니다.

단계별 상세 가이드

1단계: 현재 컨테이너 상태 확인

docker ps -a
# 변경하려는 컨테이너 정보를 메모하세요

2단계: 실행 중이라면 중지

docker stop old-container-name

3단계: 변경사항을 이미지로 저장

docker commit old-container-name my-custom-image:v1.0

이 단계가 중요합니다. 컨테이너에서 작업한 모든 내용(패키지 설치, 설정 변경 등)이 이미지로 저장됩니다.

4단계: 기존 컨테이너 삭제

docker rm old-container-name

5단계: 새 이름으로 컨테이너 실행

docker run -d --name new-container-name my-custom-image:v1.0

데이터를 유지하면서 재생성하기

볼륨을 사용하는 컨테이너라면 데이터 손실을 방지해야 합니다.

# 기존 볼륨 확인
docker inspect old-container-name | grep Mounts -A 10

# 볼륨을 연결하여 새 컨테이너 생성
docker run -d \\
  --name new-container-name \\
  -v my-data-volume:/app/data \\
  my-custom-image:v1.0

네트워크 설정까지 복제하기

# 기존 컨테이너의 네트워크 확인
docker inspect old-container-name | grep NetworkMode

# 동일한 네트워크로 새 컨테이너 생성
docker run -d \\
  --name new-container-name \\
  --network my-network \\
  -p 8080:80 \\
  my-custom-image:v1.0

방법 3: Docker Compose로 체계적으로 관리하기

여러 컨테이너를 운영한다면 Docker Compose가 최선입니다.

docker-compose.yml 파일 작성

version: '3.8'

services:
  webserver:
    container_name: production-nginx
    image: nginx:latest
    ports:
      - "80:80"

  database:
    container_name: production-postgres
    image: postgres:14
    environment:
      POSTGRES_PASSWORD: secret

컨테이너 이름 변경 프로세스

파일에서 container_name만 수정하고 재실행하면 됩니다.

# 기존 컨테이너 중지 및 삭제
docker-compose down

# 새 이름으로 재생성
docker-compose up -d

# 변경 확인
docker-compose ps

이 방법은 설정이 코드로 관리되어 버전 관리가 가능하고, 팀원들과 공유하기도 쉽습니다.

실무에서 꼭 알아야 할 주의사항

이름 충돌 에러 해결하기

같은 이름의 컨테이너가 이미 있으면 에러가 발생합니다.

docker rename app new-app
# Error: Conflict. The container name "/new-app" is already in use

해결책:

# 기존 컨테이너 확인
docker ps -a | grep new-app

# 기존 컨테이너 삭제 또는 다른 이름으로 변경
docker rm new-app
# 또는
docker rename new-app old-app

# 이제 원하는 이름 사용 가능
docker rename app new-app

연결된 컨테이너가 있는 경우

다른 컨테이너가 이름으로 연결되어 있다면 주의가 필요합니다.

# 연결 확인
docker inspect container-name | grep Links

# 네트워크 별칭 사용이 더 안전
docker network create my-network
docker network connect --alias webserver my-network container-name

도커 버전 호환성 체크

# 도커 버전 확인
docker --version

# 1.10 미만이라면 업그레이드 권장
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli

프로젝트별 네이밍 전략 7가지

효율적인 컨테이너 관리를 위한 네이밍 규칙을 소개합니다.

1. 환경-서비스-버전 구조

dev-api-v1
staging-database-v2
prod-webserver-v3

2. 팀명 또는 프로젝트명 포함

frontend-team-nginx
backend-team-redis
payment-service-db

3. 날짜 기반 네이밍

app-2025-01-15
backup-db-20250115

4. 기능 중심 네이밍

user-authentication-api
product-search-engine
notification-worker

5. 포트 번호 포함

webserver-8080
api-gateway-3000

6. 복제본 번호 추가

web-replica-1
web-replica-2
web-replica-3

7. 스택 기반 그룹화

lamp-apache
lamp-mysql
lamp-php

자동화 스크립트로 대량 변경하기

컨테이너가 많다면 스크립트를 활용하세요.

Bash 스크립트 예제

#!/bin/bash

# 특정 패턴의 컨테이너 이름 일괄 변경
OLD_PREFIX="old"
NEW_PREFIX="new"

for container in $(docker ps -a --format "{{.Names}}" | grep "^${OLD_PREFIX}"); do
    new_name="${container/$OLD_PREFIX/$NEW_PREFIX}"
    echo "Renaming: $container -> $new_name"
    docker rename "$container" "$new_name"
done

echo "모든 컨테이너 이름 변경 완료!"

실행 방법

# 스크립트 저장
nano rename-containers.sh

# 실행 권한 부여
chmod +x rename-containers.sh

# 실행
./rename-containers.sh

안전한 일괄 변경

변경 전 백업 목록을 만들어두면 실수를 방지할 수 있습니다.

#!/bin/bash

# 현재 컨테이너 목록 백업
docker ps -a --format "{{.ID}}\\t{{.Names}}" > container-backup-$(date +%Y%m%d).txt

# 변경 작업 수행
# ... (변경 스크립트)

echo "백업 파일 생성: container-backup-$(date +%Y%m%d).txt"

문제 해결 가이드

“컨테이너를 찾을 수 없습니다” 에러

docker rename old-name new-name
# Error: No such container: old-name