GoDaddy 또는 Hostinger에 코드를 업로드하기 전 — 모든 개발자가 반드시 알아야 할 프로덕션 체크리스트

"내 컴퓨터에서는 잘 되는데" 함정: 실전 프로덕션 체크리스트 🚀

대부분의 초보자들은 배포(Deployment)가 단순히 파일들을 압축해서 GoDaddy나 Hostinger에 업로드하는 것이라고 생각합니다. 하지만 로컬 코드(Local code)와 프로덕션 환경(Production environments)은 완전히 다른 두 마리 괴물과 같습니다.

프로덕션 모범 사례(Best practices)를 무시하는 것은 개발자에게 최악의 악몽을 선사합니다: 한밤중에 발생하는 시스템 충돌, 데이터베이스 유출, 그리고 API 키 노출 같은 일들 말이죠.

다음은 개발자들이 실제로 실수하는 부분들에 대한 가감 없고 실용적인 체크리스트와, 그것이 어떻게 문제를 일으키는지에 대한 실제 사례입니다.

1. 비밀 정보(Secrets) 및 환경 변수(Environment Variables)

• 실수: .env 파일을 GitHub에 푸시하거나 저장소(Repository)에 하드코딩된 문자열을 남겨두는 것.
• 재앙: 봇이 당신의 공개 저장소를 스크래핑하여 OPENAI_API_KEY를 훔치고, 하룻밤 사이에 5,000달러의 요금을 발생시킴.
• 해결책: .gitignore에 .env를 추가하세요. 항상 호스팅 대시보드의 환경 변수를 통해 자격 증명(Credentials)을 주입하세요.

2. 인프라 불일치 (공유 호스팅 vs VPS)

• 실수: 현대적인 Node.js, WebSocket 또는 AI 중심 애플리케이션을 위해 저렴한 공유 호스팅(Shared hosting)을 구매하는 것.
• 재앙: 실시간 채팅 앱이 사용자 두 명까지는 작동하지만, 세 번째 사람이 접속하는 순간 완전히 멈춰버립니다. 공유 호스팅이 지속적인 백그라운드 프로세스(Background processes)를 강제로 종료하기 때문입니다.
• 해결책: 공유 호스팅은 정적 사이트(Static sites)나 기본적인 PHP/WordPress 용도로만 사용하세요. Node.js, 큐(Queues), 그리고 트래픽이 많은 서비스에는 VPS를 사용하세요.

3. 디버그 모드(Debug Mode)를 켜둔 채로 방치하기

• 실수: NODE_ENV=development 또는 APP_DEBUG=true 상태로 라이브 서비스를 운영하는 것.
• 재앙: 데이터베이스 쿼리가 실패했을 때, 프론트엔드(Frontend)가 악의적인 사용자에게 데이터베이스 구조, 폴더 경로, 내부 로직을 그대로 보여주는 거대한 스택 트레이스(Stack trace)를 표시하게 됩니다.
• 해결책: NODE_ENV=production을 강제하세요. 이는 내부 오류를 숨기고, 보안 취약점을 차단하며, 성능을 최적화합니다.

4. "수동 업로드" 도박

• 실수: cPanel 파일 관리자(File Manager)나 FTP를 통해 파일을 수동으로 드래그 앤 드롭하거나 덮어쓰는 것.
• 재앙: 실수로 폴더 하나를 누락하거나, 실제 사용자의 업로드 디렉토리를 덮어쓰거나, 전송 도중 연결이 끊겨 사이트가 완전히 망가지는 상황.
• 해결책: 인적 오류(Human error)를 제거하기 위해 Git 기반 배포(Git-based deployment) 또는 기본적인 GitHub Actions CI/CD 파이프라인을 구축하세요.

5. 루트 사용자(Root User)로 프로세스 실행

• 실수: 서버를 설정할 때 절대 관리자(root) 계정으로 앱을 실행하는 것.
• 재앙: 오래된 npm 패키지의 취약점을 통해 공격자가 앱에 접근합니다. 앱이 root 권한으로 실행되고 있기 때문에, 공격자는 서버의 전체 파일 시스템을 삭제할 수 있습니다.
• 해결책: Nginx를 리버스 프록시(Reverse proxy)로 사용하고, 전용의 제한된 권한을 가진 사용자(Limited-privilege user) 계정으로 애플리케이션을 실행하세요.

6. 충돌 처리(Crash Handling) 또는 장기 운영 계획 부재

• 실수: node server.js를 통해 앱을 실행하고, 프로덕션(Production) 서버에서 직접 npm install을 실행하는 것.
• 재앙: 처리되지 않은 예외(Unhandled exception)가 발생하여 앱이 충돌하면, 수동으로 로그인하여 재시작하기 전까지 웹사이트는 계속 다운된 상태로 유지됩니다. 그 와중에 npm install이 빌드를 깨뜨리는 마이너 패키지 업데이트를 가져올 수도 있습니다.
• 해결책:
  • PM2 또는 Supervisor를 사용하여 앱 충돌 시 자동으로 재시작되도록 설정하세요.
  • 깨끗하고 가벼우며 예측 가능한 빌드를 보장하기 위해 npm ci --production을 실행하세요.
  • 매번 코드를 푸시(Push)하기 전에 데이터베이스와 환경 파일(Environment files)에 대한 자동 백업을 설정하세요.

결론 👇

"배포는 단순히 코드를 옮기는 것이 아니라, 신뢰성을 엔지니어링하는 것입니다."

기능을 작성하는 것은 업무의 절반에 불과합니다. 당신이 잠든 동안에도 살아있는, 안정적이고 보안이 철저하며 자가 치유(Self-healing)가 가능한 시스템을 구축하는 것이 주니어 코더와 진정한 프로덕션 엔지니어를 구분 짓는 차이입니다.

여러분이 겪은 가장 큰 배포 재앙은 무엇이었나요? 실수로 라이브 데이터베이스를 날려버린 적이 있나요? 댓글로 이야기를 나눠봅시다! 👇