📘 [Docker] Docker 시작하기 & 명령어 정리

2025년 05월 01일 in Dev / DevOps on #Docker

[Docker] Docker 시작하기 & 명령어 정리

Docker desktop 다운로드

Docker: Accelerated Container Application Development 도커 설치

WSL 설치

$ wsl --install

• Windows 10/11 Professional / Education / Enterprise 에디션
  • WSL2 기반 Docker Engine 사용 가능
  • Hyper-V 기반 Docker Engine 사용 가능
• Windows 10/11 Home 에디션
  • WSL2 기반 Docker Engine 사용 가능

WSL 버전 기본값을 2로 변경

$ wsl --set-default-version 2

WSL(Windows Subsystem for Linux) : 윈도우의 가상화 기능을 사용해, 윈도우에서 리눅스를 사용할 수 있게 도와주는 도구

WSL은 윈도우의 가상화 기술 Hyper-V 아키텍처를 기반으로 동작한다.

• WSL 1 : 실제 Linux 커널 없이 동작하기 때문에, 모든 Linux 애플리케이션을 지원하지 않음.
• WSL 2 : VM에서 Linux 커널을 실행해 완전한 시스템 호출 호환성을 제공.

Hyper-v 활성화 방법

Terminal app을 실행시켜서 아래 명령어 실행

$ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

또는

컨트롤 + s 눌러서 windows 기능 선택 Hyper-v 체크박스 선택

Hyper-V 비활성화 방법

// 비활성화
$ bcdedit /set hypervisorlaunchtype off
// 삭제
$ Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All

• 활성화중인지 확인

  $ bcdedit /enum
  

React(vite) + docker 환경 셋팅

react 프로젝트 생성

[[2025-04-01-react-002]] 참고

프로젝트 폴더 루트 경로에 Dockerfile 생성

# node 기반 docker 이미지 생성
FROM node

# 경로 설정하기
WORKDIR /app

# package.json을 working 디렉토리에 복사한다.  ./은 현재 디렉토리를 의미
COPY package.json .

# 의존성 설치 명령어를 실행한다.
RUN npm install

# 현재 디렉토리의 파일을 도커 컨테이너의 working 디렉토리에 복사
COPY . .

# 환경변수 적용
# hot reloading : 소스 코드를 변경했을 때 페이지를 새로고침하지 않고 바뀐 소스 코드만 빠르게 교체해 준다.
# 윈도우 환경에서 hot reloading적용이 되지않을떄 CHOKIDAR_USEPOLLING=true
ENV CHOKIDAR_USEPOLLING=true

# 해당 포트 외부에 노출
EXPOSE 5173

# npm run dev 스크립트 실행
CMD ["npm", "run", "dev"]

Docker 이미지 빌드

docker build -t <이미지 이름> <경로>
docker build -t test_image .

docker images

• 이미지가 잘 만들어졌는지 확인

Docker 컨테이너 실행

// docker run -d -p <host port>:<container port> --name <tag> <사용할 이미지>
docker run -d -p 3000:5173 --name test_container test_image

• 이미지로부터 컨테이너 인스턴스를 생성
• 로컬이미지가 없다면 원격 저장소 url을 지정하면 원격저장소 이미지를 가져온다.
• -d 옵션은 백그라운드에 실행
• -p 옵션은 호스트 포트와 컨테이너 포트를 바인딩 한다. (포트 포워딩 설정)
• vite환경에서는 기본port 5173으로 설정되어있기때문에 3000:5173으로 설정

docker: Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:3000 -> 127.0.0.1:0: listen tcp 0.0.0.0:3000: bind: An attempt was made to access a socket in a way forbidden by its access permissions.

• 해당 포트가 엑세스가 되지 않아서 오류가 발생 할 경우

netsh interface ipv4 show excludedportrange protocol=tcp

• cmd창에 포트 제외 범위를 확인 3000포트가 제외 범위에 포함된다면

net stop winnat

• cmd 관리자 권한으로 실행 명령어 실행

ERR_EMPTY_RESPONSE http://localhost:3000/ 접속이 안되는경우

도커 컨테이너 환경과 호스트 환경은 독립적인 환경을 가진다. 즉 호스트 환경과 도커 컨테이너 환경의 localhost는 다른 네트워크 환경이다. 컨테이너 내부에서 localhost을 사용하여 호스트 환경에 접근이 불가능하다. 서로 접근이 불가능하기 떄문에 vite.config.js에서 서버 옵션 설정을 추가해줘야 한다. server host 0.0.0.0 의미는  LAN와 공용 주소를 포함한 모든 주소를 수신한다는 의미이다.

vite.config.js
export default defineConfig({
  plugins: [react()],
  server: {
    host: "0.0.0.0",
    port: 5137
  },
});

.dockerignore 작성

빌드시 불필요한 파일 제외 .gitignore와 동일 Docker 이미지 크기를 줄이고 불필요한 파일 포함을 방지하기 위해 매우 중요하다.

# Docker 내부에서도 무시
docker-compose*.yml
Dockerfile
.dockerignore

# Node.js 의존성 폴더
node_modules
npm-debug.log
yarn-debug.log
yarn-error.log

# 빌드 결과물
build
dist

# 환경 설정
.env

# 운영체제나 IDE 관련
.DS_Store
# Git
.git
.gitignore

• .env 파일은 민감한 정보를 포함하므로 절대 포함되면 안된다.
• build 또는 dist는 개발용 Dockerfile에선 보통 제외, 운영용 Dockerfile에선 포함할 수 있습니다.
• node_modules는 로컬에선 꼭 필요하지만 컨테이너 안에서는 보통 npm install을 다시 하므로 제외해야 한다.

Docker Bind Mount & Volume

로컬 개발 환경에서 소스 수정된 경우 컨테이너를 종료하고 이미지 빌드 다시 컨테이너 실행순으로 반복해야 한다. 변경된 소스를 실행중인 컨테이너 내부에 즉각적으로 반영하기 위해 로컬 폴더와 컨테이너 내부 폴더를 마운트 하여 연결시켜야 한다.

docker run -v ${pwd}<로컬폴더경로>:<컨테이너폴더경로> -d -p <host port>:<container port> --name <tag> <사용할 이미지>
docker run -v ${pwd}/src:/app/src:ro -d -p 3000:5173 --name test_container test_image

• ${pwd}는 현재경로를 의미 :ro 읽기전용 모드(컨터이너 내부에서 쓰기x)
• 현재경로/src 폴더와 test_container /app/src 폴더와 마운트
• -d 옵션은 백그라운드에 실행
• -p 옵션은 호스트 포트와 컨테이너 포트를 바인딩 한다. (포트 포워딩 설정)
• 윈도우 환경에서 Hot reloading되지 않을경우 CHOKIDAR_USEPOLLING=true 추가

docker-compose.yml 작성 방법

docker-compose.yml은 여러 컨테이너를 효율적으로 정의하고 관리할 수 있는 설정 파일입니다.

services:
  react-app:
    # Dockerfile이 있는 경로 지정
    build:
      context: .
      dockerfile: Dockerfile
    # 컨테이너 이름 명시
    container_name: "react_container"
    # 사용할 docker이미지 지정
    image: test
    # 컨테이너 시작 시 실행할 명령어
    # command:
    # 포트 포워딩 설정
    ports:
      - "3000:5137"
    restart: always
    # 호스트 컨테이너 volume 마운트
    volumes: 
	  - ./src:/app/src
    # -it 옵션을 위해 사용됨 (표준입출력)
    stdin_open: true
    tty: true
    # 직접 환경 변수 명시 가능
    environment:
      - CHOKIDAR_USEPOLLING=true
	#`.env` 파일에 있는 변수들 자동 로딩
	# env_file:

docker-compose 실행 명령어

# 컨테이너를 생성
docker compose up

# 이미지를 새로 빌드해서 컨테이너를 생성
docker compose -p <container name> up -d --build

# 컨테이너 삭제
docker compose down

# 컨테이너 중단
docker compose stop

# 컨테이너 시작
docker compose start

# 컨테이너 재시작
docker copmose restart

Docker 명령어 정리

docker ps
docker ps -a

• Docker 실행중인 컨테이너 목록 확인
• Docker 모든 컨테이너 목록 확인

docker inspect <id or name>

• Docker 컨테이너 정보 확인

docker rm <id or name>

• Docker 컨테이너 제거

docker start <id or name>

• Docker 컨테이너 시작

docker stop <id or name>
docker kill <id or name>

• Docker 컨테이너 정지
• Docker 컨테이너 강제종료

docker restart <id or name>

• Docker 재시작

docker exec -it <id or name> bash

• Docker 컨테이너 내부에서 명령 실행

docker logs <id or name>

• Docker 로그 확인

docker login

• Docker 로그인 Docker Hub id,password 입력

docker exec -it <id or name> /bin/bash

• exec에 -it 옵션을 쓰는 이유
  • -i: 표준 입출력 STDIN을 열겠다는 의미
  • -t: 가상 TTY(Pseudo TTY)를 통해 접속하겠다는 의미
• Docker 컨테이너 접속

docker pull username/repo-name:[:tag]

• Docker 저장소 이미지 pull

docker tag <로컬 이미지명> username/repo-name:[:tag]

• 이미지 태깅 (Docker Hub용)
• Docker Hub에는 username/repo-name[:tag] 형식으로 푸시해야 하므로 태깅이 필요

docker push username/repo-name:[:tag]

• Docker Hub로 이미지 푸시

docker rmi username/repo-name:[:tag]

• 푸시한 후 로컬에서 이미지 삭제

📑 Reference

---

• 이미지 출저 Freepik | 올인원 AI 크리에이티브 툴

---