개발 일상 | 백엔드 김승원의 실무 노트

들어가며"제 로컬에서는 잘 되는데요." 개발자라면 한 번은 들어봤거나 직접 했을 말입니다. PostgreSQL 버전이 다르고, Redis가 설치되어 있지 않고, Kafka 설정이 미묘하게 다릅니다. 새로운 팀원이 합류하면 개발 환경 구축에만 하루 이상을 소비합니다. 이 모든 문제의 해답은 Docker Compose입니다.docker compose up 한 줄이면 Spring Boot 앱이 필요로 하는 모든 인프라가 동일한 환경으로 구동됩니다. 이 글에서는 PostgreSQL, Redis, Kafka, Prometheus, Grafana까지 포함한 풀스택 개발 환경을 docker-compose.yml 하나로 구성하는 방법과, Spring Boot 3.1+의 Docker Compose 자동 인식 기능, 그리..

들어가며통합 테스트에서 가장 골치 아픈 문제는 외부 의존성 관리입니다. "내 로컬에서는 되는데 CI에서 안 돼요"라는 말을 몇 번이나 들어보셨나요? H2 같은 인메모리 DB로 테스트하면 실제 PostgreSQL과 동작이 달라 운영 환경에서 버그가 발생하기도 합니다. Testcontainers는 Docker 컨테이너를 프로그래밍 방식으로 띄워 Docker 실전 가이드로 컨테이너 기초 익히기 실제 인프라와 동일한 환경에서 통합 테스트를 실행할 수 있게 해주는 라이브러리입니다. 이번 글에서는 Testcontainers의 핵심 개념부터 실전 활용법, CI/CD 연동까지 다루겠습니다.1. Testcontainers 핵심 개념Testcontainers는 JUnit 5 테스트 실행 시 Docker 컨테이너를 자동으로..

들어가며현대 소프트웨어 개발에서 CI/CD(Continuous Integration / Continuous Deployment)는 선택이 아닌 필수입니다. 코드를 푸시할 때마다 자동으로 빌드, 테스트, 배포가 이루어지면 개발 생산성이 비약적으로 향상됩니다. 이번 글에서는 GitHub Actions를 활용하여 Spring Boot 프로젝트의 CI/CD 파이프라인을 처음부터 끝까지 구축하는 방법을 다룹니다.1. GitHub Actions 기본 개념GitHub Actions는 GitHub에서 제공하는 CI/CD 플랫폼으로, 리포지토리 내의 .github/workflows/ 디렉토리에 YAML 파일을 작성하여 워크플로우를 정의합니다. 핵심 구성 요소는 다음과 같습니다.Workflow: 자동화된 전체 프로세스. ..

들어가며Docker는 애플리케이션을 컨테이너로 패키징하여 어디서든 동일한 환경으로 실행할 수 있게 해주는 도구입니다. "내 컴퓨터에서는 되는데"라는 문제를 근본적으로 해결합니다. 이 글에서는 Spring Boot 애플리케이션을 Docker로 컨테이너화하는 전 과정을 다룹니다. 기본적인 Dockerfile 작성부터 멀티스테이지 빌드, 이미지 최적화, docker-compose를 활용한 실전 구성까지 단계별로 알아봅시다.1. 기본 Dockerfile 작성먼저 가장 단순한 형태의 Dockerfile부터 시작합니다.# 기본 Dockerfile (최적화 전)FROM openjdk:21-jdk-slimWORKDIR /app# JAR 파일 복사COPY build/libs/myapp-0.0.1-SNAPSHOT.jar ..