[Docker 강의 13편] 도커로 개발 환경 설정하기

 

안녕하세요 펭귄교수입니다.

 

이번 포스팅에서는 도커로 개발 환경을 설정하는 방법에 대해 알아보겠습니다.

---

1. 도커로 개발 환경을 설정해야 하는 이유

개발자는 다양한 이유로 도커를 통해 개발 환경을 설정하게 됩니다. 그 중 대표적인 이유는 다음과 같습니다:

• 일관된 환경 제공: 도커는 컨테이너 내에서 애플리케이션을 실행하기 때문에, 호스트 환경에 관계없이 동일한 환경에서 실행이 가능합니다.
• 의존성 관리: 도커 이미지는 프로젝트의 모든 의존성을 포함할 수 있어, 다른 개발자가 쉽게 동일한 환경에서 개발을 시작할 수 있습니다.
• 빠른 환경 재구축: 도커 컨테이너는 변경된 환경을 쉽게 재구축할 수 있어, 환경 설정에 드는 시간을 크게 절약할 수 있습니다.
• 다양한 언어와 플랫폼 지원: 도커는 여러 프로그래밍 언어나 플랫폼을 지원하므로, 다양한 개발 환경을 빠르게 구성할 수 있습니다.

---

2. 도커로 개발 환경을 구성하는 방법

도커를 사용한 개발 환경 설정은 크게 두 가지로 나눌 수 있습니다. Dockerfile을 사용하여 컨테이너를 직접 만들거나, Docker Compose를 사용하여 여러 컨테이너를 구성하는 방법입니다.

2-1. Dockerfile을 이용한 개발 환경 설정

먼저, Dockerfile을 사용하여 단일 개발 환경을 설정할 수 있습니다. Dockerfile은 컨테이너 이미지를 만들기 위한 명세서로, 애플리케이션 실행에 필요한 모든 의존성을 정의합니다.

예시로, Node.js 애플리케이션을 개발하기 위한 Dockerfile을 작성해보겠습니다.

# Node.js를 기반으로 하는 이미지 사용
FROM node:16

# 작업 디렉토리 설정
WORKDIR /usr/src/app

# 의존성 파일 복사
COPY package*.json ./

# 의존성 설치
RUN npm install

# 소스 코드 복사
COPY . .

# 애플리케이션 실행
CMD ["npm", "start"]

위 Dockerfile은 Node.js 기반의 개발 환경을 설정하며, 애플리케이션 실행에 필요한 의존성 설치와 실행까지 포함하고 있습니다. 이를 통해 다른 개발자는 쉽게 동일한 환경에서 프로젝트를 실행할 수 있습니다.

2-2. Docker Compose를 이용한 다중 개발 환경 설정

복잡한 애플리케이션에서는 여러 서비스가 동시에 필요할 수 있습니다. 예를 들어, 백엔드 서버와 데이터베이스, 프론트엔드가 분리된 경우 Docker Compose를 사용하면 각 서비스를 별도의 컨테이너로 구성할 수 있습니다.

version: '3'
services:
  app:
    image: node:16
    volumes:
      - .:/usr/src/app
    working_dir: /usr/src/app
    ports:
      - "3000:3000"
    command: npm start

  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: example
    ports:
      - "3306:3306"

위 docker-compose.yml 파일은 Node.js 애플리케이션과 MySQL 데이터베이스를 동시에 실행하는 개발 환경을 설정합니다. 이렇게 여러 컨테이너를 사용하는 방법은 복잡한 애플리케이션의 개발 환경을 구성할 때 유용합니다.

---

3. 도커 볼륨(Volume)으로 코드 변경 반영

개발 중에는 코드가 변경될 때마다 도커 컨테이너를 다시 빌드하는 것이 비효율적일 수 있습니다. 이를 해결하기 위해 도커에서는 볼륨(Volume) 기능을 제공합니다. 볼륨을 사용하면 호스트 시스템의 파일을 도커 컨테이너에 마운트하여 실시간으로 파일 변경 사항이 반영되도록 할 수 있습니다.

예를 들어, 다음과 같이 docker run 명령어를 사용하여 호스트의 디렉토리를 컨테이너에 마운트할 수 있습니다:

docker run -d -p 3000:3000 -v $(pwd):/usr/src/app node:16

이 명령어는 현재 디렉토리($(pwd))를 컨테이너의 /usr/src/app 디렉토리에 마운트하여, 코드 변경 시 도커 컨테이너에서 즉시 반영될 수 있도록 합니다.

---

4. 도커로 다양한 언어 환경 설정하기

도커는 여러 프로그래밍 언어와 프레임워크를 지원합니다. 각 언어에 맞는 도커 이미지를 사용하면 쉽게 개발 환경을 설정할 수 있습니다.

4-1. Python 환경 설정

FROM python:3.9

WORKDIR /usr/src/app

COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "./app.py"]

4-2. Java 환경 설정

FROM openjdk:11

WORKDIR /usr/src/app

COPY . .

CMD ["java", "-jar", "app.jar"]

도커를 사용하면 언어별로 필요한 환경 설정을 빠르게 할 수 있으며, 각기 다른 언어와 기술 스택을 사용하는 프로젝트도 문제없이 관리할 수 있습니다.

---

5. 환경 변수 관리

개발 환경을 설정할 때, 민감한 정보나 환경에 따라 달라지는 설정 값들은 환경 변수로 관리하는 것이 좋습니다. 도커에서는 docker run 명령어에서 -e 옵션을 사용하거나 Docker Compose에서 environment 섹션을 사용하여 환경 변수를 쉽게 설정할 수 있습니다.

5-1. Docker run에서 환경 변수 설정

docker run -e "ENV=development" -e "DB_HOST=localhost" myapp

5-2. Docker Compose에서 환경 변수 설정

version: '3'
services:
  app:
    image: node:16
    environment:
      - ENV=development
      - DB_HOST=localhost

이와 같은 방법으로, 환경 변수는 코드에 하드코딩하지 않고 외부에서 설정 가능하며, 보안성을 높이고 관리 효율성을 높일 수 있습니다.

---

6. 실제 개발 환경에서의 도커 사용 사례

도커를 활용한 개발 환경 설정은 다양한 산업에서 이미 보편화되어 있으며, 개발자들이 효율적으로 프로젝트를 진행할 수 있게 도와줍니다. 몇 가지 대표적인 사용 사례를 살펴보겠습니다.

6-1. 협업 프로젝트에서 도커 사용

도커를 사용하면 여러 개발자가 동일한 개발 환경에서 작업할 수 있습니다. 도커 이미지를 통해 프로젝트에서 필요한 모든 의존성과 환경 설정을 공유할 수 있으며, 이를 통해 개발 환경을 통일시켜 협업의 효율성을 크게 높일 수 있습니다.

6-2. CI/CD 파이프라인에서 도커 사용

도커는 CI/CD 파이프라인에서도 자주 사용됩니다. 빌드, 테스트, 배포 단계에서 도커 이미지를 사용하면 일관된 환경에서 애플리케이션을 빌드하고 테스트할 수 있어 오류 발생 가능성을 줄일 수 있습니다.

---

7. 마무리

이번 포스팅에서는 도커를 사용해 개발 환경을 설정하는 방법을 알아보았습니다. 도커는 개발자가 필요한 환경을 쉽고 빠르게 구성할 수 있도록 도와주며, 일관된 개발 환경을 제공함으로써 협업 효율성을 높입니다.

 

또한, 도커 Compose를 활용하면 복잡한 애플리케이션에서도 각기 다른 서비스를 독립적으로 실행할 수 있어, 프로젝트의 확장성과 관리 용이성을 높일 수 있습니다.