리눅스 설정

초기 설정

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

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

자바 설정

ICE4는 자바 11 사용, Yum으로 설치 권장, 폐쇠망에서는 Binary 설치 필요

참고: Java11 설치 - Rhel 7,8

Nginx 설정

Nginx 설치

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

참고: Nginx 설치

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

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

gzip 설정

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

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

FrontOffice 서버용 설정: /etc/nginx/conf.d/frontoffice.conf

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

참고: Nginx Applicaion 서버 conf 설정

ICE4 FrontOffice Application Linux 설치 - Jenkins SCM

홈 디렉토리 설정

ICE4 BackOffice 실행하는 유저와 동일한 유저로 생성된 홈 디렉토리 필요

경로: /app/ice4

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

Jenkins SCM

jenkins SCM은 별도의 빌드 스크립트나 설정을 구성하지 않은 채, 소스에 저장되어있는 Jenkinsfile에 있는 스크립트를 사용하여 Build하는 방식

젠킨스에서 파이프라인 생성

젠킨스홈 → New Item 클릭

Open

파이프라인 이름 입력 → Pipeline → OK 클릭

• 파이프라인 명명 규칙: {프로젝트명}-web-{서버타입}

  • (예시) demo-web-dev

Open

Pipeline 탭 클릭

Pipeline script fromSCM 클릭

• SCM : Git

• Repository URL: Git 소스 URL

• Credentials: Git 계정/비밀번호

  • config → credentials에서 설정된 계정 정보

• Branch Specifier: Git Branch 정보

정보 입력 후 Save 클릭

Build Now 클릭

Build 버튼 → Build with Parameters 로 변경된 것 확인

• 최초 빌드 실행시에는 빌드에 사용할 파라미터 정보를 로딩하지 못하여 에러 발생하는것이 정상

Build with Parameters 클릭

• CI/CD에 사용할 파라미터가 활성화된 것 확인. 아래의 그림과 같이 Form 형태로 출력

Build 클릭

빌드 완료되는것 확인

로그 확인 방법

• 왼쪽 하단 빌드 실행된 번호 클릭

Console Output 클릭

빌드시 에러가 발생하는지 로그 확인

빌드 완료시 Success 확인 가능

각 단계에서 fail이나 warning이 있었는지 최종확인

최초 배포시 서버에 접속하여 배포된 파일 및 로그 확인

ICE4 프로젝트 경로: /app/ice4/demo-dev

• web: 프로젝트 소스 파일

• logs: 로그 폴더

ICE4 BackOffice 배포 경로: /app/ice4/demo-dev/web

긴급 상황시 사용 가능한 Start/Stop 명령어

긴급 상황에서 ICE4 FrontOffice를 Start/Stop를 하기위해 pm2를 사용

• 프로젝트 폴더에서 명령어 실행

서버 시작

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

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

• 프로젝트 소스 폴더에서 명령어 실행: /app/ice4/{프로젝트명}-{서버타입}/web

서버 종료

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

• 프로젝트 소스 폴더에서 명령어 실행: /app/ice4/{프로젝트명}-{서버타입}/web

로그 확인

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

혹은 서비스명

pm2 log ice4-admin