컨테이너 가상화(Docker)를 활용한 전자정부 표준프레임워크 기반 프로그램의 도커 이미지 제작

본 가이드는 컨테이너 가상화 기술인 도커(Docker)를 활용하여 전자정부 표준프레임워크의 기반 응용프로그램(Web Application)의 도커 이미지 제작 가이드를 제공한다.

본 가이드의 사용자는 기본 도커(Docker)에 대한 기본적인 지식 있는다는 것을 가정하였다.

• 도커 관련 기본 내용은 도커사이트에서 https://www.docker.com 확인 가능하다.

표준프레임워크 개발환경에 도커 이미지 제작을 통하여 아래와 같은 특징으로 적용 효과를 제시한다.

• 호스트 OS 와 서비스 운영 환경 분리

• 다양한 환경의 플랫폼 실행 가능

• 컨테이너 호환성 및 경량화

• 클라우스보다 진보된 Container 서비스

• 마이크로 서비스 기반의 Container로 자원 효율성 향상

• 각종 컴포넌트의 독립적인 실행환경 보장으로 콤포넌트의 가용성 향상

• 마이크로 서비스 기반 독립성 보장으로 여러 서비스에 대한 실행 및 가용성 향상

• 도커(Docker) 기반으로 서비스를 제공 시 서버 구축 비용절감 효과

• 도커(Docker) 기반 서비스 개발 및 운용 시 각 서비스의 통일성 보장

1. 전자정부 표준프레임워크 기반 응용프로그램의 도커(Docker) 이미지 제작

• 도커파일(Dockerfile)을 활용한 이미지 제작

• 메이븐(Maven) 빌드 시 플러그인(docker-maven-plugin)을 활용한 도커 이미지 제작

2. 제작된 도커 이미지 실행 및 테스트

본 가이드의 진행을 위한 구현도구 및 환경정보는 다음과 같다.

응용프로그램의 Docker 이미지화를 위하여 2가지의 방법을 제시한다.

• [주의] 도커 메이븐 플러그인(docker-maven-plugin)은 도커의 정식 지원 버전이 아닌 도커 커뮤니티의 개인 개발자 오픈 소스이므로 안전성 및 기술지원(bug patch) 사항은 도입 전 충분한 검증을 통하여 도입이 되어야 한다.

$ docker version

[참고] 본 가이드의 도커 버전과 동일 할 필요는 없으나 이하 버전 및 최신 버전에서 가이드에서 사용한 API 및 구조가 변경 될 수 있으며, 도커 버전별 상의한 API 및 구조는 도커 사이트에서 확인 할 수 있다.

표준프레임워크 응용프로그램은 표준프레임워크의 템플릿을 활용하며, Docker파일(Dockerfile)을 추가 및 실행가능한 이미지를 제작하여 테스트를 한다.

(프로젝트명 마우스 오른쪽 버튼 클릭 후 “New” > “File”을 선택한다.)

# 베이스 이미지 설정
FROM tomcat:9.0

# 작성자 정보
LABEL eGovframe Center

# WAR 파일을 Tomcat의 웹 애플리케이션 디렉터리에 추가
COPY ./target/docker_webtest-4.2.0.war /usr/local/tomcat/webapps/

# Tomcat을 포어그라운드에서 실행
CMD ["catalina.sh", "run"]

• [참고] docker_webtest-4.2.0.war 파일은 Step 1에서 빌드 시 생성된 파일명을 사용한다.

(예: C:\eGovFrameDev-4.2.0-64bit\workspace\docker_webtest)

$ cd C:/eGovFrameDev-4.2.0-64bit/workspace/docker_webtest

$ ls

Dockerfile pom.xml src/ target/

(예: 도커 이미지명을 egovframe/webtest 이며, 테그를 v1로 설정한다.)

$ docker build –t egovframe/webtest:v1 .

• -t 옵션을 사용하여 테그를 설정한다.

• 자세한 옵션 설정은 docker build –help를 통하여 확인 가능하다.

• 명령어 마지막 뒤의 점(.)을 꼭! 잊지 말고 입력하여야 한다.

(예: Tomcat의 기본 포트를 8080 사용하여 컨테이너에서도 동일한 포트를 사용하도록 설정한다.)

$ docker run –t –i –p 8080:8080 egovframe/webtest:v1

• Run 에 대한 옵션은 –help통하여 상세한 정보를 확인 할 수 있다.

(예: http://192.168.99.100:8080/sample-3.5.0/)

메이븐 빌드 시 플러그인을 사용하여 빌드된 war파일과 베이지 이미지를 docker daemon에 직접 주입한다.

<!-- Docker Maven Plugin -->

                <plugin>

				    <groupId>com.spotify</groupId>

				    <artifactId>docker-maven-plugin</artifactId>

				    <version>0.4.10</version>

			        <configuration>

			            <imageName>egovframe/webtest</imageName>

			            <baseImage>tomcat</baseImage>

			            <entryPoint>["catalina.sh", "run"]</entryPoint>

			            <resources>

			                <resource>

								<targetPath>/usr/local/tomcat/webapps/</targetPath>

								<directory>${project.build.directory}</directory>

								<include>${project.build.finalName}.war</include>

			                </resource>

			            </resources>

			            <dockerHost>https://192.168.99.100:2376</dockerHost>

						<dockerCertPath>C:\\Users\\[컴퓨터사용자이름]\\.docker\\machine\\certs</dockerCertPath>			                   

			        </configuration>

			    </plugin> 

<!-- end Docker Maven Plugin -->

• 메이븐 도커 플러그인은 com.spotify 플러그인을 사용하였으며 아래 주소를 통하여 상세한 정보를 확인 할 수 있다. https://github.com/spotify/docker-maven-plugin

• Spotify/docker-maven-plugin은 정식 지원 버전이 아닌 개인 개발자 OSS이므로 버전별 지원사항 및 기능이 임의로 변경 및 삭제될 수 있으므로 주의하여 사용하여야 한다.

• 메이븐 플러그인(도커)는 TLS통신 통하여 Romote로 API를 사용하므로 TLS통신을 위한 ip:port 정보와 인증서를 사용하여 접속이 이루어 진다. (기본포트:2376)

• 윈도우용 도커 TLS인증서는 윈도우용 도커 설치시 아래와 같은 경로에 자동으로 설정된다.

    (예: C:\Users\[컴퓨터사용자이름]\.docker\machine\certs)

(예: 프로젝트명 마우스 오른쪽 클릭 > Run As > Maven build)

Docker Tooling을 활용한 도커 이미지 제작은 아래 링크의 “사용법 5. 프로젝트와 통합”을 참조한다.

https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:dev4.2:dep:build_tool:docker_tooling

https://docs.docker.com/engine/installation/linux/ubuntulinux/ 가이드에 맞추어 설치

• Docker 및 docker-engine 까지 설치

• 도커 그룹을 생성하고 root 권한을 부여 하여야함.

• 권한이 주어졌으면 아래와 같이 테스트로 확인함.

$ docker run hello-world

리눅스 환경의 도커에 SSL(HTTPS) 통신을 하기 위해서는 클라이언트 측에서 인증서(CA-Certification)가 있어야 하며 Openssl 통하여 서버키 및 클라이언트용 키를 생성하여 접속이 가능하다.

아래의 내용을 참조하여 리눅스 내 Docker 설정 및 인증서를 활용할 수 있다.

• Protect the Docker daemon socket https://docs.docker.com/engine/security/https/

• 도커 사이트 https://www.docker.com/

• 도커 메이븐 플러그인 https://dmp.fabric8.io/ , https://github.com/fabric8io/docker-maven-plugin