🐳 Docker Compose로 WordPress 구축하기: 초보자를 위한 완벽 가이드

🌟 도입: 왜 Docker Compose로 WordPress를 구축할까?

Docker Compose를 사용하면 한 줄의 명령어로 WordPress 전체 인프라를 자동화할 수 있습니다!
✅ 전통적인 설치보다 10배 빠른 구성
✅ MySQL, PHP, 웹 서버 종속성 문제 해결
✅ 개발/테스트/운영 환경 일관성 보장
✨ “컨테이너 오케스트레이션”의 진수를 경험해보세요!

⚙️ 1. 사전 준비 사항

필수 도구 설치

# Docker & Docker Compose 설치 (Linux 기준)
sudo apt update && sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

디렉토리 구조 준비

my-wordpress/
├── docker-compose.yml   # 설정의 핵심 파일
└── wp-data/             # WordPress 파일 저장 (자동 생성)

🧩 2. docker-compose.yml 파일 구조 분석

핵심 컴포넌트

1. MySQL 컨테이너 : 데이터베이스 엔진
2. WordPress 컨테이너 : 웹 애플리케이션
3. 볼륨(Volume) : 데이터 영구 저장
4. 네트워크(Network) : 컨테이너 간 통신

🛠 3. 실전 docker-compose.yml 예제

version: '3.8'

services:
  # MySQL 데이터베이스 서비스
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql    # DB 데이터 영구 저장
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw  # 🔑 루트 비밀번호
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
    networks:
      - wordpress_net

  # WordPress 서비스
  wordpress:
    image: wordpress:latest
    depends_on:
      - db   # DB 서비스 시작 후 실행
    ports:
      - "8000:80"   # 🌐 호스트 8000포트 → 컨테이너 80포트
    volumes:
      - wp_data:/var/www/html   # 웹사이트 파일 저장
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wordpress
    networks:
      - wordpress_net

# 볼륨 정의 (데이터 영구화)
volumes:
  db_data:   # MySQL 데이터
  wp_data:   # WordPress 설치 파일

# 커스텀 네트워크
networks:
  wordpress_net:
    driver: bridge

🔍 핵심 설정 해설

• depends_on : DB 컨테이너가 먼저 실행되도록 보장
• environment : 컨테이너 환경변수 (보안 주의!)
• volumes : 호스트 서버에 데이터 저장 → 컨테이너 재생성 시 유지
• ports : 호스트포트:컨테이너포트 매핑

🚀 4. 실행 & 운영 명령어

시작하기

docker-compose up -d  # 백그라운드 실행

• 접속 주소: http://서버IP:8000

상태 확인

docker-compose ps  # 서비스 상태 확인

       Name              Command          State          Ports       
--------------------------------------------------------------------
mywordpress_db_1       docker-entrypoint.sh mysqld   Up      3306/tcp
mywordpress_wordpress  docker-entrypoint.sh apach ... Up      0.0.0.0:8000->80/tcp

정지 및 삭제

docker-compose down   # 컨테이너 중지
docker-compose down -v  # 🔥 볼륨까지 완전 삭제 (주의!)

🧪 5. 고급 설정 팁

1. 비밀번호 보안 강화

.env 파일 생성 후:

MYSQL_ROOT_PASSWORD=SuperSecret123!
WORDPRESS_DB_PASSWORD=StrongPass456@

docker-compose.yml에서 참조:

environment:
  MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}

2. WordPress 설정 커스터마이징

wordpress:
  environment:
    WORDPRESS_CONFIG_EXTRA: |
      define('WP_DEBUG', true); 
      define('WP_MEMORY_LIMIT', '256M');

3. Nginx 리버스 프록시 추가

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - wordpress

🛡️ 6. 문제 해결 가이드

💡 빈번한 이슈 대응법

1. 포트 충돌
   ERROR: Port 8000 is already in use
   → ports: 값을 "8080:80"으로 변경

2. 권한 문제
   Unable to create directory 'wp-content/uploads'
   → 호스트에서 chmod -R 777 wp-data/ 실행

3. DB 연결 실패
   Error establishing a database connection
   → docker-compose restart db로 DB 재시작

🎯 마무리: Docker Compose의 장점 요약

• 🚀 5분 내 프로덕션급 WordPress 구축
• 🔄 버전 관리 용이 – docker-compose.yml 파일로 인프라 코드화
• 📦 의존성 문제 해결 – 모든 환경에서 동일한 동작 보장
• 🆓 무료 오픈소스 – 추가 비용 없이 엔터프라이즈급 기술 활용

> 💬 마지막 조언:
> docker-compose.yml 파일은 반드시 버전 관리(Git)에 저장하세요!
> docker-compose up -d 한 번으로 언제든 재구축이 가능합니다.

# 최종 실행 시퀀스
mkdir my-wp && cd my-wp
nano docker-compose.yml  # 위 예제 내용 복사
docker-compose up -d     # 세계에서 가장 빠른 WordPress 설치!

이제 브라우저에서 http://localhost:8000을 열고 설치를 완료하세요! 🎉 D