리눅스 설정

초기 설정

프로젝트를 실행 하기 위한 최소한의 리눅스 Util 설정

참고: 서버 초기 설정 - Rhel 7,8

Node.JS 설정

NodeJS는 버전 변경에 효율적으로 대응하기 위해 NVM 설치 권장, 폐쇠망에서는 Binary 설치 필요

참고: https://ionsdp.atlassian.net/wiki/spaces/ICE4P/pages/1722090933

Nginx 설정

Nginx 설치

Yum으로 설치 권장, 폐쇠망에서는 Binary 설치 필요

참고: Nginx 설치

Global Nginx 설정: /etc/nginx/nginx.conf

참고: Nginx global 설정(nginx.conf)

gzip 설정

서비스 성능 튜닝을 위한 정적 리소스 압축

참고: Nginx global 설정(nginx.conf) | gzip 압축 설정

BackOffice 서버용 설정: /etc/nginx/conf.d/backoffice.conf

Http통신, Https 통신에 따른 Backend 서버 설정

참고: Nginx Applicaion 서버 conf 설정

ICE4 BackOffice Application Linux 설치

서버 실행을 위한 필수 파일 목록

전체 BackOffice 소스 파일

• 저장경로: /app/ice4/{프로젝트명}-{서버타입}/admin

• (예시) /app/ice4/demo-dev/admin/

노드 모듈

• 서버에서 설치: npm i -g yarn cross-env pm2

  • npm라이브러리 설치: yarn

  • 환경 변수 사용: cross-env

  • 어플리케이션 데몬 실행: pm2

홈 디렉토리 설정

폴더 생성

프로젝트에 사용할 관련 폴더 생성

생성 필요한 폴더 리스트

• /app/ice4

• /app/ice4/{프로젝트명}-{서버타입}/

참고: ICE4 서버 네이밍룰 표준 가이드- Rhel 7,8

리눅스 서버에 소스 저장: /app/ice4/{프로젝트명}-{서버타입}/admin

Option 1. 서버에서 Git clone 후 빌드 & 실행

Git 에서 소스 내려받기

프로젝트 경로로 이동

cd /app/ice4/{프로젝트명}-{서버타입}

• (예시) cd /app/ice4/demo-dev

git clone

git clone -b {브랜치명} {Git URL}

• (예시) git clone -b project/DEMO http://dcsf-dev08.i-on.net/dxp/frontbuilder.git

Open

폴더명 변경

mv frontbuilder admin

Open

최종 파일 저장 예시

해당 프로젝트 폴더 /app/ice4/{프로젝트명}-{서버타입}/admin에 git에서 내려받은 파일이 저장되어야함

BackOffice 노드 모듈 설치

yarn install

BackOffice 빌드 실행

yarn run build:{서버타입}

• (예시) 개발서버: yarn run build:dev

빌드 파일 확인

Option 2. SFTP로 빌드 파일 저장

backoffice 로컬에서 서버용 빌드

빌드 실행

프로젝트 폴더에서 서버 타입을 지정하고 빌드 명령어 실행

yarn run build:{서버타입}

• (예시) 개발서버: yarn run build:dev

빌드 완료 확인

프로젝트 폴더명 변경

• 프로젝트 폴더명 → admin

전체 소스 압축

tar -zcvf admin.tar.gz admin

• 서버에서 git연결을 하지 않을 경우 .git 폴더 삭제 후 압축 권장(압축 시간 축소)

파일 FTP로 서버에 저장

tar 파일 저장

저장경로: /app/ice4/{프로젝트명}-{서버타입}/admin.tar.gz

tar 파일 압축 해제

tar -zxvf admin.tar.gz

서버 실행

파일 위치: /app/ice4/{프로젝트명}-{서버타입}/admin

서버 시작

pm2 start ecosystem.config.js --env {서버타입}

• (예시) 개발서버: pm2 start ecosystem.config.js --env dev

서버 종료

pm2 stop ecosystem.config.js --env {서버타입}

로그 확인

pm2 log ecosystem.config.js --env {서버타입}

혹은 서비스명

pm2 log ice4-admin