서버 개발환경 설치가이드
개요
전자정부 표준프레임워크에서 제공하는 서버 개발환경 구성 가이드를 제공한다.
설명
전자정부 표준프레임워크에서 제공하는 서버환경을 설치하기 위한 서버 환경 구성 가이드를 제공한다.
- 서버환경 구성(Windows): 윈도우 환경에서 전자정부 표준프레임워크이 제공하는 설치파일을 이용하여 서버 환경을 구성한다.
- 서버환경 구성(Unix 계열): Unix 계열(Aix, Linux, Solaris) 환경에서 전자정부 표준프레임워크이 제공하는 설치파일을 이용하여 서버 환경을 구성한다.
- 설치가이드: 윈도우 환경 및 Unix 계열 설치가이드는 동일하며, Unix계열의 SVN 설치가이드를 별도로 제공한다.
설치가이드
서버 개발환경 다운로드
- 인터넷 웹브라우저를 통해 eGovFrame 홈페이지 에 접속하여 사이트 상위메뉴를 통해 “다운로드 > 개발환경> 다운로드” 화면으로 이동한다.
- 서버 개발환경 게시물을 선택한다.
- OS에 맞춰 첨부된 파일을 다운로드받아 압축을 해제한다.
서버환경 구성(Windows)
1. 설치 파일
- eGovCI-5.0.0-Windows-64bit.zip (64bit용) 파일의 압축을 풀어 설치를 진행한다.
2. 환경 정보
- Apache-ant-1.10.15
- Apache-maven-3.9.9
- Jenkins 2.528.3 (LTS)
- Nexus Repository 3.86.2
- OpenJDK 17.0.17+10 (LTS)
- VisualSVN-Server-5.4.4-x64.msi - 64bit
※ 주의사항
- Nexus와 Jenkins는 JDK 17이상, svn은 별도로 설치 필요
- TOMCAT 메모리 설정이 필요한 경우 : start-xxxxx.bat(시작파일)파일에서 set JAVA_OPTS 설정을 변경
- 시작파일 : start-xxxxx.bat
3. 포트 변경
- Jenkins : start-jenkins.bat 파일에서 –httpPort의 값을 수정
- Nexus : {CI-HOME}\nexus/sonatype-work/nexus3/etc/nexus.properties 파일에서 application-port의 값을 수정
4. 서비스 실행
Jenkins(CI) 실행
- 서비스 실행 :
{CI-HOME}\start-jenkins.bat
- 서비스 실행 :
Nexus 실행
- 서비스 등록 :
{CI-HOME}\start-nexus.bat install(관리자의 권한으로 실행된 cmd 또는 PowerShell에서 명령 실행) - 서비스 실행 :
{CI-HOME}\start-nexus.bat start
- 서비스 등록 :
※ 주의사항
Nexus 서비스 등록은 Nexus 서비스 미등록 상태에서 Nexus 서버 구동 전 최초 1회에 한해 필요하다.
5. 서비스 실행 확인
Jenkins(CI) 확인
http://localhost:8082/ 로 들어가서 확인한다.
Jenkins(CI)가 정상작동하는지 확인한다.
Nexus 확인
http://localhost:8081/nexus/ 로 들어가서 확인한다.
※ 주의사항
- 포트번호 3690 (SVN포트)과 8082 (JENKINS 포트) , 8081 (NEXUS 포트)이 방화벽으로 막혀있다면 방화벽설정에서 3690과 8081, 8082 포트를 허용해 주어야 한다.
- Subversion(SVN) 설치 및 관리는 지원하지 않는다.(사용자 자체설치)
서버환경 구성(Unix 계열)
1. 설치 파일
- eGovCI-5.0.0-Linux-64bit.tar.gz 파일의 압축을 풀어 설치를 진행한다.
2. 환경 정보
- Apache-ant-1.10.15
- Apache-maven-3.9.9
- Jenkins 2.528.3 (LTS)
- Nexus Repository 3.86.2
- OpenJDK 17.0.17+10 (LTS) - OS_NAME=“Linux”, OS_ARCH=“x86_64”
※ 주의사항
- Nexus와 Jenkins는 JDK 17이상, svn은 별도로 설치 필요
- JAVA_HOME 설정이 필요한 경우 :
- start-jenkins.sh 파일에서
export INSTALL4J_JAVA_HOME_OVERRIDE를 강제로 지정- start-nexus.sh 파일에서
export JAVA_HOME을 강제로 지정- TOMCAT 메모리 설정이 필요한 경우 : start-nexus.sh(환경설정)파일에서 CI_OPTS 설정을 변경
- 실행파일 : start-xxxxx.sh
3. 서버별 JDK 설정
JDK는 사용자에 의해 시스템별로 자체 설치한다.(서버용 개발환경에서 기본으로 제공하는 JDK는 Linux x86_64 전용임)
JDK PATH 설정 필요
4. 포트 변경
- Jenkins : start-jenkins.sh 파일에서 –httpPort의 값을 수정
- Nexus : {CI-HOME}\nexus/sonatype-work/nexus3/etc/nexus.properties 파일에서 application-port의 값을 수정
5. 서비스 실행
Jenkins(CI) 실행
- 서비스 실행 :
{CI-HOME}/start-jenkins.sh
- 서비스 실행 :
Nexus 실행
- 서비스 실행 :
{CI-HOME}/start-nexus.sh start
- 서비스 실행 :
6. 서비스 실행 확인
Jenkins(CI) 확인
http://localhost:8082/ 로 들어가서 확인한다.
Jenkins(CI)가 정상작동하는지 확인한다.
Nexus 확인
http://localhost:8081/nexus/ 로 들어가서 확인한다.
※ 주의사항
- 포트번호 3690 (SVN포트)과 8082 (JENKINS 포트) , 8081 (NEXUS 포트)이 방화벽으로 막혀있다면 방화벽설정에서 3690과 8081, 8082 포트를 허용해 주어야 한다.
- Subversion(SVN) 설치 및 관리는 지원하지 않는다.(사용자 자체설치)