Web Server - by. UXKM

  • Gulp
  • Web Server & Watching Files
  • Web Server

요약 설명

Gulp로 빌드한 결과물(dist)을 브라우저에서 보려면 내 컴퓨터에서 잠깐 켜 두는 작은 웹 서버가 필요합니다.
예전에는 gulp-webserver 하나로 한 번에 처리했지만, 오래되어 최신 Node에서 잘 안 돌아가는 경우가 있습니다. 그래서 본 커리큘럼·UXKM에서는 역할을 나눠 여러 패키지를 조합합니다.

비유하면 이렇습니다.

  • 식당(서버)을 열고 → connect
  • 완성된 음식(빌드 파일)을 손님에게 내주고 → serve-static (dist 폴더)
  • 주방이 바뀌면 손님에게 “새로고침하세요”라고 알리고 → tiny-lr + connect-livereload
  • 브라우저를 자동으로 열어 주고 → open

파일을 저장하면 Gulp가 src를 다시 빌드해 dist를 갱신하고, 변경을 감지한 뒤 브라우저가 알아서 새로고침됩니다. 이것이 Live Reload입니다.

패키지가 하는 일

이름을 외울 필요는 없습니다. “누가 무엇을 맡는지”만 이해하면 뒤의 설치·코드가 훨씬 쉽게 읽힙니다.

  1. connect — 로컬 웹 서버의 뼈대입니다. “이 주소로 요청이 오면 처리한다”는 틀을 만듭니다.
  2. serve-static — 그 틀 위에 “이 폴더 안의 HTML·CSS·이미지를 그대로 보여 줘”라고 붙입니다. 여기서는 빌드 결과인 dist를 가리킵니다.
  3. tiny-lr — 파일 변경을 브라우저에 알려 주는 알림 서버(Live Reload)입니다.
  4. connect-livereload — 브라우저 쪽에 Live Reload용 작은 스크립트를 넣어, 알림이 오면 페이지를 자동으로 새로고침하게 연결합니다.
  5. open — gulp dev 실행 시 http://localhost:8080/ 같은 주소를 브라우저에서 자동으로 엽니다.
  6. http (Node.js 내장) — 실제로 포트를 열고 요청을 받는 기본 도구입니다. npm으로 설치하지 않습니다.

정리하면, connect + serve-static으로 dist를 브라우저에 보여 주고, tiny-lr + connect-livereload로 저장할 때마다 화면을 갱신하는 구조입니다.

웹 서버 패키지 설치

위에서 역할을 나눈 패키지를 터미널에서 설치합니다. http는 Node.js 내장 모듈이므로 설치하지 않습니다.

gulpfile.babel.js 세팅

gulpfile.babel.js 파일의 코드를 아래처럼 추가 및 수정합니다. (영역별 설명은 주석으로 표시합니다.)
변경이 없는 부분은 생략되며, 추가된 부분과 수정, 삭제된 부분의 코드만 표시됩니다.
또한 변경 없음, 추가된 부분, 수정, 삭제된 부분을 표시하는 텍스트는 마우스로 드래그해도 선택되지 않으므로 코드를 편리하게 복사할 수 있습니다.
전체 코드는 에디터 오른쪽의 [View full code]를 클릭하여 확인할 수 있습니다.

코드에 있는 DEV_PORT와 LR_PORT는 번호가 다른 두 개의 문이라고 생각하면 됩니다.

  • DEV_PORT (기본값 8080) — 브라우저에서 사이트를 볼 때 쓰는 주소입니다. gulp dev를 실행하면 보통 http://localhost:8080/으로 열립니다.
  • LR_PORT (기본값 35729) — 파일을 저장했을 때 브라우저에 “새로고침하세요”라고 알려 주는 Live Reload 전용 번호입니다. 사이트 주소와는 별개이므로 외울 필요는 없습니다.

다른 프로그램이 이미 8080을 쓰고 있다면 DEV_PORT 숫자만 바꿔도 됩니다. 자세한 옵션은 connect, serve-static, tiny-lr 문서를 참고하세요.

gulp dev 실행

gulpfile.babel.js 파일을 세팅한 후 터미널에서 아래 명령을 실행합니다.

Gulp가 실행되고 터미널에 Gulp의 작업 내용이 출력됩니다.

gulp dev 실행시 터미널에 작업내용 출력

Gulp 실행 후 두 가지 변경 사항을 확인할 수 있습니다.

  1. 기존까지는 build series까지만 실행되었기 때문에 dev가 종료되면 Gulp도 종료되어 명령어를 입력할 수 있는 상태로 돌아갔지만, 지금은 build series 실행 후 live series에서 webserver가 실행되고 dev는 종료되지만 webserver 동작을 위해 Gulp 프로세스는 유지됩니다.
  2. Gulp의 작업 내용에 webserver 시작이 추가되고, 아래처럼 http://localhost:8080/ 주소로 브라우저가 자동으로 열립니다.

connect 웹 서버로 브라우저가 열린 화면

아직 css task와 image task를 세팅하지 않았기 때문에 CSS가 적용되지 않고 이미지가 보이지 않는 것이 정상입니다.

gulp 프로세스 종료

위 [gulp dev 실행]에서 확인했듯이 현재 시점에서 gulp dev를 실행하면 프로세스가 유지되고 명령어를 입력할 수 없습니다.
이때, Gulp 프로세스를 종료하려면 터미널에서 Ctrl + C (Mac의 경우 Command + C)를 입력한 후 y를 입력해야 합니다.

gulp dev 프로세스 종료

Gulp가 종료되고 webserver도 종료되었기 때문에 브라우저에서는 '사이트에 연결할 수 없음' 메시지가 표시됩니다.

gulp 종료 후 브라우저 화면

️한눈에 보는 요약!

webserver 세팅
[webserver 세팅]

이 페이지 공유하기


댓글

아래 언어 버튼을 누르면 마크다운 코드블록이 자동으로 삽입됩니다. 삽입된 영역에 코드를 입력하세요.