(Docker - 2) 기초적인 도커 사용법

도커의 기본 사용법에 대해서

게시 2024/03/07

23 분읽는 시간

1. Docker 사용

MySQL 컨테이너를 생성하고 실행해보면서, 도커의 사용법을 익혀보자.

Docker Docs : https://docs.docker.com/get-started/overview/

1.1 Dockerfile 생성

MySQL 컨테이너 이미지를 빌드하기 위한 Dockerfile을 작성해보자. Dockerfile을 작성할 때 실제 이름은 Dockerfile이어야 한다.

Dockerfile

  


# 베이스 이미지 설정 - 특정 버전을 명시해서 베이스 이미지로 사용가능
From mysql:latest
# 환경 변수 설정
ENV MYSQL_ROOT_PASSWORD=root
ENV MYSQL_DATABASE=my_db
ENV MYSQL_USER=my_user
ENV MYSQL_PASSWORD=my_password

Dockerfile은 디렉토리당 하나만 존재할 수 있기 때문에, 디렉토리별로 관리하는 것이 좋다
도커파일에 사용할 수 있는 명령어는 다양하다
도커파일에서 명령어는 위에서 아래로 순차적으로 적용되며, 이미지 레이어로 적용된다
이미지 버전을 명시할 때 필요한 경우 pinned 버전을 사용해서 예상치 못한 변화를 방지할 수 있다

https://docs.docker.com/reference/dockerfile/

From : 베이스 이미지 설정
ADD/COPY : 호스트의 파일이나 디렉토리를 이미지에 추가 가능
- 사용법 : COPY {로컬 디렉토리(파일)} {컨테니어 내 디렉토리(파일)}
- COPY : Dockerfile이 존재하는 경로 기준 로컬 디렉토리(호스트의 디렉토리)를 컨테이너 내부의 디렉토리로 복사한다
WORKDIR : RUN, CMD, ENTRYPOINT 등의 명령어를 실행할 컨테이너 경로를 지정한다
- 예) WORKDIR /app : 컨테이너 내부의 /app 에서 실행하도록 설정

RUN : 컨테이너 내에서 리눅스 명령어를 실행한다. 한번에 실행할 명령어가 여러개인 경우 && \로 이어준다

사용예시

  
RUN pip install pip==23.0.1 && \
	  pip install poetry==1.2.1 && \
	  poetry export -o requirements.txt && \
	  pip install -r requirements.txt

CMD/ ENTRYPOINT : 컨테이너를 생성 및 실행할 때 실행할 명령어
- CMD : 컨테이너를 생성할 때만 명령어 수행
- 예) ` CMD [“python”, “main.py”] : 컨테이너 생성 될때 python main.py` 실행
- ENTRYPOINT : 컨테이너를 시작할 때만 명령어 수행

1.2 Docker image 빌드

위의 Dockerfile 기반으로 이미지를 빌드해보자.

사용법 : docker build -t {빌드할 이미지 이름:태그 이름} {Dockerfile이 위치한 경로}
-t 옵션으로 이미지 이름과 태그 지정

우리가 만든 Dockerfile이 존재하는 경로로 이동하고 ` docker build -t mysql-image .`을 사용해보자.

mysql-image : 빌드할 이미지 이름
. : 현재 경로
태그 이름을 지정하지 않으면 latest로 지정된다

빌드 후 docker images 명령어로 내가 가지고 있는 이미지들을 확인할 수 있다.

이미지 생성 날짜는 내가 로컬에서 Dockerfile을 통해서 생성한 날짜가 아니라, 보통 베이스 이미지가 생성되거나 수정된 날짜 기준으로 표시된다
docker rmi {image name:tag}를 통해서 이미지를 삭제할 수 있다

1.3 Docker image 실행(컨테이너 실행)

도커 이미지를 실행해보자.

사용법 : docker run {image name:tag}
이때 컨테이너과 관련된 여러 옵션을 줄 수도 있다

우리가 빌드했던 이미지를 run해서 컨테이너를 실행시켜보자.

  
docker run --name mysql-test -d -p 3306:3306 mysql-image:latest

--name : 컨테이너 이름 지정
- 지정하지 않으면 랜덤으로 이름이 부여된다
- 위에서는 mysql-test 라는 이름으로 컨테이너 이름을 지정했다
-d : 데몬(백그라운드) 모드
- 컨테이너를 백그라운드 상태로 실행한다
- 이 옵션을 사용하지 않을 경우, 현재 실행하는 셸 위에서 컨테이너가 실행되고 컨테이너의 로그를 바로 볼 수 있지만, 컨테이너를 나갈 경우 실행이 종료된다
-p : 포트 지정
- -p {localhost port}:{container port} 형태로 사용한다
- 위에서 사용한 -p 3306:3306는 로컬 포트 3306으로 접근 시 컨테이너 포트 3306으로 연결되도록 설정한 것이다
- MySQL은 기본적으로 3306 포트로 통신한다

컨테이너를 실행했다면 docker ps 명령어로 실행한 컨테이너와 정보를 확인해보자.

(docker ps -a 명령어를 사용할 경우 중지한 컨테이너까지 확인 가능하다)

무조건 메뉴얼하게 Dockerfile을 통해 이미지를 빌드할 필요는 없다.

docker pull mysql:8 같은 형태로 특정 버전의 이미지를 다운받아서 사용할 수 있다
컨테이너 실행은 docker run --name mysql-tutorial -e MYSQL_ROOT_PASSWORD=0000 -d -p 3306:3306 mysql:8와 같이 사용하면 된다

또한 우리가 만든 이미지를 업로드할 수 있다.

docker login : 나의 DockerHub 계정을 연동할 수 있다
docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG] : 도커 이미지에 태그를 적용할 수 있다
- 이미지 아이디가 1234567890ab인 이미지를 my-image:latest로 태그 하고 싶다고 가정해보자
- 예) docker tag 1234567890ab my-image:latest
docker push {이미지이름:태그} : DockerHub에 이미지를 push 한다
- DockerHub에서 푸시된 이미지를 확인 가능
- push한 이미지는 언제든지 pull로 다시 가져올 수 있다

1.4 컨테이너 접속

1.4.1 컨테이너 관련 명령

우리가 실행한 컨테이너에 접속해보기 전에 컨테이너 관련 명령어를 몇 가지 더 알아보고 가자.

컨테이너 중지 : docker stop {container name or ID}
컨테이너 시작 : docker start {container name or ID}
컨테이너 재시작 : docker restart {container name or ID}
컨테이너 삭제 : docker rm {container name or ID}
실행중인 컨테이너 강제 삭제 : docker rm {container name or ID} -f
컨테이너에 대한 상세 정보 확인 : docker inspect {container name or ID}

1.4.2 컨테이너 접속하기

실행한 컨테이너에 접속하는 방법은 다음과 같다.

접속 방법 : docker exec -it {container name or ID} /bin/bash

이제 우리가 실행한 컨테이너에 접속해보자.

docker exec -it mysql-test /bin/bash

mysql -u root -p으로 패스워드 입력하고 MySQL 쉘 화면으로 진입

1.5 Volume Mount

1.5.1 볼륨(Volume) 소개

컨테이너를 실행할 때 컨테이너와 호스트간의 파일이 자동으로 공유가 되는 것이 아니다. 도커 컨테이너는 컨테이너만의 파일 시스템이 따로 존재한다. 따라서 만약 도커 컨테이너에 따로 설정을 하지 않았다면, 컨테이너 삭제시 컨테이너의 파일들은 사라진다.

이런 파일을 유지하고 싶은 경우 호스트와 컨테이너의 저장소를 공유해야한다. 이때, 볼륨 마운트(Volume mount)를 통해서 호스트와 컨테이너가 데이터를 공유할 수 있도록 해준다.

볼륨에 대한 도커 공식 문서 : https://docs.docker.com/storage/volumes/

mount : 호스트의 파일 시스템 경로를 컨테이너에 연결하는 것
volume : 컨테이너에서 데이터를 저장하고 공유하기 위한 파일 또는 디렉토리
- 볼륨을 사용하기 위해서는 볼륨을 컨테이너에 마운트 해줘야 한다
bind mount : 호스트의 파일 또는 디렉토리를 컨테이너 내부에 직접 마운트하는 것
- 새로운 볼륨의 생성 없이 바로 파일 또는 디렉토리를 연결하는 방식이다

이런 볼륨을 사용 가장 큰 이유는, 혹시나 모를 컨테이너 삭제와 같은 상황에서 컨테이너 내부의 데이터가 전부 사라지기 때문에, persistance(영속성)를 유지하기 위해서 볼륨을 사용한다.

https://docs.docker.com/storage/volumes/

1.5.2 Volume Mount 하기

그럼 이제 볼륨을 한번 생성해보자.

docker volume create mysql_data

mysql_data라는 이름의 볼륨을 생성한다
사실 볼륨 컨테이너 생성시 볼륨의 생성과 마운트를 한번에 처리할 수 있다

생성한 볼륨을 조회하고, 상세 내용을 확인하는 방법은 다음과 같다.

docker volume ls : 생성한 볼륨 목록 확인
docker volume inspect {볼륨 이름} : 해당 볼륨에 대한 상세한 정보 확인

볼륨의 종류에 따른 마운트(mount) 방법은 다음과 같다.

anonymous volume
- 도커 엔진에 의해 자동으로 생성되는 볼륨
- 컨테이너를 실행할 때 옵션에서 호스트 경로를 지정하지 않으면 볼륨이 자동으로 생성된다
- 컨테이너 삭제 시 익명 볼륨의 데이터도 삭제된다
- -v {컨테이너 내부 경로}
named volume
- 이름을 지정하여 생성한 볼륨
- 위의 volume create로 생성한 볼륨이 named volume
- -v {볼륨 이름}:{컨테이너 내부 경로}
- 만약 해당 볼륨 이름이 존재하면 해당 볼륨을 사용하고, 존재하지 않는다면 명시한 이름으로 볼륨을 생성하고 마운트 한다
- -v 대신 --mount라는 옵션을 사용할 수 도 있다
  - --mount는 -v와 syntax가 다르며, 조금 더 상세하게 옵션을 설정할 수 있다
bind mount
- -v {호스트 경로}:{컨테이너 내부 경로}

mount point

볼륨을 마운트 했을 때. 도커는 호스트 시스템에 볼륨을 위한 특별한 디렉토리를 생성한다. 이것을 마운트 포인트(mount point)라고 한다. 볼륨 마운트시 지정한 컨테이너 내부 경로에 쓰여진 모든 데이터는 마운트 포인트에서도 존재한다.(사실상 마운트 포인트가 하나 존재하는 것이고, 컨테이너 내부의 경로 사이에 양방향의 링크가 존재하는 것이다.)

MacOS에서 마운트 포인트에 접근하기 위해서는 맥에서 리눅스 가상 머신의 파일 시스템을 통해서 접근해야 한다. (보통/var/lib/docker에 존재한다.) 만약 MacOS를 사용하는 경우 바이드 마운트를 통해서 데이터 영속성을 유지하는 것이 편할 수 있다.(만약 직접 데이터를 파일 형태로 확인하고 싶은 경우)

우리가 생성한 볼륨을 마운트하고 컨테이너를 실행(run) 해보자.

  
docker run -d --name mysql_container -v mysql_data:/var/lib/mysql -p 3306:3306 mysql-image:latest

mysql_data라는 이름의 볼륨을 마운트(없을 시 생성하고 마운트)
볼륨 마운트는 다수의 볼륨을 마운트하는 것도 가능하다
쉽게 설명하면 {볼륨 이름 또는 호스트 경로}:{컨테이너 내부의 타겟 경로} 에서 컨테이너의 내부의 타겟 디렉토리를 볼륨이나 호스트 내의 디렉토리에 연결해주는 것이라고 생각하면 편하다
- 볼륨은 호스트 어딘가에 마운트 포인트가 존재한다

2. Docker Compose

도커 컴포즈(Docker compose)에 대해 알아보자.

2.1 Docker Compose 소개

도커 컴포즈는 여러개의 컨테이너를 하나의 서비스로 정의해서 묶음으로 관리할 수 있도록 해주는 도구이다.

도커 컴포즈를 사용하면 얻을 수 있는 여러 이득이 존재한다.

멀티 컨테이너 애플리케이션들을 하나의 YAML 파일을 이용해서 정의하고 관리할 수 있다
docker-compose.yaml 파일 하나로 멀티 컨테이너 기반의 애플리케이션 환경의 빠른 공유가 가능하다
쉽게 말해서 여러 컨테이너를 사용하는 상황을 쉽게 만들어주는 도구라고 생각하는 것이 편하다

도커 컴포즈에 대한 공식 문서 : https://docs.docker.com/compose/

조금 더 자세히 예를 들자면, 만약 애플리케이션이 여러개의 컨테이너에 대해서 옵션을 설정하고 실행해야 한다면 다음과 같이 여러 명령어를 반복적으로 입력해야하는 상황이 올 수 있다.

  
# 1: PostgreSQL 컨테이너 실행
docker run -d --name mydb -e POSTGRES_PASSWORD=mysecretpassword postgres:latest

# 2: Redis 컨텡너 실행
docker run -d --name myredis redis:latest

# 3: Node.js application image 빌드
docker build -t mynodeapp .

# 4: Node.js application 컨테이너 실행 및 다른 컨테이너와의 연결 그리고 기타 옵션 설정
docker run -d --name mynodeapp -p 3000:3000 --link mydb:postgres --link myredis:redis mynodeapp

위 처럼 docker-compose.yaml을 사용하지 않으면 각 컨테이너를 따로 실행을 시키고, 옵션도 전부 적어야 한다
이런 작업은 굉장히 번거롭다

그러면 위의 예시를 도커 컴포즈를 사용하면 다음과 같이 간단한 configuration 파일로 구현할 수 있다.

docker-compose.yaml

  


version: '3.8'

services:
  web:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
      - redis

  db:
    image: postgres:latest
    environment:
      POSTGRES_PASSWORD: mysecretpassword

  redis:
    image: redis:latest

작성 후 docker compose up -d 명령어를 실행하면 똑같은 결과를 얻을 수 있다.
위에서 알 수 있듯이 docker-compose 파일이 애플리케이션의 컨테이너들에 대한 설정을 하나의 파일 안에서 관리할 수 있도록하는 방법을 제공한다

2023년 7월 부로 Compose V1은 deprecated 되었다. 이제 Compose V2의 사용이 권장된다.

공식 문서 : https://docs.docker.com/compose/migrate/

Compose V2의 특징

단어 구분자는 _가 아닌 - 사용

V1에 대한 하위 호환성 지원(몇 가지 경우 빼고)

docker-compose가 아니라 docker compose를 명령어로 사용하는 것을 권장

기존 V1에서 사용하던 version을 사용하지 않음

docker-compose.yaml 이나 docker-compose.yml 대신 compose.yaml 사용 권장

다수의 compose.yaml 파일을 사용해서 다른 환경이나 워크플로우의 관리가 쉬워짐

기타

2.2 Docker Compose 사용하기

MacOS나 윈도우에서 Docker Desktop을 설치해서 사용하는 경우 Docker Compose를 기본적으로 포함하고 있다.

리눅스를 사용하는 경우 Docker Desktop을 설치해서 사용하거나, Docker Engine을 설치해서 사용할 수 있다.

설치 공식 문서 : https://docs.docker.com/compose/install/

컴포즈 사용 공식 문서 : https://docs.docker.com/compose/gettingstarted/

그러면 이제 Docker Compose를 사용해서 컨테이너를 실행해보자.

compose.yaml 파일을 생성하자.

  


services:
  mysql:
    image: mysql:latest
    container_name: mysql-container
    restart: always
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: my_database_name
      MYSQL_USER: my_username
      MYSQL_PASSWORD: my_password
    volumes:
      - /Users/{사용자이름}/Desktop/mysql-volume:/var/lib/mysql

만약 MySQL 말고도 다양한 컨테이너를 추가하게 되면, 하나의 compose.yaml 파일에서 설정을 관리하면 되기 때문에, 다수의 컨테이너를 관리하기 편리해진다

해당 컨테이너를 실행하기 위해서 compose.yaml 파일이 존재하는 디렉토리에서 docker compose up -d 명령어를 사용한다.

만약 모든 컨테이너를 정지시키고 제거하고 싶으면 docker compose down을 사용하면 된다.

docker compose --help 를 통해서 사용 가능한 커맨드와 옵션을 확인할 수 있다.

Commands:
  attach      Attach local standard input, output, and error streams to a service's running container.
  build       Build or rebuild services
  config      Parse, resolve and render compose file in canonical format
  cp          Copy files/folders between a service container and the local filesystem
  create      Creates containers for a service.
  down        Stop and remove containers, networks
  events      Receive real time events from containers.
  exec        Execute a command in a running container.
  images      List images used by the created containers
  kill        Force stop service containers.
  logs        View output from containers
  ls          List running compose projects
  pause       Pause services
  port        Print the public port for a port binding.
  ps          List containers
  pull        Pull service images
  push        Push service images
  restart     Restart service containers
  rm          Removes stopped service containers
  run         Run a one-off command on a service.
  scale       Scale services
  start       Start services
  stats       Display a live stream of container(s) resource usage statistics
  stop        Stop services
  top         Display the running processes
  unpause     Unpause services
  up          Create and start containers
  version     Show the Docker Compose version information
  wait        Block until the first service container stops
  watch       Watch build context for service and rebuild/refresh containers when files are updated

Run 'docker compose COMMAND --help' for more information on a command.

8. 컨테이너(Container), Docker

docker