데이터 일관성을 보장하기 위해 서비스 중지 -> 데이터 이동 -> 권한 변경 -> 설정 업데이트 -> 재시작 순서로 진행합니다.
1단계: 기존 Docker 컨테이너 및 서비스 정지
데이터베이스(MySQL)와 웹 서비스가 파일에 쓰기 작업을 하는 도중 이관되면 데이터가 손상될 수 있으므로, 먼저 실행 중인 서비스들을 완전히 정지합니다.
Bash
# Docker Compose를 사용 중인 경우 (각 서비스 디렉터리에서 실행)
cd /root/docker/wordpress && docker compose down
cd /root/docker/rhymix && docker compose down
cd /root/docker/mysql && docker compose down
# 또는 실행 중인 모든 컨테이너 정지
docker stop $(docker ps -q)
2단계: 대상 디렉터리 생성 및 데이터 이동
/root 밑에 있던 디렉터리들을 /opt/docker로 안전하게 복사/이동합니다. 퍼미션 및 속성을 유지하기 위해 cp -a 옵션을 권장합니다.
Bash
# /opt/docker 디렉터리 생성 (root 권한으로 실행)
sudo mkdir -p /opt/docker
# 기존 디렉터리 복사 (WordPress, Rhymix, MySQL 데이터)
sudo cp -a /root/docker/* /opt/docker/
# 데이터 이동 검증 후 기존 데이터 보관 (문제 없을 시 차후 삭제)
sudo mv /root/docker /root/docker_backup
3단계: 디렉터리 소유권 및 권한 변경
이동한 디렉터리와 하위 파일 전체의 소유자를 teevee 사용자(및 해당 그룹)로 변경합니다.
Bash
# /opt/docker 및 하위 모든 파일/디렉터리의 소유권 변경
sudo chown -R teevee:teevee /opt/docker
4단계: teevee 사용자를 docker 그룹에 추가
teevee 일반 계정으로 sudo 없이 docker 명령어를 실행할 수 있도록 그룹에 추가해야 합니다.
Bash
# teevee 사용자를 docker 그룹에 등록
sudo usermod -aG docker teevee
# 변경된 그룹 권한 적용을 위해 teevee 계정으로 재접속하거나 세션 갱신
su - teevee
확인:
docker ps명령어를 수행했을 때 Permission denied 오류가 안 뜨는지 검증합니다.
5단계: Docker Compose 설정 파일 경로 점검
기존 docker-compose.yml 파일 내부의 Volume 마운트 경로에 /root/docker/... 형태의 절대 경로가 들어있다면 /opt/docker/...로 변경해 주어야 합니다.
- 상대 경로 사용 시 (
./data:/var/www/html등): 별도 수정 불필요. - 절대 경로 사용 시 (
/root/docker/wordpress/data:/var/www/html등):/opt/docker/wordpress/data로 변경.
6단계: teevee 계정으로 서비스 재시작
이제 teevee 계정으로 로그인한 상태에서 각 서비스를 다시 시작합니다.
Bash
# 계정 전환 (이미 teevee 계정이면 생략)
su - teevee
# 각 서비스 순차 시작
cd /opt/docker/mysql && docker compose up -d
cd /opt/docker/wordpress && docker compose up -d
cd /opt/docker/rhymix && docker compose up -d
⚠️ 주의사항 및 팁 (MySQL / Web Server 권한 문제)
- MySQL 8.0 권한 이슈:Docker 내부의 MySQL 프로세스는 컨테이너 내부의
mysql유저(UID 999 등)로 실행됩니다. 호스트의 디렉터리 소유자를teevee로 바꾼 후 MySQL 컨테이너가 복구될 때 권한 오류가 난다면, 컨테이너가 올바르게 해당 폴더 권한을 가져가는지docker logs [mysql_container_id]로 확인해 보세요. - Rootless Docker 적용 여부:이번 작업은 호스트의 일반 사용자(
teevee)가 Docker 데몬을 제어하도록 파일 경로와 그룹을 정리하는 작업입니다.만약 Docker 데몬 자체도 root 권한 없이 실행하는 Rootless Docker 환경으로 완전히 전환하시는 거라면, 기존 Docker 볼륨의 UID/GID 매핑(SubUID/SubGID)으로 인해 추가적인 permission 매핑 설정이 필요할 수 있습니다.
답글 남기기