콘텐츠로 이동

애플리케이션과 컨테이너 구성

도커 스터디 - 처음부터 제대로 배우는 도커/쿠버네티스 컨테이너 개발과 운영 ch. 3

created: 2026.2.3 last updated: 2026.2.24


정기적으로 잡을 실행하는 애플리케이션

  • 크론cron 사용

방법

  1. 잡 컨테이너에 실행 API를 준비하고 크론 컨테이너에서 컨테이너 간 통신으로 API 호출
  2. 크론 컨테이너에 도커를 구축하고 잡 컨테이너 실행

-> 완전 복잡하다!

FROM ubuntu:24.04

RUN apt update
RUN apt install -y cron

COPY task.sh /usr/local/bin/
COPY cron-example /etc/cron.d/
RUN chmod 0644 /etc/cron.d/cron-example

CMD ["cron", "-f"]
  • ubuntu 23.10은 지원이 종료되어 24.04 사용
  • 하나의 컨테이너 = 하나의 프로세스 방식보다 하나의 컨테이너로 여러 프로세스를 실행

하나의 컨테이너에 하나의 관심사

Each container should have only one concern

  • 하나의 관심사: 하나의 컨테이너가 하나의 역할과 문제영역(도메인)에만 집중해야 한다
  • 상세한 역할을 재정의하여 단순한 구성으로
    • 1분 간격으로 잡 트리거를 실행하는 크론, Hello!를 출력하는 잡 -> 1분마다 Hello!를 출력한다 => 단순화

컨테이너의 이식성portability

  • 컨테이너는 애플리케이션과 파일 시스템을 컨테이너라는 단위로 분리
  • 동일한 동작을 기대할 수 있는 재현성
  • OS나 서버 환경에 관계없이 동작
  • 호스트 OS와 커널의 리소스 공유 -> 특정 CPU 아키텍처나 OS를 전제로 성립
  • 멀티 아키텍처에 대응하는 컨테이너 이미지 빌드 중요
  • BuildKit: 멀티 플랫폼에 대응하는 컨테이너 이미지를 간단하게 빌드 가능
정적 링크static link 동적 링크dynamic link
빌드 시 바이너리에 라이브러리를 링크 실행 시 라이브러리를 링크
바이너리 사이즈가 커지기 쉬움. 라이선스 문제 발생 가능성 바이너리 사이즈가 작지만 OS에 필요한 라이브러리가 없으면 실행이 불가
  • CIcontinuous integration를 사용해 애플리케이션을 테스트하고 컨테이너 이미지를 패키징하는 경우
  • CI 서버에서 glibc 라이브러리를 쓰고, 컨테이너가 musl 라이브러리를 사용하면 동작하지 않을 수 있다.
  • 라이브러리를 정적 링크로 사용하거나 실행 플랫폼에 glibc를 설치하여 사용(실행 환경과 빌드 환경 동일하게)
  • Multi-stage builds: 도커에서 제공하는 빌드용 컨테이너와 실행용 컨테이너를 분리하여 안정적인 이식성 보장해주는 기능

컨테이너 친화 애플리케이션

  • 설정 파일을 포함하여 이미지 빌드하기
  • 컨테이너 외부의 설정 파일 사용하기
    • 커맨드 라인 인수로 값 전달하기
      version: "3.9"
      services:
        api:
          build: .
          command:
            - server
            - --port=8080
            - --log-level=warn
            - --debug-mode=true
      
    • 환경 변수로 값 전달하기
      version: "3.9"
      services:
        api:
          build: .
          command:
            - server
          environment:
            PORT: 8080
            LOG_LEVEL: warn
            DEBUG: true
      
      • 설정 파일 전달하기
          version: "3.9"
          services:
            api:
              build: .
              command:
                - server
                # 호스트에서 컨테이너로 전달되는 설정 파일 경로 지정
                - config-file=/var/lib/server/conf/dev.yaml
              volumes:
                # [호스트 경로]:[컨테이너 경로]
                - ./conf:/var/lib/server/conf
        

보안 정보를 다루는 방법

  • 비밀번호를 컨테이너에서 다루는 상황
    • 예) MySQL 실행할 때 root 유저의 비밀번호를 환경 변수로 설정
  • 버전 관리 시스템에서 컨테이너내에서 사용하는 보안 정보를 코드로 작성하는 건 보안 위험
  • 시크릿secret 구조: 컨테이너 외부에서 보안 정보를 최대한 안전하게 전달하기 위한 구조
    version: "3.9"
    
    services:
      mysql:
        container_name: book_mysql
        image: mysql:8.0.33
        environment:
          MYSQL_ROOT_PASSWORD_FILE: /run/secrets/mysql_root_password ## 1
          MYSQL_DATABASE: test
        secrets: ## 2
          - mysql_root_password
    
    secrets: ## 3
      mysql_root_password: ## 임의의 시크릿명
        file: ./mysql_root_password
    
  • secrets은 컨테이너 외부의 파일 시스템(호스트 환경)에서 보안 정보를 조회 가능
  • 보안 정보 파일만 버전 관리 대상에서 제외
  • 환경 변수 사용 추천

영속성 데이터 사용

  • 컨테이너가 실행되는 동안 기록되는 파일은 호스트에 파일과 디렉터리를 마운트하지 않는 한 컨테이너를 파기할 때 함께 제거
  • Data Volume: 컨테이너 내부의 디렉터리를 호스트 공간에 저장하기 위한 구조, 호스트와 컨테이너 간 디렉터리의 공유와 재사용 가능
docker container run [options] -v 호스트 디렉터리:컨테이너 디렉터리 리포지터리명[:태그] [커맨드] [커맨드 인수]
docker container run -v ${PWD}:/var/local/ch03 -it ubuntu:23.10 bash
  • -v옵션으로 Data Volume 설정
  • /var/local/ch03 -> 환경 변수 ${PWD}로 표현(호스트의 현재 디렉터리)

  • Data Volume 컨테이너: 컨테이너 간 디렉터리 공유 -> 데이터만을 위한 컨테이너

    • 호스트의 특정 디렉터리에 의존