참조

• 블로그: https://alden-kang.tistory.com/1

jib란

• 애플리케이션 컨테이너화에는 대표적으로 Dockerfile 정의해 놓고 docker build 명령어를 통해 컨테이너 이미지를 만드는 게 가장 많이 알려진 방법
• 이걸 자바 애플리케이션에 반영하면 애플리케이션 빌드 후 jar 파일을 통해 Dockerfile을 작성해서 원하는 베이스 이미지에 빌드된 결과물을 저장하는 형태로 컨테이너 이미지가 만들어지게 됨
• 하지만, 위 과정은 자동화가 어려움, 먼저 maven이나 gradle 이용한 빌드의 과정을 포함해야 하며 빌드가 성공했다면 빌드의 결과 파일을 Dockerfile 통해 베이스 이미지에 넣어 줘야 함
• 즉, 빌드와 Dockerfile 작성의 과정을 하나의 파이프라인으로 만들 순 있겠지만 엄밀히 말하면 두 개의 작업이 도는 것
• 이러한 이슈를 해결하기 위해 jib가 만들어짐

Docker, Jib

• jib는 프로젝트를 빌드함과 동시에 컨테이너 이미지까지 만들어서 원하는 레포에 푸시까지 해줌
• 앞선 과정을 모두 통합하여 하나의 과정으로 만듦
• 실행도 간편함 → ./gradlew jib

jib 활용

• 의존성 추가

  • build.gradle에 jib 라이브러리 추가

  • 코드 예시

    plugins {
    	id("org.springframework.boot") version "3.0.0"
    	id("io-spring-dependency-management") version "1.0.11.RELEASE"
    	id("java")
    	id("com.google.clude.tools.jib") version "3.1.2"
    }
    

• jib 설정

  • build.gradle에 jib 설정을 추가

  • from

    • 해당 구문에서 설정할 수 있는 가장 중요한 항목은 image
    • jib 라이브러리가 애플리케이션을 컨테이너 이미지로 만들 때 사용하는 베이스 이미지를 지정하는 항목
    • 아무것도 설정하지 않으면 adoptopenjdk:11-jre로 설정

  • to

    • 해당 구문에서 설정할 수 있는 가장 중요한 항목은 image와 tags
    • 여기에서의 image는 from과는 반대로 생성된 컨테이너 이미지가 저장될 레포지터리 의미
    • tags는 이 이미지에 설정될 태그 의미

  • container

    • 컨테이너 이미지가 컨테이너화 되어서 실행될 때 필요한 자바 애플리케이션 설정들을 지정할 수 있음
    • 그 중 jvmFlags가 가장 중요한 항목

  • 코드 예시

    jib {
    	from {
    		...
    	}
    	to {
    		...
    	}
    	container {
    		...
    	}
    }
    
    // hankkang 예시
    jib {
    	from {
    		// 컨테이너 이미지는 가능한 가벼워야 하기 떄문에 alpine 사용
    		// 컨테이너 이미지를 만들 때 이미지 내부에서 빌드까지 할 게 아니라면 jdk 불필요
    		// 버전이 명시되어 향후 보안 취약점이나 버그 발생 시 영향 쉽게 확인 가능
    		image = "eclipse-temurin:17.0.6_10-jdk-alpine"
    	}
    	to {
    		credHelper = "erc-login"
    		image = "055375850930.dkr.ecr.ap-northeast-2.amazonaws.com/oh-my-diving:latest"
    		tags = "latest"
    	}
    	container {
    		jvmFlags = [
    			"-server",
    			"-Xms2g",
    			"-Xmx2g",
    			"-XX:+UseContainerSupport",
    			"-Dspring.profiles.actice=production",
    			"-XX:+useStringDeduplication",
    			"-Dfile.encoding=UTF8",
    			"-Dsun.net.inetaddr.ttl=0",
    			"-Dtag=latest"
    		]
    		environment = {
    			"stage": "production",
    			"port": "9142",
    			"serviceName": "oh-my-diving-api"
    		}
    		mainClass = "com.ohmydiving.api.OhMyDivingApiApplicationKt"
    		user = "nobody"
    		ports = [
    			"9142"
    		]
    		creationTime = "USE_CURRENT_TIMESTAMP"
    	}
    }
    

jib로 컨테이너 이미지 생성하기

• 도커 허브에 이미지를 푸시하는 경우 docker login 명령으로 로그인 필요
• 로그인이 성공한 경우 ./gradlew jib 명령을 실행 → 성공한 경우 BUILD SUCCESSFUL 메세지 확인 가능
• 푸시한 이미지 풀로 당기기 → docker pull 055375850930.dkr.ecr.ap-northeast-2.amazonaws.com/oh-my-diving:latest