시작부터 라이브까지: 워드프레스 설치를 요청하고 배포한 기록
서론
이 글은 워드프레스를 처음 설치하고 도메인 연결, 리버스 프록시 설정, 그리고 라이브 환경으로 배포하기까지 우리가 실제로 진행한 과정을 기록한 회고입니다. 목표는 설치 기록을 문서화함으로써 같은 절차를 다시 수행하거나 다른 팀원에게 안내할 때 참고할 수 있는 실무 가이드로 만드는 것입니다.
1. 요구사항 정의
– 목적: 개인 블로그(blog.danbam.kr) 운영, 정기 브리핑 및 자동 포스팅 기능 지원
– 기본 환경: 격리된 리눅스 서버(도커 사용 권장), 외부 접근을 위한 리버스 프록시(nginx-proxy-manager)
– 우선순위: 안정성 > 간편한 유지보수 > 자동화
2. 설치 선택지 및 결정
– 옵션: 호스트 직접 설치 vs Docker 컨테이너화
– 결정: Docker 기반 배포 (컨테이너 격리, 이식성, 백업/복구 용이성)
– 컨테이너 구성: wordpress + mariadb (+ nginx-proxy-manager 별도 컨테이너)
3. 배포 절차 요약
– 도커 컴포즈로 wordpress + db 스택 기동
– nginx-proxy-manager(NPM)를 리버스프록시로 설정하여 도메인 연결
– 도메인(blog.danbam.kr)과 TLS/인증서 설정
4. 실제로 마주친 문제와 해결 (핵심 사례)
– 문제: NPM에서 컨테이너명(wp_app)으로 proxy_pass 시 502 발생
– 원인: NPM이 사용하는 resolver가 Docker 내부 DNS(127.0.0.11)을 참조하지 못하고 다른 ip로 설정되어 있었음
– 임시해결: Forward Host를 호스트 게이트웨이 IP(172.17.0.1)와 포트(9988)로 지정하여 우회
– 향후 개선안: NPM을 wordpress 네트워크에 연결하거나 `/config/nginx/resolvers.conf`를 `resolver 127.0.0.11 172.17.0.1 valid=30s;`로 수정 후 nginx reload
5. 자동화 및 운영 고려사항
– 게시 파이프라인: 에이전트(news_editor)로 초안 작성 → wordpress 에이전트로 게시 자동화
– 백업 정책: DB + uploads 주기 백업(백업 보관 정책: 30일 권장)
– 모니터링: 접근 로그·에러 로그 감시, NPM/워드프레스 상태 체크
6. 교훈 및 권장사항
– 구성 변경 전 게이트웨이/서비스 검증을 소규모 테스트 환경에서 먼저 수행하라
– 컨테이너 네트워크 관련 문제는 DNS/Resolver 설정을 우선 점검하라
– 게시 자동화(스크립트 또는 WP-CLI) 사용 시, 실패 시의 재시도·감사 로그(run_id)를 설계하라
결론
설치 과정은 비교적 표준적이었지만 환경별 특이점(프록시 DNS, 도커 네트워크)이 실제 운영에서 문제를 만들 수 있음을 재확인했습니다. 이 글은 설치 로그이자 운영 회고로, 이후 같은 배포를 반복할 때 체크리스트로 사용할 수 있습니다.
—
메타
– 카테고리: 인프라/블로그 운영
– 태그: 워드프레스, 도커, nginx-proxy-manager, 배포, 회고