콘텐츠로 건너뛰기

DevOps 사전 과제

Devops 에 관심이 많았던 내게 도전 과제가 생겼다. 내용은 아래와 같고, 설계는 github에 올릴예정입니다.

과제 : 웹 어플리케이션을 Docker를 통해 서비스 하려 합니다. 다음 요구사항에 부합하도록 설정, 빌드, 실행 스크립트를 구현해주세요.

요구사항

  • 웹 애플리케이션 예제
  • build script는 gradle로 작성
  • 어플리케이션들은 모두 독립적인 Container로 구성
  • 어플리케이션들의 Log는 Host에 file로 적재
  • Container scale in/out 가능해야함
  • 웹서버는 Nginx 사용
  • 웹서버는 Reverse proxy 80 port, Round robin 방식으로 설정
  • 무중단 배포 동작을 구현( 배포 방식에 제한 없음)
  • 실행스크립트 개발언어는 bash/python/go 선택하여 작성
  • 어플리케이션 Rest api추가
    • [GET /health] Health check
    • Rest API 응답 결과는 JSON Object로 구현
  • README.md 파일에 프로젝트 실행 방법 명시

필요 파일 : docker-compose 야믈 파일, Dockerfile 등

깃헙 주소 : https://github.com/wonizz/spring-docker-example

Docker Spring Boot 시작하기

Wonizz, v0.0.1, 2019-02-26

[Assignment]

안녕하세요, 워니즈입니다. 과제 해결을 위하여 다음의 내용 학습.

  • gradle 정리
  • 배포 구성
  • nginx 웹서버 구성
  • 도커 스웜 레플리카
  • 도커 무중단 배포

이 프로젝트는 간단한 스프링 부트 페이지를 도커로 container를 생성하여 서비스 하고 있습니다.

[개요]

devOps과제로 spring-boot-starter를 사용자 정의하여 만드는 예제를 포함하고 있는 프로젝트다. spring-boot-starter는 spring-boot-autoconfigure 내에 ~~AutoConfiguration과 ~~Properties 클래스가 함께 존재하며 자동구성 클래스라는 것을 정의하는 spring.factories 설정파일과 애플리케이션 속성파일에서 자동완성을 지원하기 위해 additional-spring-configuration-metadata.json이 함께 필요하다.

사용자정의 spring-boot-starter는 팀 내부의 공통 설정을 starter로 만들어 스프링 부트 기반으로 애플리케이션 개발시 요긴하게 사용할 수 있다.

[스프링 도커]

link:https://spring.io/guides/gs/spring-boot-docker/ 스프링 도커 관련하여 참고할 수 있는 공식 문서이다. 처음 스프링 부트를 도커를 이용하여 빌드/배포 한다면, 읽기 좋다.

[그레이들 빌드]

link:https://medium.com/@goinhacker/%EC%9A%B4%EC%98%81-%EC%9E%90%EB%8F%99%ED%99%94-1-%EB%B9%8C%EB%93%9C-%EC%9E%90%EB%8F%99%ED%99%94-by-gradle-7630c0993d09 Gradle 을 이용하여 빌드하기와 간련하여 참고할 수 있는 유용한 블로그이다. 보통 Java를 이용하여 프로젝트를 작성하다보니, gradle 빌드 내용을 한눈에 보기 쉽게 정리해 두었다.

[도커 스웜]

link:https://subicura.com/2016/06/07/zero-downtime-docker-deployment.html 도커 스웜 레플리카 배포와 간련하여 참고할 수 있는 유용한 블로그이다.

[도커 빌드/배포 구성]

-git pull
	https://github.com/wonizz/spring-docker-example 의 프로젝트를 clone하였고, pull을 이용하여 소스를 최신으로 받는다. 
-gradle build
	현재 경로의 그레이들 툴을 사용하여 source빌드를 수행한다.
-jar파일 생성
	그레이들 빌드 후, build > libs 경로로 jar파일을 생성한다.
-이미지 빌드
	생성된 jar파일을 기준으로 docker image build를 수행한다.
-docker stack deploy(A/B)
	생성된 docker image를 기반으로 compose yml 파일로 배포를 수행한다. 

[사용법]

[빌드]

모든 내용은 프로젝트 내에 devops.sh에 작성되어있습니다.

명령 : ./devops build

빌드 수행시 현재의 경로에서 그레이들 빌드를 수행하여, build > libs 경로에 jar 파일을 생성합니다. 이후에, 도커 이미지 빌드를 수행하여 도커 이미지를 생성합니다. 빌드 수행시, 현재의 날짜 + 시간(시분초)로 태깅을 하고, 최신 빌드 수행을 latest로 추가 생성합니다. 예시)

docker_spring       20190226154956      703ac33aa142        About an hour ago   149MB
docker_spring       latest              703ac33aa142        About an hour ago   149MB
docker_spring       20190226142233      a34d7760509f        2 hours ago         149MB

[배포]

명령 : ./devops deploy [option]

[option] : tag날짜 (optional) tag날짜는 docker images로 확인이 가능합니다. 태그 날짜를 입력하지 않으면, latest로 배포가 됩니다.


[컨테이너 ]

명령 : ./devops restart|start|stop [option]

[option] : app name(blue/green) [required] 현재 도커 서비스가 되고 있는 app을 중지,시작,재시작이 가능합니다. docker service ls를 통해 확인된 서비스의 도커 컨테이너 관련 명령입니다.


[플로우]

개발자가 github에 수정한 소스를 push하면, 빌드/배포를 수행합니다. 빌드 명령으로 도커 이미지를 생성하고, 배포 명령으로 현재 서비를 blue/green배포 방식으로 배포를 합니다. 롤백 시에는 docker images에서 롤백이 필요한 이미지로 재배포를 수행합니다.

2026년 기준으로 다시 읽으면 어디가 달라졌나요?

안녕하세요? 정리하는 개발자 워니즈입니다. 이 글은 2019년에 푼 사전 과제를 그대로 옮긴 기록인데요, 7년이 지난 지금 같은 과제를 받는다면 손봐야 할 곳이 몇 군데 있어서 필자가 아는 범위에서 짚어 둡니다. 아래는 그대로 따라 하라는 절차가 아니라 2019년 구성과 지금 구성의 차이를 보는 용도입니다.

Java 8 기준이면 Spring Boot 3은 바로 못 올립니다

본문 앞쪽에 적은 언어 기준 Java 8 이상은 Spring Boot 2 시절 얘기입니다. Spring Boot 3.0 부터는 Java 17 이 최소 기준이라서(Spring 공식 블로그의 3.0 GA 공지에 Java 17 baseline 으로 적혀 있습니다) 이 예제를 새로 만든다면 Dockerfile 의 베이스 이미지도 JDK 17 이상으로 잡아야 합니다. 2019년 이미지 크기 149MB 는 당시 Java 8 기준 수치이니 지금 빌드하면 값이 다르게 나옵니다.

docker-compose 대신 docker compose 를 쓰나요?

과제 필요 파일에 compose 야믈이 들어 있는데, 지금은 하이픈 없는 docker compose 명령(Compose V2)이 기본입니다. 파일 맨 위의 version: 항목도 Docker 공식 문서에서 obsolete 로 분류돼 있어서 적어 두면 경고만 나오고 효과는 없습니다. 새로 쓰는 compose 파일에서는 그 줄을 빼는 쪽이 맞습니다.

/health 는 직접 만들어야 하나요?

과제 요구사항의 GET /health 는 컨트롤러를 직접 작성하는 방식이었습니다. 지금은 Spring Boot Actuator 를 의존성에 넣으면 /actuator/health 가 JSON 으로 응답하므로, 요구사항이 경로까지 고정하지 않는다면 그쪽이 코드가 적습니다. 경로를 반드시 /health 로 맞춰야 한다면 기존처럼 직접 만드는 쪽이 안전합니다.

blue/green 말고 swarm 롤링 업데이트로도 무중단이 되나요?

이 글은 blue/green 두 서비스를 번갈아 올리고 nginx 가 바라보는 쪽을 바꾸는 방식이었습니다. 같은 swarm 안에서 docker service update --update-order start-first 로 새 컨테이너를 먼저 띄운 뒤 옛 컨테이너를 내리는 롤링 업데이트도 가능합니다. compose 파일의 deploy.update_config.order: start-first 로도 같은 설정이 됩니다. 다만 필자가 이 글의 환경에서 두 방식을 다시 돌려 비교해 본 것은 아니어서, 어느 쪽이 롤백이 편한지는 확인하지 못했습니다.

정리하면 이 글의 골격(gradle 빌드, 이미지 태깅, nginx 라운드로빈, blue/green 배포)은 지금도 같은 과제에 쓸 수 있고, 바뀐 곳은 Java 기준과 compose 문법, 헬스체크 방식입니다.

AI 도구로 초안을 만들고 직접 실행·검증한 내용입니다.

함께 보면 좋은 글

이 글을 쓴 사람

인프라와 DevOps를 실무로 다루면서 겪은 것을 기록합니다. Docker, Kubernetes, AWS, 그리고 AI 도구를 실제로 써 보고 남기는 로그입니다.

Threads·X

새 글이 올라오면 Threads @wonizz.ai 에도 올립니다. 팔로우해 두면 피드에서 바로 볼 수 있습니다.

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다