FTP로 직접 배포하는 개발자의 삽질기
TL;DR
기존 사이트를 개선하고 배포하는 과정에서 겪은 시행착오를 공유합니다. 새로운 디자인과 기능을 적용하는 동시에 배포 자동화까지 고민했죠.
오늘 뭘 만들었나
이번 프로젝트는 지역 주짓수 도장 홈페이지 제작이었습니다. 8년차 풀스택 개발자로서 직접 사이트를 처음부터 끝까지 구현했죠. 그 과정에서 FTP를 이용한 수동 배포 방식의 한계를 실감했어요.
클린한 디렉토리 구조 만들기
먼저 전체 사이트 구조를 세세하게 계획했습니다. 메인페이지, 소개, 수업 안내, 시간표 등 필수 페이지를 나누고 각각의 역할을 정의했죠. 그리고 깔끔한 디렉토리 구조로 파일들을 정리했답니다.
FTP로 수동 배포하기
개발이 완료되자마자 서버에 직접 접속해서 파일을 업로드했죠. 하지만 생각보다 더 골치 아팠어요. 디렉토리 경로를 잘못 넣어서 몇 개의 파일이 제대로 올라가지 않았거든요. (으악 내 코드가!)
자동화를 위한 CLAUDE.md 만들기
다음부터는 이런 실수가 생기지 않도록 배포 가이드를 문서화하기로 했어요. 프로젝트 루트에 `CLAUDE.md`라는 파일을 만들어 전체 디렉토리 구조와 FTP 배포 명령어를 적어뒀죠.
삽질 & 교훈
이번에 가장 고민했던 부분은 바로 배포 자동화였어요. FTP로 파일을 하나하나 옮기다 보니 실수도 많이 나고, 시간도 오래 걸렸거든요.
그래서 배포 프로세스를 표준화하고 싶었어요. `CLAUDE.md`에 정리한 내용대로 스크립트를 짜보려고 했지만, 막상 구현하려니 도구 선택부터 고민이 되더라고요. 어떤 언어로? SSH 쓸까 아니면 SFTP? 온갖 삽질을 다 했죠.
(아직 완전히 자동화하진 못했지만, 이번 경험으로 앞으로 다음에는 좀 더 나은 방법을 찾을 수 있을 것 같아요.)
결과물
사이트는 무사히 배포되었고, 새로운 디자인과 기능이 반영되었어요. 메인 페이지 방문자가 30% 증가했다고 해서 고객사에서 칭찬도 받았답니다.
하지만 여전히 매번 FTP로 파일을 옮기는 건 귀찮거든요? 나중에 시간 나면 배포 자동화를 완벽하게 구현해야겠어요. 그럼 다음에 또 개발 삽질기를 공유하겠습니다! ?