🐳about Docker Compose / 사용법 및 파이썬 코드로 실습

📂Docker Compose란?

맨들맨들 귀엽다ㅎ

단일 서버에서 여러개의 컨테이너를 하나의 서비스로 정의해 컨테이너의 묶음으로 관리할 수 있는 작업 환경을 제공하는 도구

• YAML 파일을 통해 어플리케이션 서비스 구성 가능(docker-compose.yml)
• 기본적으로 3 STEP Dockerfile 정의→ docker-compose.yml 파일 생성→ docker-compose up 명령어의 실행(compose 시작, 전체 앱 실행
• 여러 개의 컵테이너의 옵션과 환경을 정의한 파일을 읽어 컨테이너를 순차적으로 생성
• 특정 서비스를 수행하는 컨테이너의 개수를 늘리거나 줄이거나 → 쿠버네테스에서 자동화(데브옵스 CI CD 로 가기위해 인간의 개입 줄이고자)
• plus 컨테이너들을 compose하면 도커가 logical한 하나의 네트워크로 묶어버림. 도커 compose로 컨테이너 이미지를 묶어버리면 IP 주소 상관없이 도메인 네임을 쓰듯이 자체적으로 네트워크로 묶고 도메인 네임 서버를 만들고 도메인 네임을 부여. 네트워킹에 대하여 독립적인 서비스를 구성할 수 있다는 것이 큰 장점.(개발자 입장에서
  

---

📂Docker Service

• distributed 어플리케이션에서 하나의 어플리케이션은 여러 개의 서비스로 나뉨.

ex) 동영상 공유 사이트 ⇒ 애플리케이션 데이터를 데이터베이스에 storing하는 서비스, 사용자가 무언가를 업로드 한 후 백그라운드에서 비디오 trascoding을 위한 서비스, front-end 서비스.. 등등.

• 서비스는 하나의 이미지만 실행하는 “생산중인 컨테이너”에 불과하다. 서비스는 하나의 이미지만 실행. 하지만 이미지가 실행하는 방식을 코드화함. →
  • 사용하는 포트, 서비스가 필요로하는 용량에 따라 얼마나 많은 컨테이너의 replica가 실행되어야 하는가 등
• 서비스를 조정하면 해당 소프트웨어를 실행하는 컨테이너 수가 변경됨.
  • 프로세스에서 서비스에 더 많은 computing resource를 할당

Docker compose가 필요한 이유

• 여러 개의 컨테이너가 하나의 어플리케이션으로 동작하는 경우 여러 개의 컨테이너를 하나의 서비스로 정의해 컨테이너 묶음으로 관리하기 위함이다.
• docker compose를 사용하지 않으면 컨테이너를 각각 하나씩 생성해야함(두 개의 run 명령어 입력) ⇒ docker-compose로 한 번에 생성

---

📂Docker compose file(Docker-compose.yml) 구성

version: "3"

services:
  app:
    build:
      context: ./01_FLASK_DOCKER
      dockerfile: Dockerfile
    links:
      - "db:mysqldb"
    ports:
      - "80:8080"
    container_name: appcontainer
    depends_on:
      - db
  db:
    image: mysql:5.7
    restart: always
    volumes:
      - ./mysqldata:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=dgkcoding
      - MYSQL_DATABASE=dgkdb
    ports:
      - "3306:3306"
    container_name: dbcontainer

• version: docker-compose의 버전 명시/ 버전에 따라 지원 형식이 다름.
• services: docker-compose를 통해 관리할 컨테이너(이미지) → 하위 항목으로 이름 명시

service 내부 카테고리

• volumes: 마운트할 볼륨 설정
• build: 빌드 옵션. 도커 이미지를 dockerfile기반으로 생성할 때 사용
• restart: docker container가 다운되었을 경우 항상 재시작하도록 하는 설정
• image: 이미지 이름 지정
• ports: 포트 맵핑 정보 명시
• networks: docker container간의 네트워크 분리를 위한 추가 설정(설정하지 않으면 자동으로 컨테이너간 같은 네트워크 설정됨)
• links: docker container 내부에서 다른 컨테이너에 접속하고 싶을 때
• container_name: 컨테이너 이름 설정
• depends_on: 컨테이너가 실행되는 순서를 제어depends_on 뒤에 있는 db 컨테이너가 우선 실행되고 이후 app 컨테이너가 실행됨

---

📂Docker compose 주요 명령어

docker-compose [명령어]

서브명령	설명
up	컨테이너 생성/시작
ps/ ls	컨테이너 목록 표시
logs	컨테이너 로그 출력
run	컨테이너 실행
start	컨테이너 시작
stop	컨테이너 정지
restart	컨테이너 재시작
pause	컨테이너 일시 정지
unpause	컨테이너 재개
port	공개 포트 표시
config	docker-compose.yml 파일 구성 확인
kill	실행 중인 컨테이너 강제 정지
rm	컨테이너 삭제
down	리소스 삭제

📂Docker compose 설치&사용해보기

크게 3단계

(1) 각각의 컨테이너의 Dockerfile를 작성

(2) docker-compose.yml를 작성하고, 각각 독립된 컨테이너의 실행 정의를 실시

(3) "docker-compose up" 커맨드를 실행하여 docker-compose.yml으로 정의한 컨테이너를 개시

설치 및 버전 확인

본인은 docker desktop으로 깔았기 때문에 이미 docker compose 포함되어 설치되어 있음.

(리눅스는 Docker compose를 따로 설치해야)

$ curl -SL https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

폴더 구성

Dockerfile을 통해 이미지 정의

DokerCompose 디렉터리의 client, server 폴더에 각각 client.py, server.py와 Dockerfile작성

**client.py 코드**

#!/usr/bin/env python3

# python 시스템 라이브러리 import
# 서버에서 'index.html'을 다운받기 위한 라이브러리
# 파이썬과 함께 설치되어 있기 때문에 따로 추가적으로 설치할 것은 x
import urllib.request

# 'http://localhost:1234/'에 대한 request를 포함하는 변수 fp
# localhost: 서버가 local 서버
# 1234: 서버의 port 주소
fp = urllib.request.urlopen("http://localhost:1234/")

# 'encodedContent' 인코딩된 server response ('index.html').
# 'decodedContent' 디코딩된 server response (what we want to display).
encodedContent = fp.read()
decodedContent = encodedContent.decode("utf8")

# server file: 'index.html'출력
print(decodedContent)

# server 연결 close
fp.close()

client image의 Dockerfile

FROM python:latest
LABEL mantainer="leeeunda"

#clent 폴더에 실행할 파일 설정
ADD client.py /client/

#작업할 디렉터리 설정.
WORKDIR /client/

따로 명령어로 이미지 빌드할 필요없이 이후에 docker-compose build 명령어로 컨테이너 및 이미지 한 번에 생성할 것

**server.py 코드**

#!/usr/bin/env python3

# python 시스템 라이브러리 import
# 서버에서 'index.html'을 다운받기 위한 라이브러리
# 파이썬과 함께 설치되어 있기 때문에 따로 추가적으로 설치할 것은 x
import http.server
import socketserver

#서버에서 client의 요청을 처리하는 변수
handler = http.server.SimpleHTTPRequestHandler

# port 1234에서 server를 시작하도록 정의

with socketserver.TCPServer(("", 1234), handler) as httpd:
    # client의 요청을 기다리면서 서버를 계속 실해앟도록 하는 명령
    httpd.serve_foreve# FROM : base image 설정
# Dockerhub에서 python image import
# 이미지 이름 -> python, version-> latest 
FROM python:latest
LABEL mantainer="daun0219@gmail.com"

# 첫번째 파라미터는 host 위 파일의 이름  
# 두번째 파라미터는 이미지에 넣을 파일의 경로
# python code 실행하기 위해 server.py 파일과 index.html 파일 import
ADD server.py /server/
ADD index.html /server/

#작업할 폴더 설정 명령어가 실행되는 위치.
WORKDIR /server/r()

server image의 Dockerfile

#!/usr/bin/env python3

# python 시스템 라이브러리 import
# 서버에서 'index.html'을 다운받기 위한 라이브러리
# 파이썬과 함께 설치되어 있기 때문에 따로 추가적으로 설치할 것은 x
import http.server
import socketserver

#서버에서 client의 요청을 처리하는 변수
handler = http.server.SimpleHTTPRequestHandler

# port 1234에서 server를 시작하도록 정의

with socketserver.TCPServer(("", 1234), handler) as httpd:
    # client의 요청을 기다리면서 서버를 계속 실해앟도록 하는 명령
    httpd.serve_forever()

index.html 파일 안에는 간단하게 hello docker-compose.. 뭐 이런거 적음

브라우저를 통해 local host의 1234번 포트에서 접속 가능한 것 확인

docker-compose.yml 파일 만들기

# docker-compose는 항상 version tag로 시작
# 최근 버전인 "3"을 사용
version: "3"

# 1 service = 1 container
# 'services'로 서비스 생성 
services:
  # server와 client 두 가지 service를 생성

  # 첫번째 service(container): server 정의
  server:
    # build : 이미지를 만드는 데 사용할 dockerfile의 경로 지정.
    # service를 실행하는 역할.
    build: ./server/
    #server의 image 이름 정의
    image: leeeunda/server:1.0

    # 이미지가 생성되면 한 번 실행되는 명령어
    # python ./server.py를 실행
    command: python ./server.py

    # server.py에서 port를 1234로 지정
    # 컨테이너 외부에서 서버에 액세스 하기 위함
    #[컴퓨터에서 원하는 포트]:[컨테이너에서 검색하려는 포트]
    ports:
      - 1234:1234

  # 두번째 service(container): client 정의
  client:
    build: ./client/
    #client의 image 정의
    image: leeeunda/client:1.0
    
    # build : 이미지를 만드는 데 사용할 dockerfile의 경로 지정.
    # service를 실행하는 역할.
    command: python ./client.py

    #네트워크 유형을 정의
    #컨테이너가 컴퓨터의 'localhost'에 액세스할 수 있음을 정의
    network_mode: host

    # depends_on : 서비스 여부를 정의
    # client service가 server service가 ready될 때까지 기다리도록 함.
    depends_on:
      - server

Docker-compose build

docker-compose.yml 파일을 바탕으로 컨테이너 생성.
docker-compose up으로 바로 명령어 실행해도 컨테이너를 자동으로 생성함.

Docker-compose up 명령어 실행

docker-compose.yml을 바탕으로 컨테이너를 생성하여 시작.

docker-compose up [옵션][서비스명]

이후 docker-compose down으로 실행 중지시킴.

docker-compose up 명령어로 생성된 도커 이미지를 각각 push 명령어를 통해 도커 허브에 업로드

우당탕탕 했던 것들(오류)😢

services.client.networks must be a list

yml파일에 networks 요소 넣어놓고 밖에다가 또 네트워크 지정 안해서 생긴 오류

형식 따라서 yml 파일에 네트워크 지정해야함.

networks must be a mapping

이 코드는 기존의 네트워크를 사용하는 코드였음.

네트워크 지정하지 않으면 별도의 네트워크가 생성됨. 그냥 네트워크 빼버림.

failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: the Dockerfile cannot be empty

⇒dockerfile 경로를 찾지 못해서 발생

(yml 파일 문제였음. 상대 경로 지정할때 점 안 찍어서 문제 생김)