TIL

5.1(1) 도커 컴포즈 설치와 야믈 코드

도커 컴포즈는 공통성을 갖는 컨테이너 애플리케이션 스택을 YAML 코드로 정의하는 정의서이며 그것을 실행하기 위한 다중 컨테이너 실행 도구다.

• 공통의 목적을 갖는 애플리케이션 스택(웹 서버, WAS, DB)을 도커 컴포즈 야믈 코드로 정의해 한 번에 서비스를 올리고 관리할 수 있는 도구
• 실행된 컨테이너는 독립된 기능을 가진다.
• 공통 네트워크로 구성되어 컨테이너 간 통신이 쉽다
• 공통성 있는 컨테이너들을 포함하여 쉽고 빠른 런타임 환경 제공
• 테스트, 개발, 운영 등에서 구성 가능한 오케스트레이션 도구 중 하나이나 다양한 관리 기능을 갖고 있진 않다.
  • 도커 스웜이나 쿠버네티스 같은 오케스트레이션 도구를 사용하는 것을 권장

5.1.1 도커 컴포즈 설치

Ubuntu 리눅스 기반으로 도커 컴포즈 설치

# 깃허브에 저장된 현재 호스트 운영체제에 맞는 최신 버전 도커 컴포즈 파일 설치
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose

# 실행 권한 설정 및 절대 경로 문제로 발생하는 오류 대비를 위한 심벌릭 링크 설정
$ sudo chmod +x /usr/local/bin/docker-compose
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# kevin 사용자 계정에 소유권 지정
$ sudo chown kevin /usr/bin/docker-compose

# 버전 변경을 위한 재설치 및 삭제 시 원본과 링크 파일 삭제
$ sudo rm /usr/local/bin/docker-compose
$ sudo rm /usr/bin/docker-compose

5.1.2 도커 컴포즈 야믈 코드 작성

• 도커 컴포즈에 사용되는 야믈 코드는 docker-compose.yaml (또는 .yml) 파일로 작성한다.
  • 프로젝트 최상위 디렉터리에 위치해야 한다.

version: "3.8"
services:
  서비스명1:
    # 애플리케이션 설정값 정의1
  서비스명2:
    # 애플리케이션 설정값 정의2
...
networks:
  # 네트워크 설정, 미지정 시 자동 생성
volumes:
  # 볼륨 생성

• 도커 컴포즈 야믈은 위에서 아래로 처리되는 직렬 구조다.
  • 설계상 가장 먼저 실행되어야 하는 애플리케이션을 작성하고 이와 의존성을 갖는 DB 및 하위 애플리케이션을 작성한다.
  • 그 다음 전체 애플리케이션에 필요한 네트워크, 볼륨, 캐시 등을 설정할 수 있다.

단계별 작성 방법 1. 버전 정의

• 야믈 코드 첫 줄은 버전을 명시한다.
  • version: ‘3.8’
• 버전에 따라 약간씩 기능과 옵션에 차이가 있다.
• 도커 버전 및 컴포즈 버전 업데이트는 속도가 잦은 편이니 종종 도커 도큐먼트를 참고하여 버전 변화를 참고하기 바란다.
• 버전이 맞지 않으면 에러가 발생하기도 한다.
  • ERROR: version in “./docker-compose.yml” is unsupported
  • 작성한 버전과 현재 도커 컴포즈 또는 도커 엔진 릴리즈가 적합하지 않은 경우
  • 도커 컴포즈 도구가 오래된 경우 (새 버전으로 업데이트 필요)
  • 버전 문제가 아닌 들여쓰기의 공백 수가 하위 레벨과 맞지 않은 경우

2. 서비스 정의

• 도커 컴포즈는 컨테이너 대신 서비스 개념을 사용한다.
• 상위의 version 명령과 동일 레벨로 작성된다.

version: '3.8'
services: 
  myweb:
    image: nginx:latest
  mydb:
    image: mariadb:10.4.6

• 도커 허브에서 제공하는 오피셜 이미지를 사용하는 경우에는 위와 같이 작성한다.
• 프로젝트에 필요한 애플리케이션을 Dockerfile을 작성하여 컨테이너로 실행하는 경우
  • 미리 빌드에서 이미지명:태그를 명시할 수 있다.
  • 또는 build 옵션을 사용하면 도커 컴포즈 실행과 함께 이미지가 빌드된다.

    version: '3.8'
    services:
      web:
        # build 옵션에서 이미지 빌드에 필요한 Dockerfile 경로를 지정
        # docker-compose.yml과 동일 경로라면 '.'을 이용
        build: .
  

  • Dockerfile 위치와 파일명이 모두 다른 경우엔 아래와 같이 하면 된다.

    services:
      web:
        build:
          context: .
          dockerfile: ./compose/pyfla/Dockerfile-py
  

• services 하위 옵션으로 build와 함께 해당 서비스에 필요한 옵션을 명시할 수 있다.
  • container_name: 컨테이너 이름, 생략 시 자동 부여
  • ports: 서비스 내부 포트와 외부 호스트 포트 지정하여 바인드, docker run -p 옵션과 동일
  • expose: 호스트 OS와 직접 연결하는 포트를 구성하지 않고 서비스 포트를 노출.
  • networks: 최상위 레벨의 networks에 정의된 네트워크 이름을 작성
  • volumes: 서비스 내부 디렉터리와 호스트 디렉터리를 연결하여 데이터 지속성 설정
  • environment: 서비스 내부 환경 변수 설정
    • 환경 변수가 많은 경우엔 .env파일로 만들어 env_file 옵션에 파일명을 지정
  • command: 서비스 구동 이후 실행할 명령어 작성
  • restart: 서비스 재시작 옵션 지정
  • depends_on: 서비스 간 종속성을 의미하며 서비스 시작 순서 지정

3. 네트워크 정의

• 다중 컨테이너들이 사용할 최상위 네트워크 키를 정의
  • 이하 하위 서비스 단위로 이 네트워크를 선택할 수 있다.
• 아무런 옵션을 정의하지 않으면 자체 기본 네트워크 자동 생성
• 최상위 레벨에 networks 지정 시 대역은 172.x.x.x로 자동 할당
  • 기본 드라이버는 브리지로 지정
• 도커에서 생성한 기본 네트워크를 지정하는 경우 externel 옵션에 네트워크 이름을 작성한다.

4. 볼륨 정의

• 데이터 지속성을 유지하기 위해 최상위 레벨에 볼륨을 정의
• 서비스 레벨에서 볼륨명과 서비스 내부 디렉터리를 바인드

version: '3.8'
services:
  mydb:
    image: mysql:5.7
    container_name: mysql_app
    volumes:
      - db_data:/var/lib/mysql

  myweb:
    depends_on:
      - mydb
    image: wordpress:latest
    container_name: wordpress_app
    volumes:
      - web_data:/var/www/html
...
volumes:
  db_data: {}
  web_data: {}
# {} 생략 가능, 도커가 관리하는 볼륨 생성을 의미

5. 도커 명령어와 도커 컴포즈 야믈 코드 비교

| 요구사항 | 도커 명령 | 도커 컴포즈 옵션 | | — | — | — | | 컨테이너명 | —name | container_name; | | 포트 연결 | -p | ports: | | 네트워크 구성 | —net | networks: | | 재시작 | —restart | restart: | | 볼륨 | -v(—volume) | volumnes: | | 환경 변수 | -e | environment: | | 컨테이너 간 연결 | —link 컨테이너명:서비스명 | depends_on | | 이미지 | 이미지명 | image; |

• 도커 컴포즈는 관련 애플리케이션 야믈 코드 파일로 한 번에 구성하여 내부 환경 구성과 속성을 정의할 수 있다.
• 도커 컴포즈는 설정 값을 캐싱하기에 재시작 시 변경이 없다면 캐싱된 정보로 빠른 서비스 실행을 보장할 수 있다.
• 야믈 코드에 포함된 애플리케이션은 동일 네트워크에 포함되기에 복잡한 연결 구성 없이 API 통신이 가능하다.

도커 컴포즈는 개발 및 테스트 단계에 적합한 오케스트레이션 도구이다. 실제 운영에서는 관리적 요소가 많이 필요하기에 고급 오케스트레이션 기능을 사용하려면 쿠버네티스나 도커 스웜을 이용해야 한다.