NodeJS 서버 만들기

그럼 첫 번째 단계로 NodeJS 서버를 만들어 보도록 하겠습니다. 여러분들의 PC에 NodeJS가 설치되었다는 가정하에 시작하도록 하겠습니다. 저는 AWS에 ubuntu 개발환경을 만들어 Cloud9 IDE를 이용하여 개발하도록 하겠습니다.

먼저 서버를 만들고자 하는 폴더를 생성한 뒤 (nodejs_w_react) 해당 폴더로 이동합니다. 이후 터미널에 다음의 명령어를 입력하여 NodeJS 프로젝트를 생성합니다.

npm init -y

프로젝트를 생성하였으면 package.json 파일이 생성된 것을 확인할 수 있습니다. 일종의 configuration 파일과 같은 역할을 한다고 보시면 됩니다. 파일 내용을 살펴보면 현재 프로젝트에 설치한 라이브러리 목록이나 서버 실행 시 처음으로 참조할 파일명 등을 확인할 수 있습니다. 중간에 main : index.js라고 적힌 부분은 index.js를 처음 시작 페이지로 설정하겠다는 의미입니다. 그럼 저희는 이에 맞춰 index.js 파일을 생성해 보도록 하겠습니다.

우리의 프로젝트 폴더(nodejs_w_react) 안에 index.js라는 이름의 파일을 생성해 보겠습니다. 아직은 아무 내용이 없는 빈 파일입니다.

이제 서버를 본격적으로 구축해 보아야 할 텐데 서버를 구축하는 방법은 크게 두 가지로 나눌 수 있습니다. nodejs legacy를 이용한 방법과 express라는 npm package를 이용하는 방법입니다. express는 서버 구축을 조금 더 용이하게 하기 위해서 제공되는 라이브러리라고 보시면 됩니다.

또한 서버 구동 시 터미널을 종료해도 지속적으로 업데이트하기 위해서 nodemon이라는 npm도 같이 설치해 보도록 하겠습니다. 먼저 nodemon을 설치해 봅시다.

1. nodemon 설치하기

https://www.npmjs.com/package/nodemon
위 링크를 통해 nodemon 공식 홈페이지로 이동합니다.

노드몬은 nodejs 기반의 애플리케이션을 개발할 때 자동으로 재시작할 수 있도록 돕는 도구라고 설명이 되어 있습니다. 그리고 바로 아래에 설치하는 방법이 나와 있습니다. 해당 명령어로 설치해 보겠습니다.

sudo npm install -g nodemon

앞에 붙는 sudo라는 명령어는 윈도우에서 이야기하는 관리자 권한을 부여하는 키워드입니다.

nodemon을 실행하는 방법은 명령창에 nodemon을 먼저 입력한 뒤 우리가 실행할 node 파일명을 입력하는 방식입니다. 기존 node index.js 대신에 nodemon index.js처럼 입력하면 됩니다.

2. express 설치하기

다음으로는 express package를 설치해보겠습니다. 역시나 설치방법이나 사용에 관하여는 공식 홈페이지를 통해 확인해 보겠습니다. 물론 제 글과 같이 보다 자세하게 한글로 설명하는 설명글들이 많이 있지만 공식 홈페이지를 통해서 직접 확인하는 습관을 키우는 것은 자신의 개발 역량을 키우는 데 큰 도움이 됩니다.
https://www.npmjs.com/package/express

위 링크를 타고 가면 express 공식 홈페이지를 확인할 수 있습니다. npm의 경우 비슷한 이름의 package들이 많이 만들어집니다. 글자 하나만 바꾼다던가 띄어쓰기를 하거나 안 하거나 차이인 거죠. 그래서 내가 원하는 package인지 검증하는 것이 중요합니다. 보통은 다운로드 수를 통해서 확인하는 것이 가장 안전합니다.

상세 설명에 가장 먼저 서버 예시 코드가 적혀있네요. 총 6줄이 적혀있는데 저 코드만 작성하면 정말 서버 기본 세팅을 끝이 납니다. 그전에 먼저 express를 설치해 보겠습니다.

터미널에 프로젝트 폴더에서 다음의 명령어를 실행합니다.

sudo npm install express

express 설치를 완료하면 많은 변화가 생깁니다. 먼저 node_modules라는 폴더가 새로 생성된 것을 볼 수 있습니다. 그리고 package.json 파일에 dependencies라는 내용이 추가되면서 안에 express의 버전 정보가 보입니다. 앞으로 package들을 지속적으로 설치하게 될 텐데 모두 package.json 파일에 기록됩니다. express 모듈까지 설치하였으니 이제 실제 서버 프로그래밍을 시작해 보겠습니다. 앞서 홈페이지의 가장 상단에 있던 코드를 기반으로 다음과 같이 index.js파일에 입력합니다.

마지막에 app.listen(45123)의 경우 포트번호를 입력하는 것으로써 포트번호는 여러분들의 개발 환경에 따라 다양하게 설정할 수 있습니다. 저는 방화벽 설정의 이유로 45123을 사용하고 있습니다.
터미널에 다음의 명령어를 입력하여 실행시킨 뒤 ‘starting ‘node index.js’라는 결과를 받으면 서버가 정상 작동하기 시작하는 것입니다.

그럼 브라우저를 열어 여러분의 홈페이지에 접속하면 다음의 결과를 확인할 수 있습니다.

개인 PC에서 작업하시는 분들은 브라우저에 localhost:45123을 입력하시면 동일한 결과를 보실 수 있습니다.