Docker 기반의 개발 환경 구성 실전기

개요

현대 소프트웨어 개발에서 개발 환경의 일관성과 재현성은 매우 중요합니다. 다양한 운영체제, 라이브러리 버전 충돌 문제를 해결하고, 팀 단위 개발 시 환경 차이로 인한 이슈를 최소화하기 위해 Docker 같은 컨테이너 기술이 널리 사용되고 있습니다. 이번 글에서는 Docker를 이용해 개발 환경을 구축하는 방법을 단계별로 살펴보고, Java 애플리케이션 개발 환경을 구성하는 예제를 통해 실전에서 어떻게 활용할 수 있는지 자세히 설명합니다.

---

1. Docker란?

Docker는 가상 머신과는 달리 호스트 OS 위에서 격리된 컨테이너를 실행하는 경량화된 기술입니다. 각 컨테이너는 필요한 라이브러리와 애플리케이션만 포함하며, 빠른 실행과 적은 리소스 소비가 장점입니다. 이를 통해 개발자는 여러 환경을 손쉽게 전환하고 배포할 수 있습니다.

2. Docker 설치 및 기본 명령어

2.1 설치

• Windows, macOS: Docker Desktop 설치
• Linux: 각 배포판 별 Docker 엔진 설치

2.2 주요 명령어

• docker run : 컨테이너 실행
• docker ps : 실행 중인 컨테이너 확인
• docker images : 로컬 이미지 목록 확인
• docker build : Dockerfile을 빌드하여 이미지 생성

---

3. 개발 환경 구성 방법

3.1 Dockerfile 작성

Dockerfile은 환경을 정의하는 스크립트로, BASE 이미지부터 필요한 패키지 설치, 설정 파일 복사, 앱 빌드 및 실행 방법을 기술합니다.

예시: Java 개발 환경을 위한 Dockerfile

FROM openjdk:17-jdk-slim

# 작업 디렉토리 생성
WORKDIR /app

# 의존성 설치(예: Maven)
RUN apt-get update && apt-get install -y maven

# 소스코드 복사
COPY . /app

# Maven 빌드
RUN mvn clean package

# 애플리케이션 실행
CMD [""java"", ""-jar"", ""target/myapp.jar""]

3.2 Docker Compose 활용하기

복잡한 개발환경에서 DB, 캐시 등 여러 서비스를 함께 구동해야 할 때 편리합니다.

docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: devdb
    ports:
      - "3306:3306"

---

4. Java 프로젝트 예제

4.1 간단한 Spring Boot 프로젝트 Docker화

1. Spring Boot 프로젝트 생성
2. Dockerfile 작성
3. 이미지 빌드 및 실행

4.2 예제 코드 (Java)

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

@RestController
class HelloController {
    @GetMapping("/")
    public String hello() {
        return "Hello, Docker!";
    }
}

4.3 Dockerfile

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

4.4 빌드 및 실행 명령

docker build -t demo-app .
docker run -p 8080:8080 demo-app

---

5. 개발 생산성 향상을 위한 팁

• 볼륨 마운트: 소스코드를 컨테이너에 바로 반영하기 위해 -v 옵션 활용
• 환경 변수 관리: .env 파일로 구성 관리
• 디버깅: 컨테이너 내 쉘 접속으로 빠른 문제 해결 (docker exec -it <container> /bin/bash)

---

6. 결론

Docker를 활용하면 개발 환경 차이로 인한 문제를 획기적으로 줄일 수 있으며, 팀원간의 협업 생산성을 크게 향상시킬 수 있습니다. Java를 포함한 다양한 언어 및 프레임워크 환경 구축에 유연하게 대응할 수 있으므로, 현대 개발 환경에 필수적인 도구로 자리잡고 있습니다.

본 가이드를 따라 차근차근 환경을 구축해보고, 본인의 프로젝트에 맞는 최적화 기법을 계속 적용해 나가시길 바랍니다.

---

참고 자료

• Docker 공식 문서
• Spring Boot 공식 문서