WSL · Ubuntu · Docker 이해하기

내가 사용할 개발환경에 대한 이해를 돕기 위하여 작성
2026-06-12 07:56:52 +09:00
parent bbf25683ce
commit a6e2b9bc29
1 changed files with 639 additions and 0 deletions
--- a/docs/setup/WSL
+++ b/docs/setup/WSL
@@ -0,0 +1,639 @@
 # WSL · Ubuntu · Docker 이해하기 (초보자용 가이드)
 ## 문서 정보
 | 항목   | 내용                         |
 | ---- | -------------------------- |
 | 문서명  | WSL · Ubuntu · Docker 이해하기 |
 | 대상   | 개발 입문자, 신규 팀원              |
 | 작성목적 | Baron SSO 개발환경 이해          |
 | 작성일  | 2026-06-12                 |
 ---
 # 1. 개요
 현재 Baron SSO 개발환경은 다음과 같은 구조로 구성되어 있습니다.
 ```text
 Windows
   ↓
 WSL
   ↓
 Ubuntu
   ↓
 Docker
   ↓
 Baron 서비스들
 ```
 처음 접하는 사람은 용어가 많아 어렵게 느껴질 수 있지만,
 사실은 다음과 같이 이해하면 쉽습니다.
 | 구성요소           | 비유         |
 | -------------- | ---------- |
 | Windows        | 집          |
 | WSL            | 집 안의 리눅스 방 |
 | Ubuntu         | 방에 사는 사람   |
 | Docker         | 작업실        |
 | Container      | 개별 작업실     |
 | Baron Backend  | 백엔드 작업실    |
 | Baron Frontend | 프론트엔드 작업실  |
 | ClickHouse     | 데이터 저장 작업실 |
 ---
 # 2. 전체 구조 이해하기
 ## 실제 개발환경 구조
 ```text
 ┌─────────────────────────┐
 │      Windows 11         │
 │                         │
 │  VS Code                │
 │  Chrome                 │
 │  Git                    │
 └──────────┬──────────────┘
           │
           ▼
 ┌─────────────────────────┐
 │         WSL             │
 │ (Windows Linux Layer)   │
 └──────────┬──────────────┘
           │
           ▼
 ┌─────────────────────────┐
 │        Ubuntu           │
 │       (Linux)           │
 └──────────┬──────────────┘
           │
           ▼
 ┌─────────────────────────┐
 │        Docker           │
 └──────────┬──────────────┘
           │
           ▼
 ┌─────────┼─────────┬─────────┐
 ▼         ▼         ▼         ▼
 Backend  UserFront AdminFront ClickHouse
 ```
 ---
 # 3. Windows란?
 현재 우리가 사용하는 기본 운영체제(OS)입니다.
 예)
 ```text
 C:\Users
 D:\Project
 E:\Workspace
 ```
 Windows 환경에서 사용하는 경로입니다.
 주요 프로그램
 * VS Code
 * Chrome
 * Edge
 * Explorer
 * Git GUI
 등이 Windows 위에서 실행됩니다.
 ---
 # 4. WSL이란?
 ## WSL
 Windows Subsystem for Linux
 즉,
 "Windows 안에서 Linux를 실행할 수 있게 해주는 기능"
 입니다.
 ---
 ## WSL이 없던 시절
 Linux를 사용하려면
 ```text
 PC
 ├─ Windows
 └─ Virtual Machine
      └─ Ubuntu
 ```
 구조를 사용했습니다.
 문제점
 * 느림
 * 무거움
 * 메모리 많이 사용
 ---
 ## WSL 사용
 ```text
 PC
 ├─ Windows
 └─ WSL
      └─ Ubuntu
 ```
 장점
 * 빠름
 * 가벼움
 * 실제 Linux와 거의 동일
 ---
 # 5. Ubuntu란?
 Ubuntu는 Linux 운영체제입니다.
 Windows와 같은 OS입니다.
 비교하면
 | Windows    | Linux    |
 | ---------- | -------- |
 | Windows 11 | Ubuntu   |
 | 탐색기        | Shell    |
 | CMD        | Terminal |
 | PowerShell | Bash     |
 ---
 Ubuntu 접속 예시
 ```bash
 wsl
 ```
 또는
 ```bash
 ubuntu
 ```
 실행 후
 ```bash
 ubuntu@DESKTOP-XXXX:~$
 ```
 가 보이면 Ubuntu 안에 들어온 상태입니다.
 ---
 # 6. Docker란?
 Docker는
 "프로그램을 독립적으로 실행하는 기술"
 입니다.
 ---
 예를 들어
 Baron 프로젝트에 필요한 것
 ```text
 NodeJS
 Database
 Backend
 Frontend
 ClickHouse
 ```
 를 직접 설치하면
 PC가 복잡해집니다.
 ---
 Docker 사용 시
 ```text
 ┌────────────┐
 │ Backend    │
 └────────────┘
 ┌────────────┐
 │ Frontend   │
 └────────────┘
 ┌────────────┐
 │ Database   │
 └────────────┘
 ┌────────────┐
 │ ClickHouse │
 └────────────┘
 ```
 각각 독립적으로 실행됩니다.
 ---
 # 7. Container란?
 Docker 안에서 실행되는 작은 서버입니다.
 쉽게 말하면
 "미니 컴퓨터"
 라고 생각하면 됩니다.
 ---
 현재 Baron 환경 예시
 ```text
 Container 1
 baron_backend
 Container 2
 baron_userfront
 Container 3
 baron_adminfront
 Container 4
 baron_clickhouse
 ```
 각 컨테이너는
 * 독립 실행
 * 독립 설정
 * 독립 포트
 를 가집니다.
 ---
 # 8. Image와 Container 차이
 많이 헷갈리는 부분입니다.
 ## Image
 설치 파일
 예)
 ```text
 Windows 설치 ISO
 ```
 와 비슷
 ---
 ## Container
 실행 중인 프로그램
 예)
 ```text
 설치 완료 후 실행된 Windows
 ```
 와 비슷
 ---
 관계
 ```text
 Docker Image
      ↓
 실행
      ↓
 Container
 ```
 ---
 # 9. 실제 Baron 프로젝트 구조
 현재 개발환경
 ```text
 Windows
 │
 ├─ VS Code
 │
 ├─ Git
 │
 └─ E:\h_workspace\baron-sso
 ```
 ---
 WSL에서 보면
 ```text
 /mnt/e/h_workspace/baron-sso
 ```
 가 됩니다.
 ---
 같은 폴더를
 Windows와 Ubuntu가
 다르게 표현하는 것입니다.
 | Windows                  | Ubuntu                       |
 | ------------------------ | ---------------------------- |
 | E:\h_workspace\baron-sso | /mnt/e/h_workspace/baron-sso |
 ---
 # 10. VS Code는 어디서 실행되는가?
 VS Code 자체는 Windows에서 실행됩니다.
 ```text
 Windows
 └─ VS Code
 ```
 하지만
 Remote WSL 기능을 사용하면
 ```text
 VS Code
   ↓
 WSL
   ↓
 Ubuntu
 ```
 에 연결됩니다.
 ---
 좌측 하단에
 ```text
 WSL: Ubuntu
 ```
 가 보이면
 Ubuntu 내부를 편집 중인 상태입니다.
 ---
 # 11. Docker Compose란?
 여러 컨테이너를 한 번에 실행하는 기능입니다.
 예)
 docker-compose.yml
 ```yaml
 services:
  backend:
    ...
  userfront:
    ...
  adminfront:
    ...
  clickhouse:
    ...
 ```
 ---
 실행
 ```bash
 docker compose up -d
 ```
 ---
 Docker가 자동으로
 ```text
 Backend 시작
 UserFront 시작
 AdminFront 시작
 ClickHouse 시작
 ```
 을 수행합니다.
 ---
 # 12. Baron SSO 실행 흐름
 ```text
 개발자
   │
   ▼
 VS Code 수정
   │
   ▼
 Git 저장
   │
   ▼
 Docker Compose 실행
   │
   ▼
 Backend Container
 UserFront Container
 AdminFront Container
 ClickHouse Container
   │
   ▼
 웹 브라우저 접속
 ```
 ---
 # 13. 자주 사용하는 명령어
 ## 현재 컨테이너 보기
 ```bash
 docker ps
 ```
 ---
 ## 전체 컨테이너 보기
 ```bash
 docker ps -a
 ```
 ---
 ## 로그 보기
 ```bash
 docker logs 컨테이너명
 ```
 예)
 ```bash
 docker logs baron_backend
 ```
 ---
 ## 컨테이너 접속
 ```bash
 docker exec -it 컨테이너명 bash
 ```
 예)
 ```bash
 docker exec -it baron_backend bash
 ```
 ---
 ## 컨테이너 중지
 ```bash
 docker stop 컨테이너명
 ```
 ---
 ## 컨테이너 재시작
 ```bash
 docker restart 컨테이너명
 ```
 ---
 # 14. 최종 정리
 ## 한 문장 설명
 ### Windows
 사용자가 사용하는 실제 운영체제
 ---
 ### WSL
 Windows 안에서 Linux를 사용할 수 있게 해주는 기능
 ---
 ### Ubuntu
 WSL 안에서 실행되는 Linux 운영체제
 ---
 ### Docker
 프로그램을 독립된 환경에서 실행하는 기술
 ---
 ### Container
 Docker 안에서 실행되는 개별 서비스
 ---
 ## Baron SSO 전체 구조
 ```text
 사용자
   │
   ▼
 Windows
   │
 VS Code
   │
 WSL
   │
 Ubuntu
   │
 Docker
   │
 ├─ baron_backend
 ├─ baron_userfront
 ├─ baron_adminfront
 └─ baron_clickhouse
   │
 브라우저 접속
 ```
 ---
 ## 기억해야 할 핵심
 "Windows 위에서 WSL이 동작하고,
 WSL 안에서 Ubuntu가 실행되며,
 Ubuntu 안에서 Docker가 실행되고,
 Docker 안에서 Baron 서비스들이 실행된다."