Spring Boot 애플리케이션 Docker 이미지 빌드하기

Tech Note 정보
카테고리: [ Cloud Computing & MSA ]
조회수: 39167

1. 개요

Spring Boot 애플리케이션을 Docker 이미지로 배포하는 방법을

maven 플러그인을 사용하는 법과 docker build 명령어를 사용하는 법으로 나누어 설명한다.

 

2. Maven 플러그인 사용

1) Dockerfile 작성

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD RestAPI-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

 

2) pom.xml 수정

  • spotify에서 제공하는 docker client 플러그인을 추가한다.
...
<plugin>
  <groupId>com.spotify</groupId>
  <artifactId>docker-maven-plugin</artifactId>
  <version>1.0.0</version>
  <configuration>
    <imageName>devopsmgmt/rest-api</imageName>
    <dockerDirectory>src/main/docker</dockerDirectory>
    <resources>
      <resource>
        <targetPath>/</targetPath>
        <directory>${project.build.directory}</directory>
        <include>${project.build.finalName}.jar</include>
      </resource>
    </resources>
  </configuration>
</plugin>
...
  • imageName: 도커 이미지 이름을 기재함.
  • dockerDirectory: Dockerfile이 있는 위치를 기재함.

 

3. docker build 

1) maven 빌드

bash-4.2$ mvn clean package
 

2) Dockerfile 작성

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD target/RestAPI-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
  • jar 파일 위치를 Dockerfile 위치 기준으로 알맞게 지정해야 함.

 

3) docker 이미지 빌드 

bash-4.2$ docker build -t rest-api-test .
Sending build context to Docker daemon 44.51 MB
Step 1/4 : FROM openjdk:8-jdk-alpine
 ---> a3562aa0b991
Step 2/4 : VOLUME /tmp
 ---> Using cache
 ---> f00f5d59ca15
Step 3/4 : ADD target/RestAPI-0.0.1-SNAPSHOT.jar app.jar
 ---> 2d94f3672a37
Removing intermediate container 6212bf6ebc44
Step 4/4 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar
 ---> Running in 0d339e37d49a
 ---> 2cd7d4dde0eb
Removing intermediate container 0d339e37d49a
Successfully built 2cd7d4dde0eb

 

4. 빌드 시 유의사항

root가 아닌 유저로 빌드할 경우, 다음과 같은 에러가 발생할 수 있다.

[maven 플러그인 사용할 경우]

[ERROR] Failed to execute goal com.spotify:docker-maven-plugin:1.0.0:build (default-cli) on project RestAPI: Exception caught: java.util.concurrent.ExecutionException: com.spotify.docker.client.shaded.javax.ws.rs.ProcessingException: java.io.IOException: Permission denied -> [Help 1]
 
[docker build 명령 사용할 경우]
bash-4.2$ docker build -t rest-api-build .
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.26/build?buildargs=%7B%7D&buildbinds=null&cachefrom=%5B%5D&cgroupparent=&cpuperiod=0&cpuquota=0&cpusetcpus=&cpusetmems=&cpushares=0&dockerfile=Dockerfile&labels=%7B%7D&memory=0&memswap=0&networkmode=default&rm=1&shmsize=0&t=rest-api-build&ulimits=null: dial unix /var/run/docker.sock: connect: permission denied
 
해결을 위해서는 다음 두가지 방법을 참고한다.
 
1) 사용중인 유저를 docker 그룹에 추가
bash-4.2$ usermod -aG docker <user> 
bash-4.2$ systemctl restart docker
 
2) docker.sock의 권한 변경
bash-4.2$ cd /var/run
bash-4.2$ ls -al docker.sock
srw-rw----   1 root root              0 Jan 28 18:14 docker.sock
bash-4.2$ chmod 666 docker.sock
bash-4.2$ ls -al docker.sock
srw-rw-rw-   1 root root              0 Jan 28 18:14 docker.sock