3. dockerfile-syntax

Dockerfile syntax 정리

All about Dockerfile syntax

• FROM

  • 베이스 이미지 지정

• RUN

  • 컨테이너 내에서 실행할 쉘 명령어를 지정하여 패키지 또는 소프트웨어 설정

• WORKDIR

  • 명령이 실행될 작업 디렉토리를 지정

  • 해당 디렉토리가 없다면 생성됨

• COPY

  • 호스트 머신의 파일을 컨테이너 내부로 복사

• ADD

  • COPY와 유사. 추가적인 기능 제공

  • 로컬 파일이나 URL 복사할 수 있으며, 압축 파일 자동으로 해제하고 원격 파일 다운로드 가능

• CMD

  • 컨테이너가 시작될 때 실행하는 명령을 설정

  • 도커 파일에서 한 번만 사용해야 함

  • 동시에 여러 개의 CMD 지시문을 사용할 수 있지만, 마지막 CMD만 적용됨

• ENTRYPOINT

  • 컨테이너가 시작될 때 실행되는 실행 파일 설정

  • CMD와 유사하지만 ENTRYPOINT는 항상 실행됨

  • CMD는 ENTRYPOINT의 인수로 사용됨

• ENV

  • 환경 변수를 설정

• ARG

  • 빌드 중에 전달되는 인수를 정의합니다.

• EXPOSE

  • 컨테이너가 노출할 포트 설정

• VOLUME

  • 호스트 머신과 컨테이너 간에 볼륨을 공유할 수 있도록 설정

• USER

  • 컨테이너가 실행될 사용자를 설정

• HEALTHCHECK

  • 컨테이너의 상태를 확인하는 방법을 설정

• LABEL

  • 이미지에 메타데이터를 추가

  • LABEL version="1.0"

• SHELL

  • 기본 쉘 지정

  • SHELL ["/bin/bash", "-c"]

• STOPSIGNAL

  • 컨테이너가 종료될 때 보내질 시그널을 지정

  • STOPSIGNAL SIGTERM

sample

Node.js Dockerfile sample

FROM node:20.11-alpine

RUN apk update && apk add bash sudo vim

WORKDIR /app

COPY . .

RUN npm cache clean --force && rm -rf node_modules && npm install

EXPOSE 3000

CMD ["npm", "run", "start"]

Python&Django Dockerfile sample

FROM python:3.11

ENV PYTHONUNBUFFERED=1

WORKDIR /app

COPY requirements.txt .

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

COPY . .

ENTRYPOINT ["uvicorn", "myproject.asgi:application", "--host", "0.0.0.0", "--port", "8000"]

Multistaging nodejs sample

FROM node:14 AS development

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD ["npm", "run", "dev"]

FROM node:14 AS production

WORKDIR /app

COPY package*.json ./
RUN npm install --production

COPY . .

RUN npm run build

CMD ["npm", "start"]

Build Docker image multistaging

docker build --target development --t node:dev .
docker build --target production --t node:dev .

docker compose

docker-compose up [options] [SERVICE...]
docker compose up

docker compose up -d(--detach)
- 컨테이너를 백그라운드 모드로 실행

docker compose up --force-recreate
- 변경 사항이 없어도 컨테이너를 강제로 다시 생성

docker compose images

docker compose down
docker compose build
docker compose start

docker compose stop
docker compose stop -t 20 # stop with a timeout

docker compose restart

docker compose rf
docker compose rf -f

docker compose logs
docker compose logs -f # follow log output

docker compose exec [my-service] bash
docker compose ps