Skip to content

Latest commit

ย 

History

History
1145 lines (860 loc) ยท 73.3 KB

README.md

File metadata and controls

1145 lines (860 loc) ยท 73.3 KB

๐ŸŽฏ ๋‚˜๋งŒ์˜ ํ€ด์ฆˆ ๊ฒŒ์ž„ (Python Quiz Game)

Docker ์žฌํ˜„์„ฑ ๊ฒ€์‚ฌ

์ฝ”๋””์„ธ์ด AI ์˜ฌ์ธ์› ๊ณผ์ • ยท Windows 11 ์‚ฌ์šฉ์ž ์•ˆ๋‚ด
์ฒ˜์Œ ์„ค์น˜ํ•˜๋Š” ๋ถ„์€ 12. ์™„์ „ ์ดˆ๋ณด๋ฅผ ์œ„ํ•œ ์„ค์น˜๋ถ€ํ„ฐ ๋”ฐ๋ผํ•˜๊ธฐ ํ”Œ๋ ˆ์ด๋ถ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•˜์„ธ์š”. ํด๋ฆญํ•  ์œ„์น˜, ๋ณต์‚ฌํ•  ๋ช…๋ น์–ด, ๋‹จ๊ณ„๋ณ„ ์„ฑ๊ณต ํ™•์ธ๊นŒ์ง€ ์ˆœ์„œ๋Œ€๋กœ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

ํ„ฐ๋ฏธ๋„์—์„œ ๋™์ž‘ํ•˜๋Š” 4์ง€์„ ๋‹ค ํ€ด์ฆˆ ๊ฒŒ์ž„์ž…๋‹ˆ๋‹ค. ๋ฉ”๋‰ด์—์„œ ๋ฒˆํ˜ธ๋ฅผ ๊ณจ๋ผ ํ€ด์ฆˆ๋ฅผ ํ’€๊ณ , ์ง์ ‘ ํ€ด์ฆˆ๋ฅผ ์ถ”๊ฐ€ยท์‚ญ์ œํ•˜๊ณ , ์ตœ๊ณ  ์ ์ˆ˜์™€ ๊ฒŒ์ž„ ๊ธฐ๋ก์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ”„๋กœ๊ทธ๋žจ์„ ์ข…๋ฃŒํ–ˆ๋‹ค๊ฐ€ ๋‹ค์‹œ ์‹คํ–‰ํ•ด๋„ ํ€ด์ฆˆ์™€ ์ ์ˆ˜๋Š” state.json ํŒŒ์ผ์— ์ €์žฅ๋˜์–ด ๊ทธ๋Œ€๋กœ ๋‚จ์•„ ์žˆ์Šต๋‹ˆ๋‹ค.

1. ํ”„๋กœ์ ํŠธ ๊ฐœ์š”

ํ•ญ๋ชฉ ๋‚ด์šฉ
ํ˜•ํƒœ Python ์ฝ˜์†”(ํ„ฐ๋ฏธ๋„) ํ”„๋กœ๊ทธ๋žจ
๊ฐœ๋ฐœ ํ™˜๊ฒฝ Python 3.10 ์ด์ƒ (3.10, 3.13์—์„œ ๋™์ž‘ ํ™•์ธ), ์™ธ๋ถ€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์—†์Œ (ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋งŒ ์‚ฌ์šฉ)
ํ•ต์‹ฌ ๊ตฌ์กฐ Quiz(๋ฌธ์ œ 1๊ฐœ), QuizGame(๊ฒŒ์ž„ ํ๋ฆ„), StateStorage(ํŒŒ์ผ ์ €์žฅ) 3๊ฐœ ํด๋ž˜์Šค๋กœ ์—ญํ•  ๋ถ„๋ฆฌ
๋ฐ์ดํ„ฐ ์ €์žฅ ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์˜ state.json (UTF-8 JSON)
๋ฒ„์ „ ๊ด€๋ฆฌ Git ๊ธฐ๋Šฅ ๋‹จ์œ„ ์ปค๋ฐ‹ + ๊ธฐ๋Šฅ ๋ธŒ๋žœ์น˜(feature/*) ์ž‘์—… ํ›„ main์— ๋ณ‘ํ•ฉ
์‹คํ–‰ ํ™˜๊ฒฝ ์žฌํ˜„ Docker ์ด๋ฏธ์ง€(Python 3.12.16 ๊ณ ์ •)๋กœ WindowsยทmacOSยทLinux ์–ด๋””์„œ๋‚˜ ๊ฐ™์€ ํ™˜๊ฒฝ์—์„œ ์‹คํ–‰, GitHub Actions๋กœ push๋งˆ๋‹ค ์ž๋™ ๊ฒ€์‚ฌ (9์žฅ)
์›๊ฒฉ ์ €์žฅ์†Œ https://github.com/buildergarlic/python-quiz-game โ€” ์ปค๋ฐ‹ ์ˆ˜ยท๋ธŒ๋žœ์น˜ ๋ณ‘ํ•ฉ ๊ทธ๋ž˜ํ”„ ์ฆ๋น™์€ 8์žฅ
ํ…Œ์ŠคํŠธ ๋‹จ์œ„ ํ…Œ์ŠคํŠธ 48๊ฐœ (tests/), push๋งˆ๋‹ค Python 3.12.16ยท3.10์—์„œ ์ž๋™ ์‹คํ–‰ (10์žฅ)
๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ํ€ด์ฆˆ 1,000~100,000๊ฐœ ์‹ค์ธก๊ณผ ํ•œ๊ณ„ยท๊ฐœ์„ ์•ˆ (11์žฅ)

2. ํ€ด์ฆˆ ์ฃผ์ œ์™€ ์„ ์ • ์ด์œ 

์ฃผ์ œ: Python & Git ๊ธฐ์ดˆ

  • ๋งŒ๋“œ๋Š” ๊ณผ์ •์ด ๊ณง ๋ณต์Šต์ด๋‹ค. ์ด ๋ฏธ์…˜์—์„œ ๋ฐฐ์šฐ๋Š” ์ž๋ฃŒํ˜•, ๋ฐ˜๋ณต๋ฌธ, ํด๋ž˜์Šค, JSON, ์˜ˆ์™ธ ์ฒ˜๋ฆฌ, Git ๋ช…๋ น์–ด๋ฅผ ๋ฌธ์ œ๋กœ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. ์ข‹์€ 4์ง€์„ ๋‹ค ๋ฌธ์ œ๋ฅผ ๋‚ด๋ ค๋ฉด ์ •๋‹ต๋ฟ ์•„๋‹ˆ๋ผ ์˜ค๋‹ต ์„ ํƒ์ง€๊ฐ€ ์™œ ํ‹€๋ ธ๋Š”์ง€๋„ ์•Œ์•„์•ผ ํ•ด์„œ, ๋ฌธ์ œ๋ฅผ ๋งŒ๋“œ๋Š” ๊ณผ์ •์—์„œ ๊ฐœ๋…์„ ํ•œ ๋ฒˆ ๋” ์ •๋ฆฌํ•  ์ˆ˜ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.
  • ์ฝ”๋“œ์™€ ํ€ด์ฆˆ๊ฐ€ ์„œ๋กœ๋ฅผ ์„ค๋ช…ํ•œ๋‹ค. int('abc')๊ฐ€ ValueError๋ฅผ ๋‚ด๋Š” ๊ฒƒ(์ˆซ์ž ์ž…๋ ฅ ๊ฒ€์ฆ), None์ด JSON์—์„œ null๋กœ ์ €์žฅ๋˜๋Š” ๊ฒƒ(best_score) ๋“ฑ ์ด ๊ฒŒ์ž„์„ ๋งŒ๋“ค๋ฉด์„œ ์‹ค์ œ๋กœ ๋งˆ์ฃผ์นœ ๋‚ด์šฉ์„ ๋ฌธ์ œ๋กœ ๋„ฃ์—ˆ์Šต๋‹ˆ๋‹ค.
  • ํ•จ๊ป˜ ์“ธ ์ˆ˜ ์žˆ๋‹ค. ๊ฐ™์€ ๊ณผ์ •์„ ๋ฐŸ๋Š” ๋™๋ฃŒ๋“ค๋„ ๋ฐ”๋กœ ํ’€์–ด ๋ณด๋ฉฐ ๋ณต์Šตํ•  ์ˆ˜ ์žˆ๋Š” ์ฃผ์ œ์ž…๋‹ˆ๋‹ค.

3. ์‹คํ–‰ ๋ฐฉ๋ฒ•

Windows 11์—์„œ Docker๋ฅผ ์ฒ˜์Œ ์‚ฌ์šฉํ•˜๋Š” ๊ณผ์ • ์ฐธ์—ฌ์ž๋Š” 12์žฅ ์„ค์น˜๋ถ€ํ„ฐ ๋”ฐ๋ผํ•˜๊ธฐ ํ”Œ๋ ˆ์ด๋ถ์„ ์ด์šฉํ•˜์„ธ์š”.

๋‘ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์ด ์žˆ์Šต๋‹ˆ๋‹ค. PC ํ™˜๊ฒฝ๊ณผ ์ƒ๊ด€์—†์ด ๋˜‘๊ฐ™์ด ์‹คํ–‰ํ•˜๋ ค๋ฉด ๋ฐฉ๋ฒ• 1(Docker)์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• 1. Docker๋กœ ์‹คํ–‰ (Python ์„ค์น˜ ๋ถˆํ•„์š”, WindowsยทmacOSยทLinux ๋™์ผ)

git clone https://github.com/buildergarlic/python-quiz-game.git
cd python-quiz-game
docker compose build
docker compose run --rm quiz
  • Docker Desktop(๋˜๋Š” Docker Engine)๋งŒ ์„ค์น˜๋˜์–ด ์žˆ์œผ๋ฉด ๋ฉ๋‹ˆ๋‹ค.
  • ํ€ด์ฆˆ์™€ ์ ์ˆ˜๋Š” Docker ๋ณผ๋ฅจ์— ์ €์žฅ๋˜์–ด, ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ง€์šฐ๊ณ  ๋‹ค์‹œ ์‹คํ–‰ํ•ด๋„ ๋‚จ์•„ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์„ค์น˜ ๋ฐฉ๋ฒ•, OS๋ณ„ ๋ช…๋ น์–ด, ๋ฐ์ดํ„ฐ ๊ด€๋ฆฌ, ๋ฌธ์ œ ํ•ด๊ฒฐ์€ 9. Docker ์‹คํ–‰ ๊ฐ€์ด๋“œ์— ๋ชจ๋‘ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• 2. Python์œผ๋กœ ์ง์ ‘ ์‹คํ–‰

# 1) ์ €์žฅ์†Œ ๋ณต์ œ
git clone https://github.com/buildergarlic/python-quiz-game.git
cd python-quiz-game

# 2) ์‹คํ–‰ (Windows)
python main.py

# 2) ์‹คํ–‰ (macOS / Linux)
python3 main.py
  • Python ๋ฒ„์ „ ํ™•์ธ: python --version (3.10 ์ด์ƒ)
  • ์„ค์น˜ํ•  ํŒจํ‚ค์ง€๋Š” ์—†์Šต๋‹ˆ๋‹ค.
  • ์ฒ˜์Œ ์‹คํ–‰ํ•˜๋ฉด ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๊ฐœ๋กœ ์‹œ์ž‘ํ•˜๊ณ  state.json์ด ์ž๋™์œผ๋กœ ๋งŒ๋“ค์–ด์ง‘๋‹ˆ๋‹ค.
  • ํ…Œ์ŠคํŠธ ์‹คํ–‰: python -m unittest discover -s tests -v (10์žฅ)

4. ๊ธฐ๋Šฅ ๋ชฉ๋ก

๋ฉ”๋‰ด

๋ฒˆํ˜ธ ๋ฉ”๋‰ด ์„ค๋ช…
1 ํ€ด์ฆˆ ํ’€๊ธฐ ํ’€ ๋ฌธ์ œ ์ˆ˜๋ฅผ ๊ณ ๋ฅด๋ฉด ๋ฌด์ž‘์œ„ ์ˆœ์„œ๋กœ ์ถœ์ œํ•ฉ๋‹ˆ๋‹ค. ์ •๋‹ต/์˜ค๋‹ต์„ ๋ฐ”๋กœ ์•Œ๋ ค ์ฃผ๊ณ , ๋‹ค ํ’€๋ฉด ๊ฒฐ๊ณผ์™€ ์ตœ๊ณ  ์ ์ˆ˜ ๊ฐฑ์‹  ์—ฌ๋ถ€๋ฅผ ๋ณด์—ฌ ์ค๋‹ˆ๋‹ค.
2 ํ€ด์ฆˆ ์ถ”๊ฐ€ ๋ฌธ์ œ, ์„ ํƒ์ง€ 4๊ฐœ, ์ •๋‹ต ๋ฒˆํ˜ธ(1-4), ํžŒํŠธ(์„ ํƒ)๋ฅผ ์ž…๋ ฅ๋ฐ›์•„ ๋“ฑ๋กํ•˜๊ณ  ๋ฐ”๋กœ ์ €์žฅํ•ฉ๋‹ˆ๋‹ค.
3 ํ€ด์ฆˆ ๋ชฉ๋ก ๋“ฑ๋ก๋œ ํ€ด์ฆˆ๋ฅผ ๋ฒˆํ˜ธ์™€ ํ•จ๊ป˜ ๋ณด์—ฌ ์ค๋‹ˆ๋‹ค. (๐Ÿ’ก = ํžŒํŠธ ์žˆ์Œ)
4 ์ ์ˆ˜ ํ™•์ธ ์ตœ๊ณ  ์ ์ˆ˜์™€ ๊ทธ ์ ์ˆ˜๋ฅผ ๋‚ธ ๊ฒŒ์ž„์˜ ์ •๋‹ต ์ˆ˜ยท์ผ์‹œ๋ฅผ ๋ณด์—ฌ ์ค๋‹ˆ๋‹ค.
5 ํ€ด์ฆˆ ์‚ญ์ œ ๋ฒˆํ˜ธ๋กœ ํ€ด์ฆˆ๋ฅผ ๊ณจ๋ผ ํ™•์ธ(y/n) ํ›„ ์‚ญ์ œํ•˜๊ณ  ์ €์žฅํ•ฉ๋‹ˆ๋‹ค. (0 = ์ทจ์†Œ)
6 ๊ฒŒ์ž„ ๊ธฐ๋ก ์ตœ๊ทผ 10ํšŒ ๊ฒŒ์ž„ ๊ธฐ๋ก(์ผ์‹œ, ๋ฌธ์ œ ์ˆ˜, ์ •๋‹ต ์ˆ˜, ํžŒํŠธ ์‚ฌ์šฉ, ์ ์ˆ˜)์„ ์ตœ์‹ ์ˆœ์œผ๋กœ ๋ณด์—ฌ ์ค๋‹ˆ๋‹ค.
7 ์ข…๋ฃŒ ๋ฐ์ดํ„ฐ๋ฅผ ์ €์žฅํ•˜๊ณ  ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค.

๋ณด๋„ˆ์Šค ๊ณผ์ œ ๊ตฌํ˜„

  • ๋žœ๋ค ์ถœ์ œ โ€” random.sample()๋กœ ์›๋ณธ ๋ชฉ๋ก์€ ๊ทธ๋Œ€๋กœ ๋‘๊ณ  ๋ฌด์ž‘์œ„๋กœ ๋ฝ‘๊ธฐ
  • ๋ฌธ์ œ ์ˆ˜ ์„ ํƒ โ€” ํ€ด์ฆˆ ์‹œ์ž‘ ์‹œ 1 ~ ์ „์ฒด ๋ฌธ์ œ ์ˆ˜ ์ค‘ ์„ ํƒ
  • ํžŒํŠธ ๊ธฐ๋Šฅ โ€” ํ’€์ด ์ค‘ h ์ž…๋ ฅ ์‹œ ํžŒํŠธ ํ‘œ์‹œ, ํžŒํŠธ๋ฅผ ๋ณด๊ณ  ๋งžํžŒ ๋ฌธ์ œ๋Š” ์ ˆ๋ฐ˜ ์ ์ˆ˜
  • ํ€ด์ฆˆ ์‚ญ์ œ ๊ธฐ๋Šฅ
  • ์ ์ˆ˜ ๊ธฐ๋ก ํžˆ์Šคํ† ๋ฆฌ โ€” ๋ชจ๋“  ๊ฒŒ์ž„ ๊ธฐ๋ก์„ state.json์— ์ €์žฅ

์ ์ˆ˜ ๊ณ„์‚ฐ

  • 100์  ๋งŒ์ , ๋ฌธ์ œ๋‹น ๋ฐฐ์  = 100 / ํ‘ผ ๋ฌธ์ œ ์ˆ˜
  • ํžŒํŠธ ์—†์ด ๋งžํžˆ๋ฉด ๋ฐฐ์  ์ „๋ถ€, ํžŒํŠธ๋ฅผ ๋ณด๊ณ  ๋งžํžˆ๋ฉด ๋ฐฐ์ ์˜ 50%, ํ‹€๋ฆฌ๋ฉด 0์ 
  • ์˜ˆ) 3๋ฌธ์ œ ์ค‘ 1๊ฐœ๋Š” ๊ทธ๋ƒฅ ๋งžํžˆ๊ณ  1๊ฐœ๋Š” ํžŒํŠธ๋ฅผ ๋ณด๊ณ  ๋งžํžˆ๊ณ  1๊ฐœ๋Š” ํ‹€๋ฆผ โ†’ (1 + 0.5 + 0) / 3 ร— 100 = 50์ 
  • ์ตœ๊ณ  ์ ์ˆ˜๋Š” ์ด ์ ์ˆ˜(0~100) ๊ธฐ์ค€์œผ๋กœ ๋น„๊ตํ•˜๋ฉฐ, ๊ธฐ์กด ์ตœ๊ณ  ์ ์ˆ˜๋ณด๋‹ค ๋†’์„ ๋•Œ๋งŒ ๊ฐฑ์‹ ํ•ฉ๋‹ˆ๋‹ค.

์ž…๋ ฅ / ์˜ˆ์™ธ ์ฒ˜๋ฆฌ

์ƒํ™ฉ ์ฒ˜๋ฆฌ
์•ž๋’ค ๊ณต๋ฐฑ (" 1 ") ๊ณต๋ฐฑ์„ ์ œ๊ฑฐํ•˜๊ณ  1๋กœ ์ฒ˜๋ฆฌ
์ˆซ์ž๊ฐ€ ์•„๋‹˜ (abc) ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ ํ›„ ๋‹ค์‹œ ์ž…๋ ฅ
๋ฒ”์œ„ ๋ฐ– ์ˆซ์ž (๋ฉ”๋‰ด 9, ์ •๋‹ต 0) ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ ํ›„ ๋‹ค์‹œ ์ž…๋ ฅ
๋นˆ ์ž…๋ ฅ (๊ทธ๋ƒฅ Enter) ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ ํ›„ ๋‹ค์‹œ ์ž…๋ ฅ
๋นˆ ๋ฌธ์ œ/์„ ํƒ์ง€, ์ค‘๋ณต ์„ ํƒ์ง€ ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ ์ถœ๋ ฅ ํ›„ ๋‹ค์‹œ ์ž…๋ ฅ
Ctrl+C (KeyboardInterrupt), Ctrl+D/Ctrl+Z (EOFError) ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ โ†’ ๋ฐ์ดํ„ฐ ์ €์žฅ โ†’ ์ •์ƒ ์ข…๋ฃŒ
์ข…๋ฃŒ ์š”์ฒญ ์‹ ํ˜ธ SIGTERM (kill <PID>, ์„œ๋น„์Šค ๊ด€๋ฆฌ์ž) main.py์˜ handle_terminate()๊ฐ€ KeyboardInterrupt๋กœ ๋ฐ”๊ฟ” Ctrl+C์™€ ๊ฐ™์€ ๊ฒฝ๋กœ๋กœ ์ €์žฅ ํ›„ ์ข…๋ฃŒ (์ข…๋ฃŒ ์ฝ”๋“œ 0). ์ €์žฅ ์ค‘์— ๋‹ค์‹œ ์˜ค๋ฉด ๋ฌด์‹œํ•ด ์ €์žฅ์ด ๋Š๊ธฐ์ง€ ์•Š์Œ
state.json ์—†์Œ (์ฒซ ์‹คํ–‰) ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๊ฐœ๋กœ ์‹œ์ž‘ํ•˜๊ณ  ํŒŒ์ผ ์ƒ์„ฑ
state.json ์†์ƒ (JSON ๋ฌธ๋ฒ• ์˜ค๋ฅ˜, ํ•„๋“œ ํ˜•์‹ ์˜ค๋ฅ˜) state.json.bak์œผ๋กœ ๋ฐฑ์—…ํ•œ ๋’ค ๊ธฐ๋ณธ ๋ฐ์ดํ„ฐ๋กœ ๋ณต๊ตฌ
state.json ์ฝ๊ธฐ ๋ถˆ๊ฐ€ (๊ถŒํ•œ ๋“ฑ) ๊ธฐ๋ณธ ํ€ด์ฆˆ๋กœ ์‹œ์ž‘ํ•˜๋˜, ์›๋ณธ์„ ๋ฎ์–ด์“ฐ์ง€ ์•Š๋„๋ก ๊ทธ ์‹คํ–‰์—์„œ๋Š” ์ €์žฅํ•˜์ง€ ์•Š์Œ
์ €์žฅ ์‹คํŒจ (๋””์Šคํฌยท๊ถŒํ•œ ๋ฌธ์ œ) ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€๋ฅผ ๋ณด์—ฌ ์ฃผ๊ณ  ๊ฒŒ์ž„์€ ๊ณ„์† ์ง„ํ–‰ (์•„๋ž˜ ๋ณต๊ตฌ ์ ˆ์ฐจ ์ฐธ๊ณ )

์ €์žฅยท๋ถˆ๋Ÿฌ์˜ค๊ธฐ ์˜ค๋ฅ˜๊ฐ€ ๋‚ฌ์„ ๋•Œ ๋ณต๊ตฌ ์ ˆ์ฐจ

์ €์žฅ์€ ํ•ญ์ƒ ๋ฉ”๋ชจ๋ฆฌ์— ์žˆ๋Š” ์ „์ฒด ๋ฐ์ดํ„ฐ๋ฅผ ์ž„์‹œ ํŒŒ์ผ์— ์“ด ๋’ค state.json๊ณผ ๋ฐ”๊ฟ” ๋ผ์›๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ ์ €์žฅ์ด ์‹คํŒจํ•ด๋„ state.json์—๋Š” ๋งˆ์ง€๋ง‰์œผ๋กœ ์„ฑ๊ณตํ•œ ๋‚ด์šฉ์ด ์˜จ์ „ํžˆ ๋‚จ์•„ ์žˆ๊ณ , ์›์ธ์„ ๊ณ ์นœ ๋’ค ๋‹ค์Œ ์ €์žฅ(ํ€ด์ฆˆ ์ถ”๊ฐ€ยท์‚ญ์ œ, ํ’€์ด ์ข…๋ฃŒ, ๋ฉ”๋‰ด 7 ์ข…๋ฃŒ)์ด ์„ฑ๊ณตํ•˜๋ฉด ๊ทธ๋™์•ˆ์˜ ๋ณ€๊ฒฝ์ด ํ•œ๊บผ๋ฒˆ์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.

ํ™”๋ฉด์— ๋‚˜์˜จ ์•ˆ๋‚ด ์›์ธ ํ•  ์ผ
โš ๏ธ ๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค: [Errno 13] Permission denied state.json์ด๋‚˜ ๊ทธ ํด๋”์— ์“ฐ๊ธฐ ๊ถŒํ•œ์ด ์—†์Œ ํ”„๋กœ๊ทธ๋žจ์„ ๋„์ง€ ๋ง๊ณ  ๋‹ค๋ฅธ ํ„ฐ๋ฏธ๋„์—์„œ ๊ถŒํ•œ์„ ๊ณ ์นฉ๋‹ˆ๋‹ค. macOS/Linux: chmod u+w state.json (ํด๋”๋ฉด chmod u+w .), Windows: ํŒŒ์ผ ์†์„ฑ์—์„œ '์ฝ๊ธฐ ์ „์šฉ' ํ•ด์ œ. ๊ทธ๋‹ค์Œ ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•˜๋ฉด ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.
โš ๏ธ ๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค: [Errno 28] No space left on device ๋””์Šคํฌ๊ฐ€ ๊ฐ€๋“ ์ฐธ ๊ณต๊ฐ„์„ ํ™•๋ณดํ•œ ๋’ค ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค.
โš ๏ธ state.json์„ ๋ถˆ๋Ÿฌ์˜ค์ง€ ๋ชปํ•ด ๊ธฐ๋ณธ ํ€ด์ฆˆ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. (๊ธฐ์กด ํŒŒ์ผ์„ ๋ณดํ˜ธํ•˜๊ธฐ ์œ„ํ•ด ์ด๋ฒˆ ์‹คํ–‰์—์„œ๋Š” ์ €์žฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.) ์ฝ๊ธฐ ๊ถŒํ•œ์ด ์—†๊ฑฐ๋‚˜ state.json ์ž๋ฆฌ์— ํด๋”๊ฐ€ ์žˆ์Œ ์›๋ณธ์„ ์ง€ํ‚ค๊ธฐ ์œ„ํ•ด ์ด๋ฒˆ ์‹คํ–‰์€ ์ €์žฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ข…๋ฃŒ ํ›„ ๊ถŒํ•œ์„ ๊ณ ์น˜๊ณ (chmod u+rw state.json) ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
โš ๏ธ state.json์ด ์†์ƒ๋˜์–ด ๊ธฐ๋ณธ ํ€ด์ฆˆ ๋ฐ์ดํ„ฐ๋กœ ๋ณต๊ตฌํ–ˆ์Šต๋‹ˆ๋‹ค. (์†์ƒ๋œ ํŒŒ์ผ์€ state.json.bak์— ๋ฐฑ์—…ํ•ด ๋‘์—ˆ์Šต๋‹ˆ๋‹ค.) JSON ๋ฌธ๋ฒ• ์˜ค๋ฅ˜๋‚˜ ํ˜•์‹ ์˜ค๋ฅ˜ (์˜ˆ: ์ •๋‹ต์ด true) ํ”„๋กœ๊ทธ๋žจ์„ ๋ˆ ๋’ค state.json.bak์„ ์—ด์–ด ์ž˜๋ชป๋œ ๋ถ€๋ถ„์„ ๊ณ ์น˜๊ณ , state.json์œผ๋กœ ์ด๋ฆ„์„ ๋ฐ”๊ฟ” ๋ฎ์–ด์“ด ๋‹ค์Œ ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฐฑ์—… ๋ณด์กด ์ •์ฑ…: ๋ฐฑ์—… ํŒŒ์ผ์€ state.json.bak 1๊ฐœ๋งŒ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. ์†์ƒ์ด ๋‹ค์‹œ ์ƒ๊ธฐ๋ฉด ์ด์ „ ๋ฐฑ์—…์„ ์ƒˆ ์†์ƒ ํŒŒ์ผ๋กœ ๋ฎ์–ด์”๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ ๋ณต๊ตฌ ์•ˆ๋‚ด๊ฐ€ ๋‚˜์˜ค๋ฉด ๋‹ค์Œ ์‹คํ–‰ ์ „์— .bak์„ ํ™•์ธํ•˜๊ฑฐ๋‚˜ ๋‹ค๋ฅธ ์ด๋ฆ„์œผ๋กœ ๋ณต์‚ฌํ•ด ๋‘์„ธ์š”. ๋ฐฑ์—…์— ์‹คํŒจํ•˜๋ฉด(๊ถŒํ•œ ๋“ฑ) ๊ธฐ๋ณธ๊ฐ’์œผ๋กœ ๋ฎ์–ด์“ฐ์ง€ ์•Š๊ณ  ๊ทธ ์‹คํ–‰์—์„œ๋Š” ์ €์žฅ์„ ๋•๋‹ˆ๋‹ค.
  • ์‚ฌ์šฉ์ž ์•Œ๋ฆผ: ๋ณต๊ตฌยท์ €์žฅ ์‹คํŒจยท์ €์žฅ ์ค‘์ง€๋Š” ๋ชจ๋‘ ์ฒซ ํ™”๋ฉด์ด๋‚˜ ํ•ด๋‹น ์‹œ์ ์— โš ๏ธ ๋ฉ”์‹œ์ง€๋กœ ์•Œ๋ฆฌ๊ณ , ๋ฐฑ์—… ํŒŒ์ผ ์ด๋ฆ„์„ ํ•จ๊ป˜ ๋ณด์—ฌ ์ค๋‹ˆ๋‹ค.
  • ๋™์‹œ ์‹คํ–‰: ๊ฐ™์€ state.json์œผ๋กœ ํ”„๋กœ๊ทธ๋žจ์„ ๋‘ ๊ฐœ ๋™์‹œ์— ์‹คํ–‰ํ•˜๋ฉด ๋‚˜์ค‘์— ์ €์žฅํ•œ ์ชฝ์˜ ๋‚ด์šฉ์ด ๋‚จ์Šต๋‹ˆ๋‹ค(ํŒŒ์ผ ์ž ๊ธˆ ์—†์Œ). ํŒŒ์ผ์ด ๊นจ์ง€์ง€๋Š” ์•Š์ง€๋งŒ(๊ต์ฒด ๋ฐฉ์‹) ๋จผ์ € ์ €์žฅํ•œ ์ชฝ์˜ ๋ณ€๊ฒฝ์€ ์‚ฌ๋ผ์งˆ ์ˆ˜ ์žˆ์œผ๋‹ˆ ํ•œ ๋ฒˆ์— ํ•˜๋‚˜๋งŒ ์‹คํ–‰ํ•˜์„ธ์š”. ์ž ๊ธˆ์ด ํ•„์š”ํ•œ ๊ทœ๋ชจ๋ผ๋ฉด 11์žฅ์˜ SQLite ์ „ํ™˜์•ˆ์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.

5. ํŒŒ์ผ ๊ตฌ์กฐ

python-quiz-game/
โ”œโ”€โ”€ main.py              # ์‹คํ–‰ ์ง„์ž…์ : StateStorage์™€ QuizGame์„ ๋งŒ๋“ค์–ด ๊ฒŒ์ž„ ์‹œ์ž‘
โ”œโ”€โ”€ quiz.py              # Quiz ํด๋ž˜์Šค: ํ€ด์ฆˆ 1๋ฌธ์ œ (์ถœ๋ ฅ, ์ •๋‹ต ํ™•์ธ, ๋”•์…”๋„ˆ๋ฆฌ ๋ณ€ํ™˜/๊ฒ€์ฆ)
โ”œโ”€โ”€ quiz_game.py         # QuizGame ํด๋ž˜์Šค: ๋ฉ”๋‰ด์™€ ๊ฒŒ์ž„ ์ „์ฒด ํ๋ฆ„ (ํ’€๊ธฐ/์ถ”๊ฐ€/๋ชฉ๋ก/์ ์ˆ˜/์‚ญ์ œ/๊ธฐ๋ก)
โ”œโ”€โ”€ storage.py           # StateStorage ํด๋ž˜์Šค: state.json ์ฝ๊ธฐยท์“ฐ๊ธฐยทํ˜•์‹ ๊ฒ€์ฆยท๋ฐฑ์—…
โ”œโ”€โ”€ input_utils.py       # ๊ณตํ†ต ์ž…๋ ฅ ํ•จ์ˆ˜: ์ˆซ์ž/๋ฌธ์ž์—ด/yยทn ์ž…๋ ฅ ๊ฒ€์ฆ
โ”œโ”€โ”€ default_quizzes.py   # ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๋ฌธ์ œ (Python & Git ๊ธฐ์ดˆ)
โ”œโ”€โ”€ tests/               # ๋‹จ์œ„ ํ…Œ์ŠคํŠธ 48๊ฐœ (python -m unittest discover -s tests -v)
โ”‚   โ”œโ”€โ”€ helpers.py           # ๊ฐ€์งœ ์ €์žฅ์†Œ, ์ž…๋ ฅ ํ‰๋‚ด ๋‚ด๊ธฐ
โ”‚   โ”œโ”€โ”€ test_input_utils.py  # ์ž…๋ ฅ ๊ฒ€์ฆ
โ”‚   โ”œโ”€โ”€ test_quiz.py         # Quiz ํด๋ž˜์Šค, ๊ธฐ๋ณธ ํ€ด์ฆˆ ๋ฐ์ดํ„ฐ
โ”‚   โ”œโ”€โ”€ test_scoring.py      # ์ ์ˆ˜ ๊ณ„์‚ฐ, ํžŒํŠธ, ์ตœ๊ณ  ์ ์ˆ˜, ๊ธฐ๋ก
โ”‚   โ”œโ”€โ”€ test_storage.py      # state.json ์ €์žฅยท๋ถˆ๋Ÿฌ์˜ค๊ธฐยท์†์ƒ ๋ณต๊ตฌ
โ”‚   โ””โ”€โ”€ test_exit.py         # main.py๋ฅผ ์‹ค์ œ ์‹คํ–‰ํ•ด ์ข…๋ฃŒ ๊ฒฝ๋กœ(๋ฉ”๋‰ด, Ctrl+C, SIGTERM) ํ™•์ธ
โ”œโ”€โ”€ tools/
โ”‚   โ””โ”€โ”€ benchmark.py     # ํ€ด์ฆˆ 1,000~100,000๊ฐœ ์„ฑ๋Šฅ ์ธก์ • (11์žฅ)
โ”œโ”€โ”€ docs/
โ”‚   โ””โ”€โ”€ screenshots/     # ์‹คํ–‰ ํ™”๋ฉด ์บก์ฒ˜, Git ๊ทธ๋ž˜ํ”„ ์บก์ฒ˜
โ”œโ”€โ”€ Dockerfile           # Docker ์ด๋ฏธ์ง€ ์„ค๊ณ„๋„ (Python 3.12.16 + ๊ฒŒ์ž„ ์ฝ”๋“œ)
โ”œโ”€โ”€ compose.yaml         # Docker Compose ์„ค์ • (์ž…๋ ฅ ์—ฐ๊ฒฐ, ๋ฐ์ดํ„ฐ ๋ณผ๋ฅจ)
โ”œโ”€โ”€ .dockerignore        # ์ด๋ฏธ์ง€์— ๋„ฃ์ง€ ์•Š์„ ํŒŒ์ผ ๋ชฉ๋ก
โ”œโ”€โ”€ .github/workflows/
โ”‚   โ””โ”€โ”€ docker.yml       # pushยทPR๋งˆ๋‹ค Docker ๋นŒ๋“œยท์‹คํ–‰์„ ์ž๋™ ๊ฒ€์‚ฌ (GitHub Actions)
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ state.json           # ์‹คํ–‰ํ•˜๋ฉด ์ž๋™ ์ƒ์„ฑ (Git์—๋Š” ์˜ฌ๋ฆฌ์ง€ ์•Š์Œ)

ํด๋ž˜์Šค ์—ญํ• 

main.py
  โ””โ”€ QuizGame(storage)            ๊ฒŒ์ž„ ์ง„ํ–‰ ๋‹ด๋‹น โ€” "๋ฌด์—‡์„ ํ• ์ง€"
       โ”œโ”€ quizzes: [Quiz, ...]    ๋ฌธ์ œ ๋ฐ์ดํ„ฐ โ€” "๋ฌธ์ œ ํ•˜๋‚˜๊ฐ€ ํ•  ์ค„ ์•„๋Š” ๊ฒƒ"
       โ”œโ”€ storage: StateStorage   ํŒŒ์ผ ๋‹ด๋‹น โ€” "์–ด๋–ป๊ฒŒ ์ €์žฅํ• ์ง€"
       โ””โ”€ input_utils ํ•จ์ˆ˜๋“ค       ์ž…๋ ฅ ๊ฒ€์ฆ ๋‹ด๋‹น
  • QuizGame์€ ํŒŒ์ผ์ด ์–ด๋–ค ํ˜•์‹์œผ๋กœ ์ €์žฅ๋˜๋Š”์ง€ ๋ชฐ๋ผ๋„ ๋˜๊ณ , StateStorage๋Š” ๊ฒŒ์ž„ ๊ทœ์น™์„ ๋ชฐ๋ผ๋„ ๋ฉ๋‹ˆ๋‹ค. ์ €์žฅ ๋ฐฉ์‹์„ ๋ฐ”๊พธ๋”๋ผ๋„ storage.py๋งŒ ๊ณ ์น˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.

ํด๋ž˜์Šคยทํ•จ์ˆ˜๋ณ„ ํ•ต์‹ฌ ๋ฉ”์„œ๋“œ (์ž…๋ ฅ โ†’ ์ถœ๋ ฅ)

ํด๋ž˜์Šค / ๋ชจ๋“ˆ ๋ฉ”์„œ๋“œ ์ž…๋ ฅ โ†’ ์ถœ๋ ฅ ์ฑ…์ž„
Quiz Quiz(question, choices, answer, hint="") ๋ฌธ์ œ str, ์„ ํƒ์ง€ list[str] 4๊ฐœ, ์ •๋‹ต int 1~4, ํžŒํŠธ str โ†’ ๊ฐ์ฒด ๋ฌธ์ œ 1๊ฐœ์˜ ๋ฐ์ดํ„ฐ ๋ณด๊ด€
display(number) ํ™”๋ฉด ๋ฒˆํ˜ธ int โ†’ ์—†์Œ (์ถœ๋ ฅ) ๋ฌธ์ œ์™€ ์„ ํƒ์ง€๋ฅผ ๋ฒˆํ˜ธ์™€ ํ•จ๊ป˜ ์ถœ๋ ฅ
is_correct(choice_number) ๊ณ ๋ฅธ ๋ฒˆํ˜ธ int โ†’ bool ์ •๋‹ต ์—ฌ๋ถ€ ํŒ๋‹จ
to_dict() / Quiz.from_dict(data) Quiz โ†” dict ์ €์žฅ์šฉ ๋ณ€ํ™˜. from_dict๋Š” ํ˜•์‹์ด ํ‹€๋ฆฌ๋ฉด ValueError
QuizGame run() ์—†์Œ โ†’ ์—†์Œ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ โ†’ ๋ฉ”๋‰ด ๋ฐ˜๋ณต โ†’ ์ €์žฅ ํ›„ ์ข…๋ฃŒ. Ctrl+Cยท์ž…๋ ฅ ์ข…๋ฃŒยทSIGTERM์„ ํ•œ๊ณณ์—์„œ ์ฒ˜๋ฆฌ
play_quiz(), add_quiz(), list_quizzes(), show_score(), delete_quiz(), show_history() ์—†์Œ โ†’ ์—†์Œ ๋ฉ”๋‰ด 1~6 ๊ธฐ๋Šฅ. ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ”๊พธ๋Š” ๊ธฐ๋Šฅ์€ ๋์—์„œ save_state() ํ˜ธ์ถœ
load_state() ์—†์Œ โ†’ ์ฒซ ํ™”๋ฉด ์•ˆ๋‚ด str StateStorage.load() ๊ฒฐ๊ณผ(์ •์ƒยท์—†์Œยท์†์ƒยท์ฝ๊ธฐ ๋ถˆ๊ฐ€)์— ๋”ฐ๋ผ ๋ฐ์ดํ„ฐ ์ค€๋น„
save_state() ์—†์Œ โ†’ bool (์„ฑ๊ณต ์—ฌ๋ถ€) StateStorage.save() ํ˜ธ์ถœ, ์‹คํŒจํ•˜๋ฉด ์•ˆ๋‚ด๋งŒ ํ•˜๊ณ  ๊ฒŒ์ž„ ๊ณ„์†
StateStorage load() ์—†์Œ โ†’ (์ƒํƒœ, ๋ฐ์ดํ„ฐ) ์ƒํƒœ๋Š” "loaded"ยท"missing"ยท"corrupted"ยท"error", ๋ฐ์ดํ„ฐ๋Š” {"quizzes": [Quiz], "best_score": int ๋˜๋Š” None, "history": [dict]} ๋˜๋Š” None
save(quizzes, best_score, history) ํ€ด์ฆˆ ๋ชฉ๋ก, ์ตœ๊ณ  ์ ์ˆ˜, ๊ธฐ๋ก โ†’ ์—†์Œ ์ž„์‹œ ํŒŒ์ผ์— ์“ฐ๊ณ  os.replace๋กœ ๊ต์ฒด. ์‹คํŒจํ•˜๋ฉด OSError
backup_corrupted_file() ์—†์Œ โ†’ bool ์†์ƒ ํŒŒ์ผ์„ state.json.bak์œผ๋กœ ๋ณต์‚ฌ
input_utils parse_int(raw, min_value, max_value) ์ž…๋ ฅ ๋ฌธ์ž์—ด โ†’ (์ •์ˆ˜, None) ๋˜๋Š” (None, ์•ˆ๋‚ด ๋ฌธ๊ตฌ) ๊ณต๋ฐฑ ์ œ๊ฑฐ, ๋นˆ ์ž…๋ ฅยท์ˆซ์ž ์•„๋‹˜ยท๋ฒ”์œ„ ๋ฐ– ํŒ๋ณ„ (ํ™”๋ฉด ์ž…์ถœ๋ ฅ ์—†์Œ โ†’ ํ…Œ์ŠคํŠธํ•˜๊ธฐ ์‰ฌ์›€)
read_int(), read_text(), read_yes_no() ์•ˆ๋‚ด ๋ฌธ๊ตฌ โ†’ int / str / bool ์˜ฌ๋ฐ”๋ฅธ ๊ฐ’์ด ๋“ค์–ด์˜ฌ ๋•Œ๊นŒ์ง€ ๋‹ค์‹œ ๋ฌป๊ธฐ

ํ˜ธ์ถœ ํ๋ฆ„ (์ž…๋ ฅ โ†’ ๊ฒŒ์ž„ โ†’ ์ €์žฅ)

๋ฉ”๋‰ด 2. ํ€ด์ฆˆ ์ถ”๊ฐ€๋ฅผ ์˜ˆ๋กœ ๋“ค๋ฉด ๋‹ค์Œ ์ˆœ์„œ๋กœ ํ˜ธ์ถœ๋ฉ๋‹ˆ๋‹ค.

[ํ‚ค๋ณด๋“œ] "2"
   โ”‚
   โ–ผ
input_utils.read_int("์„ ํƒ: ", 1, 7) โ”€โ”€(abc, 9, ๋นˆ ์ž…๋ ฅ)โ”€โ”€โ–ถ ์•ˆ๋‚ด ํ›„ ๋‹ค์‹œ ์ž…๋ ฅ
   โ”‚ 2
   โ–ผ
QuizGame.handle_menu(2) โ”€โ–ถ QuizGame.add_quiz()
   โ”‚   read_text() / read_int()๋กœ ๋ฌธ์ œยท์„ ํƒ์ง€ 4๊ฐœยท์ •๋‹ต ์ž…๋ ฅ โ†’ Quiz(...) ์ƒ์„ฑ โ†’ self.quizzes์— ์ถ”๊ฐ€
   โ–ผ
QuizGame.save_state() โ”€โ”€(can_save๊ฐ€ False)โ”€โ”€โ–ถ ์ €์žฅํ•˜์ง€ ์•Š์Œ (์›๋ณธ ๋ณดํ˜ธ)
   โ”‚ quizzes, best_score, history
   โ–ผ
StateStorage.save() โ”€โ–ถ state.json.tmp์— ์“ฐ๊ธฐ โ”€โ–ถ os.replace() โ”€โ–ถ state.json
   โ””โ”€โ”€(OSError)โ”€โ”€โ–ถ save_state()๊ฐ€ "โš ๏ธ ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค" ์ถœ๋ ฅ, ๊ฒŒ์ž„์€ ๊ณ„์†
์‹œ์  ํ˜ธ์ถœ ์ˆœ์„œ
์‹œ์ž‘ main() โ†’ QuizGame(StateStorage(๊ฒฝ๋กœ)).run() โ†’ load_state() โ†’ StateStorage.load() โ†’ ์ƒํƒœ๋ณ„ ์ฒ˜๋ฆฌ โ†’ ๋ฉ”๋‰ด
์ข…๋ฃŒ ๋ฉ”๋‰ด 7 / Ctrl+C / Ctrl+DยทCtrl+Z / SIGTERM โ†’ run()์˜ ๋ฐ˜๋ณต ํƒˆ์ถœ ๋˜๋Š” except โ†’ save_state() โ†’ ์ข…๋ฃŒ ๋ฉ”์‹œ์ง€

์ €์žฅ ๋ฐฉ์‹์„ ๋ฐ”๊พธ๊ณ  ์‹ถ์„ ๋•Œ (ํ™•์žฅ ์‹œ๋‚˜๋ฆฌ์˜ค)

๋ฐ”๊พธ๋ ค๋Š” ๊ฒƒ ๊ณ ์น  ๊ณณ ๊ทธ๋Œ€๋กœ์ธ ๊ณณ
ํŒŒ์ผ ํ˜•์‹๋งŒ ๋ณ€๊ฒฝ (์˜ˆ: ํ€ด์ฆˆ ํŒŒ์ผ๊ณผ ๊ธฐ๋ก ํŒŒ์ผ ๋ถ„๋ฆฌ, ๋“ค์—ฌ์“ฐ๊ธฐ ์—†๋Š” JSON) load()/save() ์•ฝ์†์„ ์ง€ํ‚ค๋Š” ์ƒˆ ์ €์žฅ ํด๋ž˜์Šค ์ž‘์„ฑ, main.py์—์„œ ๋ฐ”๊ฟ” ๋ผ์šฐ๊ธฐ QuizGame, Quiz, input_utils
SQLite ๊ฐ™์€ DB๋กœ ์ „ํ™˜ (ํ€ด์ฆˆ ์ˆ˜๋งŒ ๊ฐœ ์ด์ƒ) ์ €์žฅ ํด๋ž˜์Šค๋ฅผ add/delete/page/search/sample ๋‹จ์œ„๋กœ ๋ฐ”๊พธ๊ณ , QuizGame์˜ ๋ชฉ๋กยท์‚ญ์ œยท์ถœ์ œ๊ฐ€ ์ „์ฒด ๋ชฉ๋ก ๋Œ€์‹  ์ด ๋ฉ”์„œ๋“œ๋ฅผ ํ˜ธ์ถœํ•˜๋„๋ก ์ˆ˜์ • Quiz, input_utils, ๋ฉ”๋‰ด ๊ตฌ์„ฑ

DB ์ „ํ™˜์ด ์™œ, ์–ธ์ œ ํ•„์š”ํ•œ์ง€๋Š” 11์žฅ์— ์‹ค์ธก๊ฐ’๊ณผ ํ•จ๊ป˜ ์ •๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

6. ๋ฐ์ดํ„ฐ ํŒŒ์ผ ์„ค๋ช… (state.json)

ํ•ญ๋ชฉ ๋‚ด์šฉ
๊ฒฝ๋กœ ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ (main.py์™€ ๊ฐ™์€ ํด๋”). main.py ์œ„์น˜๋ฅผ ๊ธฐ์ค€์œผ๋กœ ๊ฒฝ๋กœ๋ฅผ ๋งŒ๋“ค๊ธฐ ๋•Œ๋ฌธ์— ์–ด๋А ํด๋”์—์„œ ์‹คํ–‰ํ•ด๋„ ๊ฐ™์€ ํŒŒ์ผ์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ํ™˜๊ฒฝ ๋ณ€์ˆ˜ QUIZ_STATE_PATH๋ฅผ ์ง€์ •ํ•˜๋ฉด ๊ทธ ๊ฒฝ๋กœ๋ฅผ ์”๋‹ˆ๋‹ค. Docker๋Š” ์ด ๊ฐ’์„ /data/state.json(๋ณผ๋ฅจ)์œผ๋กœ ์ง€์ •ํ•ฉ๋‹ˆ๋‹ค. (9-4 ์ฐธ๊ณ )
์—ญํ•  ํ€ด์ฆˆ ๋ชฉ๋ก, ์ตœ๊ณ  ์ ์ˆ˜, ๊ฒŒ์ž„ ๊ธฐ๋ก์„ ์ €์žฅํ•ด ํ”„๋กœ๊ทธ๋žจ์„ ๋‹ค์‹œ ์‹คํ–‰ํ•ด๋„ ์œ ์ง€๋˜๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
์ธ์ฝ”๋”ฉ UTF-8 (ensure_ascii=False๋กœ ํ•œ๊ธ€์„ ๊ทธ๋Œ€๋กœ ์ €์žฅ)
JSON์„ ๊ณ ๋ฅธ ์ด์œ  ํ€ด์ฆˆ ๋ชฉ๋ก(list)๊ณผ ์ด๋ฆ„ ๋ถ™์€ ๊ฐ’(dict)์„ ๊ตฌ์กฐ ๊ทธ๋Œ€๋กœ ์ €์žฅยท๋ณต์›ํ•  ์ˆ˜ ์žˆ๊ณ , indent=4๋กœ ์ €์žฅํ•ด ์‚ฌ๋žŒ์ด ๋ฉ”๋ชจ์žฅ์œผ๋กœ ์—ด์–ด๋„ ์ฝ๊ธฐ ์‰ฌ์šฐ๋ฉฐ, ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ json๋งŒ์œผ๋กœ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. CSV๋Š” '์„ ํƒ์ง€ 4๊ฐœ' ๊ฐ™์€ ์ค‘์ฒฉ ๊ตฌ์กฐ๋ฅผ ๋‹ด๊ธฐ ์–ด๋ ต๊ณ , ์ผ๋ฐ˜ ํ…์ŠคํŠธ๋Š” ํ•ด์„ ์ฝ”๋“œ๋ฅผ ์ง์ ‘ ๋งŒ๋“ค์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
์ €์žฅ ์‹œ์  ์ฒซ ์‹คํ–‰, ํ€ด์ฆˆ ์ถ”๊ฐ€ยท์‚ญ์ œ, ํ€ด์ฆˆ ํ’€์ด ์ข…๋ฃŒ, ํ”„๋กœ๊ทธ๋žจ ์ข…๋ฃŒ(์ค‘๋‹จ ํฌํ•จ)
Git ๊ด€๋ฆฌ ๊ฐ์ž PC์˜ ํ”Œ๋ ˆ์ด ๋ฐ์ดํ„ฐ์ด๊ณ  ์‹คํ–‰ํ•  ๋•Œ๋งˆ๋‹ค ๋ฐ”๋€Œ๋ฏ€๋กœ .gitignore๋กœ ์ œ์™ธํ•ฉ๋‹ˆ๋‹ค.

์Šคํ‚ค๋งˆ

{
    "quizzes": [
        {
            "question": "print(type(3.14))์˜ ์ถœ๋ ฅ ๊ฒฐ๊ณผ๋Š”?",
            "choices": ["<class 'int'>", "<class 'float'>", "<class 'str'>", "<class 'double'>"],
            "answer": 2,
            "hint": "์†Œ์ˆ˜์ ์ด ์žˆ๋Š” ์ˆ˜๋ฅผ '๋ถ€๋™์†Œ์ˆ˜์ (floating point) ์ˆ˜'๋ผ๊ณ  ๋ถ€๋ฆ…๋‹ˆ๋‹ค."
        }
    ],
    "best_score": 80,
    "history": [
        {
            "played_at": "2026-11-07 14:03:12",
            "total": 5,
            "correct": 4,
            "hints_used": 0,
            "score": 80
        }
    ]
}
ํ‚ค ํƒ€์ž… ์„ค๋ช…
quizzes list ํ€ด์ฆˆ ๋ชฉ๋ก (ํ•„์ˆ˜)
quizzes[].question str ๋ฌธ์ œ (๋นˆ ๋ฌธ์ž์—ด ๋ถˆ๊ฐ€)
quizzes[].choices list[str] ์„ ํƒ์ง€ 4๊ฐœ
quizzes[].answer int ์ •๋‹ต ๋ฒˆํ˜ธ 1~4 (์„ ํƒ์ง€ ์ˆœ์„œ ๊ธฐ์ค€)
quizzes[].hint str ํžŒํŠธ, ์—†์œผ๋ฉด "" (์ƒ๋žต ๊ฐ€๋Šฅ)
best_score int ๋˜๋Š” null ์ตœ๊ณ  ์ ์ˆ˜ 0~100, ์•„์ง ํ’€์ง€ ์•Š์•˜์œผ๋ฉด null
history list ๊ฒŒ์ž„ ๊ธฐ๋ก (์ƒ๋žต ๊ฐ€๋Šฅ, ์˜ค๋ž˜๋œ ๊ธฐ๋ก๋ถ€ํ„ฐ ์ˆœ์„œ๋Œ€๋กœ)
history[].played_at str ๊ฒŒ์ž„์„ ๋งˆ์นœ ์ผ์‹œ YYYY-MM-DD HH:MM:SS
history[].total / correct int ํ‘ผ ๋ฌธ์ œ ์ˆ˜ / ๋งžํžŒ ๋ฌธ์ œ ์ˆ˜
history[].hints_used int ํžŒํŠธ๋ฅผ ๋ณธ ๋ฌธ์ œ ์ˆ˜
history[].score int ๊ทธ ๊ฒŒ์ž„์˜ ์ ์ˆ˜

ํ•จ๊ป˜ ์ƒ๊ธฐ๋Š” ํŒŒ์ผ

  • state.json.bak โ€” state.json์ด ์†์ƒ๋˜์—ˆ์„ ๋•Œ ๋ณต๊ตฌ ์ง์ „์— ์›๋ณธ์„ ๋ณต์‚ฌํ•ด ๋‘” ๋ฐฑ์—… ํŒŒ์ผ (1๊ฐœ๋งŒ ์œ ์ง€, ๋ณต๊ตฌ ์ ˆ์ฐจ ์ฐธ๊ณ )
  • state.json.tmp โ€” ์ €์žฅํ•  ๋•Œ ์ž ๊น ์“ฐ๋Š” ์ž„์‹œ ํŒŒ์ผ. ๋‚ด์šฉ์„ ๋๊นŒ์ง€ ์“ด ๋’ค os.replace()๋กœ state.json๊ณผ ๊ต์ฒดํ•˜๋ฏ€๋กœ, ์ €์žฅ ๋„์ค‘ ํ”„๋กœ๊ทธ๋žจ์ด ๋ฉˆ์ถฐ๋„ ๊ธฐ์กด ํŒŒ์ผ์ด ๋ฐ˜์ฏค ์“ฐ์ธ ์ฑ„๋กœ ๋ง๊ฐ€์ง€์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

7. ์‹คํ–‰ ํ™”๋ฉด

์‹คํ–‰ ๋กœ๊ทธ (์‹œ์ž‘ โ†’ ์ข…๋ฃŒ)

์ฒ˜์Œ ์‹คํ–‰ํ•ด์„œ ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•œ ํ™”๋ฉด๊ณผ, ๋‹ค์‹œ ์‹คํ–‰ํ•ด์„œ Ctrl+C๋กœ ์ข…๋ฃŒํ•œ ํ™”๋ฉด์ž…๋‹ˆ๋‹ค. (python main.py, 2026-11-10 ์บก์ฒ˜)

$ python main.py
========================================
        ๐ŸŽฏ ๋‚˜๋งŒ์˜ ํ€ด์ฆˆ ๊ฒŒ์ž„ ๐ŸŽฏ
========================================
๐Ÿ“‚ ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๊ฐ€ ์—†์–ด ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๊ฐœ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
========================================
1. ํ€ด์ฆˆ ํ’€๊ธฐ
2. ํ€ด์ฆˆ ์ถ”๊ฐ€
3. ํ€ด์ฆˆ ๋ชฉ๋ก
4. ์ ์ˆ˜ ํ™•์ธ
5. ํ€ด์ฆˆ ์‚ญ์ œ
6. ๊ฒŒ์ž„ ๊ธฐ๋ก
7. ์ข…๋ฃŒ
========================================
์„ ํƒ: 7

๐Ÿ‘‹ ๊ฒŒ์ž„์„ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ์— ๋˜ ๋งŒ๋‚˜์š”!

$ python main.py
========================================
        ๐ŸŽฏ ๋‚˜๋งŒ์˜ ํ€ด์ฆˆ ๊ฒŒ์ž„ ๐ŸŽฏ
========================================
๐Ÿ“‚ ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถˆ๋Ÿฌ์™”์Šต๋‹ˆ๋‹ค. (ํ€ด์ฆˆ 8๊ฐœ, ์ตœ๊ณ ์ ์ˆ˜ ์—†์Œ)
========================================
1. ํ€ด์ฆˆ ํ’€๊ธฐ
   โ€ฆ (๋ฉ”๋‰ด ์ƒ๋žต) โ€ฆ
7. ์ข…๋ฃŒ
========================================
์„ ํƒ: ^C

โš ๏ธ ์ž…๋ ฅ์ด ์ค‘๋‹จ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ๋ฐ์ดํ„ฐ๋ฅผ ์ €์žฅํ•˜๊ณ  ์•ˆ์ „ํ•˜๊ฒŒ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค.
๐Ÿ‘‹ ๊ฒŒ์ž„์„ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ์— ๋˜ ๋งŒ๋‚˜์š”!

๊ธฐ๋Šฅ๋ณ„ ํ™”๋ฉด

์•„๋ž˜ ์บก์ฒ˜๋Š” ์‹ค์ œ ํ„ฐ๋ฏธ๋„(pty)์—์„œ python main.py๋ฅผ ์‹คํ–‰ํ•˜๊ณ  ์ž…๋ ฅ์„ ๋ณด๋‚ด ํ™”๋ฉด์„ ๊ทธ๋Œ€๋กœ ์ €์žฅํ•œ ๊ฒƒ์ž…๋‹ˆ๋‹ค. (Python 3.13, 2026-11-07 ์บก์ฒ˜, ์‚ฌ์šฉ์ž๊ฐ€ ์ž…๋ ฅํ•œ ๊ฐ’์€ ์ดˆ๋ก์ƒ‰)

๋ฉ”๋‰ด / ์ž˜๋ชป๋œ ์ž…๋ ฅ ์ฒ˜๋ฆฌ ํ€ด์ฆˆ ์ถ”๊ฐ€
๋ฉ”๋‰ด ํ€ด์ฆˆ ์ถ”๊ฐ€
ํ€ด์ฆˆ ํ’€๊ธฐ (ํžŒํŠธยท์˜ค๋‹ต ํฌํ•จ) ํ€ด์ฆˆ ๋ชฉ๋ก
ํ€ด์ฆˆ ํ’€๊ธฐ ํ€ด์ฆˆ ๋ชฉ๋ก
์žฌ์‹คํ–‰ ํ›„ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ + ์ ์ˆ˜ ํ™•์ธ ๊ฒŒ์ž„ ๊ธฐ๋ก Ctrl+C ์•ˆ์ „ ์ข…๋ฃŒ
์ ์ˆ˜ ํ™•์ธ ๊ฒŒ์ž„ ๊ธฐ๋ก ์•ˆ์ „ ์ข…๋ฃŒ

8. Git ์ž‘์—… ํ๋ฆ„

8-1. ์›๊ฒฉ ์ €์žฅ์†Œยท์ปค๋ฐ‹ยท๋ธŒ๋žœ์น˜ ์ฆ๋น™

ํ•ญ๋ชฉ ๋‚ด์šฉ (ํด๋ฆญํ•ด์„œ GitHub์—์„œ ์ง์ ‘ ํ™•์ธ)
์›๊ฒฉ ์ €์žฅ์†Œ https://github.com/buildergarlic/python-quiz-game
์ปค๋ฐ‹ ์ด๋ ฅ https://github.com/buildergarlic/python-quiz-game/commits/main
๋ธŒ๋žœ์น˜ ๋ชฉ๋ก https://github.com/buildergarlic/python-quiz-game/branches โ€” main, feature/play-quiz, feature/bonus, feature/eval-improvements
๋ธŒ๋žœ์น˜ยท๋ณ‘ํ•ฉ ๊ทธ๋ž˜ํ”„ https://github.com/buildergarlic/python-quiz-game/network
์ปค๋ฐ‹ ์ˆ˜ ๋ณ‘ํ•ฉ์„ ๋บ€ ์ปค๋ฐ‹ 28๊ฐœ (์š”๊ตฌ ๊ธฐ์ค€ 10๊ฐœ ์ด์ƒ), --no-ff ๋ณ‘ํ•ฉ ์ปค๋ฐ‹ 4๊ฐœ (์•„๋ž˜ ์ถœ๋ ฅ ๊ธฐ์ค€)

์•„๋ž˜๋Š” ์ด ์ฆ๋น™์„ ์ถ”๊ฐ€ํ•˜๊ธฐ ์ง์ „(2026-11-10)์˜ ์‹ค์ œ ์ถœ๋ ฅ์ž…๋‹ˆ๋‹ค. ์ดํ›„ ์ปค๋ฐ‹์€ ์œ„ ๋งํฌ์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

$ git remote -v
origin	https://github.com/buildergarlic/python-quiz-game (fetch)
origin	https://github.com/buildergarlic/python-quiz-game (push)

$ git branch -a
  feature/bonus
  feature/eval-improvements
  feature/play-quiz
* main
  remotes/origin/feature/bonus
  remotes/origin/feature/eval-improvements
  remotes/origin/feature/play-quiz
  remotes/origin/main

$ git rev-list --count --no-merges main   # ๋ณ‘ํ•ฉ์„ ๋บ€ ์ปค๋ฐ‹ ์ˆ˜
28

$ git rev-list --count --merges main      # ๋ณ‘ํ•ฉ ์ปค๋ฐ‹ ์ˆ˜
4

$ git log --oneline --graph
*   f4d25b6 Merge branch 'feature/eval-improvements'
|\  
| * 461cda3 Docs: ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ๋ถ„์„, ํ…Œ์ŠคํŠธ, ํด๋ž˜์Šค ๊ณ„์•ฝ, ํ˜ธ์ถœ ํ๋ฆ„, ๋ณต๊ตฌ ์ ˆ์ฐจ ๋ณด๊ฐ•
| * 246544f CI: Docker ๊ฒ€์‚ฌ์— ๋‹จ์œ„ ํ…Œ์ŠคํŠธ์™€ ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ์ธก์ • ์ถ”๊ฐ€
| * 6f8ed1b Chore: ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ์„ฑ๋Šฅ ์ธก์ • ์Šคํฌ๋ฆฝํŠธ ์ถ”๊ฐ€ (tools/benchmark.py)
| * 5b88aac Test: ๋‹จ์œ„ ํ…Œ์ŠคํŠธ 48๊ฐœ ์ถ”๊ฐ€ (์ž…๋ ฅ ๊ฒ€์ฆ, ์ ์ˆ˜ ๊ณ„์‚ฐ, ์ €์žฅ/๋ณต๊ตฌ, ์ข…๋ฃŒ ๊ฒฝ๋กœ)
| * 50a7132 Feat: ์ข…๋ฃŒ ์š”์ฒญ(SIGTERM)๋„ ์ €์žฅ ํ›„ ์•ˆ์ „ ์ข…๋ฃŒํ•˜๋„๋ก ์ฒ˜๋ฆฌ
| * 4d9b346 Refactor: StateStorage ์ €์žฅยท๋ถˆ๋Ÿฌ์˜ค๊ธฐ ์ˆœ์„œ๋ฅผ ๋‹จ๊ณ„๋ณ„ ์ฃผ์„์œผ๋กœ ์ •๋ฆฌ
|/  
* 494c77c Docs: README์— Docker ์‹คํ–‰ ๊ฐ€์ด๋“œ ์ถ”๊ฐ€
* 9d142c4 CI: pushยทPR๋งˆ๋‹ค Docker ์žฌํ˜„์„ฑ ์ž๋™ ๊ฒ€์‚ฌ (GitHub Actions)
* 07f0485 Feat: Docker ์‹คํ–‰ ํ™˜๊ฒฝ ๊ตฌ์„ฑ (Dockerfile, compose.yaml, .dockerignore)
* 76a15af Docs: README ์‹คํ–‰ ๋ฐฉ๋ฒ•์˜ clone ์ฃผ์†Œ๋ฅผ ์‹ค์ œ ์ €์žฅ์†Œ ์ฃผ์†Œ๋กœ ์ˆ˜์ •
*   373aac4 Merge: GitHub ์›๊ฒฉ ์ €์žฅ์†Œ ์ดˆ๊ธฐ ์ปค๋ฐ‹๊ณผ ๋กœ์ปฌ ์ด๋ ฅ ๋ณ‘ํ•ฉ
|\  
| * 6a29bf8 Initial commit
* 196e429 Docs: README ์ž‘์„ฑ (๊ฐœ์š”, ์ฃผ์ œ ์„ ์ • ์ด์œ , ์‹คํ–‰ ๋ฐฉ๋ฒ•, ๊ธฐ๋Šฅ, ํŒŒ์ผ ๊ตฌ์กฐ, state.json ์„ค๋ช…)
* 6f8a92d Docs: ์‹คํ–‰ ํ™”๋ฉด ์Šคํฌ๋ฆฐ์ƒท ์ถ”๊ฐ€
*   d5a9f6a Merge branch 'feature/bonus'
|\  
| * 5869dbc Feat: ๊ฒŒ์ž„ ๊ธฐ๋ก ํžˆ์Šคํ† ๋ฆฌ ์ €์žฅ ๋ฐ ์กฐํšŒ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ (๋ณด๋„ˆ์Šค)
| * 850e16c Feat: ํ€ด์ฆˆ ์‚ญ์ œ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ (๋ณด๋„ˆ์Šค)
| * df942bf Feat: ํžŒํŠธ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ (ํžŒํŠธ๋ฅผ ๋ณด๊ณ  ๋งžํžˆ๋ฉด ์ ˆ๋ฐ˜ ์ ์ˆ˜)
| * f8ebdc9 Feat: ๋žœ๋ค ์ถœ์ œ ๋ฐ ํ’€ ๋ฌธ์ œ ์ˆ˜ ์„ ํƒ ๊ธฐ๋Šฅ ์ถ”๊ฐ€ (๋ณด๋„ˆ์Šค)
|/  
* 6b341b2 Refactor: QuizGame ์ฑ…์ž„ ๋ถ„๋ฆฌ (๋ฌธ์ œ ์ถœ์ œยท์ •๋‹ต ์ž…๋ ฅยท๊ฒฐ๊ณผ ์ฒ˜๋ฆฌ ๋ฉ”์„œ๋“œ ๋ถ„๋ฆฌ)
* eb7c1ef Feat: state.json ์ €์žฅ/๋ถˆ๋Ÿฌ์˜ค๊ธฐ ๊ตฌํ˜„ (ํŒŒ์ผ ์—†์Œยท์†์ƒ ๋Œ€์‘)
* 289e654 Feat: ์ตœ๊ณ  ์ ์ˆ˜ ํ™•์ธ ๋ฐ ๊ฐฑ์‹  ๊ธฐ๋Šฅ ๊ตฌํ˜„
* 76e3da1 Feat: ํ€ด์ฆˆ ๋ชฉ๋ก ๋ณด๊ธฐ ๊ธฐ๋Šฅ ๊ตฌํ˜„
* ff4d1a3 Feat: ํ€ด์ฆˆ ์ถ”๊ฐ€ ๊ธฐ๋Šฅ ๊ตฌํ˜„ (๋ฌธ์ œยท์„ ํƒ์ง€ยท์ •๋‹ต ์ž…๋ ฅ ๊ฒ€์ฆ)
*   609c113 Merge branch 'feature/play-quiz'
|\  
| * c1c4eee Feat: ํ€ด์ฆˆ ๊ฒฐ๊ณผ ํ‘œ์‹œ ๋ฐ ํ€ด์ฆˆ๊ฐ€ ์—†๋Š” ๊ฒฝ์šฐ ์ฒ˜๋ฆฌ
| * 438f79a Feat: ํ€ด์ฆˆ ํ’€๊ธฐ ๊ธฐ๋Šฅ ๊ตฌํ˜„ (์ถœ์ œ, ์ •๋‹ต ์ž…๋ ฅ, ์ •๋‹ต/์˜ค๋‹ต ์•ˆ๋‚ด)
|/  
* bd9e00b Feat: ๊ธฐ๋ณธ ํ€ด์ฆˆ ๋ฐ์ดํ„ฐ 8๊ฐœ ์ถ”๊ฐ€ (์ฃผ์ œ: Python & Git ๊ธฐ์ดˆ)
* e822db5 Feat: Quiz ํด๋ž˜์Šค ๊ตฌํ˜„ (๋ฌธ์ œ ์ถœ๋ ฅ, ์ •๋‹ต ํ™•์ธ)
* 3a6a613 Feat: ๋ฉ”์ธ ๋ฉ”๋‰ด ์ถœ๋ ฅ ๋ฐ ๋ฉ”๋‰ด ์„ ํƒ ์ž…๋ ฅ ๊ฒ€์ฆ ๊ตฌํ˜„
* 900acce Chore: ํ”„๋กœ์ ํŠธ ์ดˆ๊ธฐ ์„ค์ • (.gitignore, README.md ์ถ”๊ฐ€)

git log --graph ์บก์ฒ˜

์ง์ ‘ ํ™•์ธํ•˜๋Š” ๋ฐฉ๋ฒ•:

git clone https://github.com/buildergarlic/python-quiz-game.git
cd python-quiz-game
git log --oneline --graph --all
git rev-list --count --no-merges main

8-2. ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€ ๊ทœ์น™๊ณผ ์‹ค์ œ ์˜ˆ์‹œ

  • ๊ทœ์น™: Feat(๊ธฐ๋Šฅ), Refactor(๊ตฌ์กฐ ๊ฐœ์„ ), Test(ํ…Œ์ŠคํŠธ), Docs(๋ฌธ์„œ), CI(์ž๋™ ๊ฒ€์‚ฌ), Chore(์„ค์ •ยท๋„๊ตฌ) + ์ œ๋ชฉ์— ๋ณ€๊ฒฝ ์š”์•ฝ, ๋ณธ๋ฌธ์— ์„ธ๋ถ€ ๋ณ€๊ฒฝ ์‚ฌํ•ญ
  • ์‹ค์ œ ์ปค๋ฐ‹ ์˜ˆ์‹œ (git log -1 <ํ•ด์‹œ>๋กœ ๊ฐ™์€ ๋‚ด์šฉ์„ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค)
eb7c1ef Feat: state.json ์ €์žฅ/๋ถˆ๋Ÿฌ์˜ค๊ธฐ ๊ตฌํ˜„ (ํŒŒ์ผ ์—†์Œยท์†์ƒ ๋Œ€์‘)

- StateStorage ํด๋ž˜์Šค ์ถ”๊ฐ€: ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ state.json์„ UTF-8๋กœ ์ฝ๊ณ  ์“ฐ๊ธฐ
- ์ž„์‹œ ํŒŒ์ผ์— ์“ด ๋’ค os.replace()๋กœ ๊ต์ฒดํ•ด ์ €์žฅ ์ค‘ ํŒŒ์ผ ์†์ƒ ๋ฐฉ์ง€
- Quiz.to_dict()/from_dict(): ๊ฐ์ฒด <-> JSON ๋”•์…”๋„ˆ๋ฆฌ ๋ณ€ํ™˜ ๋ฐ ํ˜•์‹ ๊ฒ€์ฆ
- ํŒŒ์ผ ์—†์Œ: ๊ธฐ๋ณธ ํ€ด์ฆˆ๋กœ ์‹œ์ž‘ ํ›„ ์ €์žฅ
- JSON ์†์ƒ/๊ตฌ์กฐ ์˜ค๋ฅ˜: state.json.bak์œผ๋กœ ๋ฐฑ์—… ํ›„ ๊ธฐ๋ณธ ๋ฐ์ดํ„ฐ๋กœ ๋ณต๊ตฌ
- ์ฝ๊ธฐ ์˜ค๋ฅ˜: ๊ธฐ์กด ํŒŒ์ผ ๋ณดํ˜ธ๋ฅผ ์œ„ํ•ด ํ•ด๋‹น ์‹คํ–‰์—์„œ๋Š” ์ €์žฅํ•˜์ง€ ์•Š์Œ
6b341b2 Refactor: QuizGame ์ฑ…์ž„ ๋ถ„๋ฆฌ (๋ฌธ์ œ ์ถœ์ œยท์ •๋‹ต ์ž…๋ ฅยท๊ฒฐ๊ณผ ์ฒ˜๋ฆฌ ๋ฉ”์„œ๋“œ ๋ถ„๋ฆฌ)

- ๊ธธ์–ด์ง„ play_quiz()๋ฅผ ์—ญํ• ๋ณ„ ๋ฉ”์„œ๋“œ๋กœ ๋ถ„๋ฆฌ
  - _play_one(): ํ•œ ๋ฌธ์ œ ์ถœ์ œ ๋ฐ ์ •๋‹ต/์˜ค๋‹ต ์•ˆ๋‚ด
  - _ask_answer(): ์ •๋‹ต ๋ฒˆํ˜ธ ์ž…๋ ฅ
  - _finish_game(): ๊ฒฐ๊ณผ ์ถœ๋ ฅ ๋ฐ ์ €์žฅ
  - _update_best_score(): ์ตœ๊ณ  ์ ์ˆ˜ ๋น„๊ต/๊ฐฑ์‹ 
- ๋™์ž‘ ๋ณ€ํ™” ์—†์Œ
50a7132 Feat: ์ข…๋ฃŒ ์š”์ฒญ(SIGTERM)๋„ ์ €์žฅ ํ›„ ์•ˆ์ „ ์ข…๋ฃŒํ•˜๋„๋ก ์ฒ˜๋ฆฌ

- kill ๋ช…๋ นยท์„œ๋น„์Šค ๊ด€๋ฆฌ์ž๊ฐ€ ๋ณด๋‚ด๋Š” SIGTERM์„ KeyboardInterrupt๋กœ ๋ฐ”๊ฟ”
  Ctrl+C์™€ ๊ฐ™์€ '์ €์žฅ ํ›„ ์•ˆ์ „ ์ข…๋ฃŒ' ๊ฒฝ๋กœ(QuizGame.run)๋ฅผ ํƒ€๊ฒŒ ํ•จ
- ์ €์žฅ ์ค‘ SIGTERM์ด ๋‹ค์‹œ ์˜ค๋ฉด ๋ฌด์‹œํ•ด ์ €์žฅ์ด ์ค‘๊ฐ„์— ๋Š๊ธฐ์ง€ ์•Š๊ฒŒ ํ•จ

8-3. ๋ธŒ๋žœ์น˜ ์ „๋žต

  • main โ€” ํ•ญ์ƒ ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ ์ƒํƒœ ์œ ์ง€
  • feature/play-quiz โ€” ํ€ด์ฆˆ ํ’€๊ธฐ ๊ธฐ๋Šฅ ๊ฐœ๋ฐœ ํ›„ main์— ๋ณ‘ํ•ฉ (609c113)
  • feature/bonus โ€” ๋ณด๋„ˆ์Šค ๊ธฐ๋Šฅ(๋žœ๋ค, ๋ฌธ์ œ ์ˆ˜ ์„ ํƒ, ํžŒํŠธ, ์‚ญ์ œ, ๊ธฐ๋ก) ๊ฐœ๋ฐœ ํ›„ main์— ๋ณ‘ํ•ฉ (d5a9f6a)
  • feature/eval-improvements โ€” ์‚ฌ์ „ํ‰๊ฐ€ ๋ณด์™„(SIGTERM ์ฒ˜๋ฆฌ, ๋‹จ์œ„ ํ…Œ์ŠคํŠธ, ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ๋ถ„์„) ๊ฐœ๋ฐœ ํ›„ main์— ๋ณ‘ํ•ฉ (f4d25b6)
  • ๋ณ‘ํ•ฉ์€ git merge --no-ff๋กœ ์ˆ˜ํ–‰ํ•ด git log --graph์—์„œ ๋ธŒ๋žœ์น˜ ์ž‘์—… ํ”์ ์ด ๋ณด์ด๋„๋ก ํ–ˆ์Šต๋‹ˆ๋‹ค. (373aac4๋Š” GitHub์—์„œ README์™€ ํ•จ๊ป˜ ๋งŒ๋“  ์›๊ฒฉ ์ €์žฅ์†Œ์˜ ์ฒซ ์ปค๋ฐ‹๊ณผ ๋กœ์ปฌ ์ด๋ ฅ์„ ํ•ฉ์นœ ๋ณ‘ํ•ฉ์ž…๋‹ˆ๋‹ค.)

8-4. ์‚ฌ์šฉํ•œ Git ๋ช…๋ น์–ด

๋ช…๋ น์–ด ์ด ํ”„๋กœ์ ํŠธ์—์„œ ์‚ฌ์šฉํ•œ ๊ณณ
git init ํ”„๋กœ์ ํŠธ ํด๋”๋ฅผ Git ์ €์žฅ์†Œ๋กœ ๋งŒ๋“ค๊ธฐ
git add / git commit ๊ธฐ๋Šฅ ํ•˜๋‚˜๋ฅผ ์™„์„ฑํ•  ๋•Œ๋งˆ๋‹ค ๋ณ€๊ฒฝ ํŒŒ์ผ์„ ์Šคํ…Œ์ด์ง•ํ•˜๊ณ  ๊ธฐ๋ก
git checkout -b / git checkout ๊ธฐ๋Šฅ ๋ธŒ๋žœ์น˜๋ฅผ ๋งŒ๋“ค์–ด ์ด๋™, ์ž‘์—… ํ›„ main์œผ๋กœ ๋ณต๊ท€
git merge ๊ธฐ๋Šฅ ๋ธŒ๋žœ์น˜๋ฅผ main์— ๋ณ‘ํ•ฉ
git push ๋กœ์ปฌ ์ปค๋ฐ‹์„ GitHub ์›๊ฒฉ ์ €์žฅ์†Œ์— ์—…๋กœ๋“œ
git clone ์›๊ฒฉ ์ €์žฅ์†Œ๋ฅผ ๋‹ค๋ฅธ ํด๋”์— ๋ณต์ œ (๋ณต์ œ ์‹ค์Šต)
git pull ๋ณต์ œ๋ณธ์—์„œ ์˜ฌ๋ฆฐ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ๊ธฐ์กด ์ž‘์—… ํด๋”๋กœ ๊ฐ€์ ธ์˜ค๊ธฐ (๋ณต์ œ ์‹ค์Šต)

9. Docker ์‹คํ–‰ ๊ฐ€์ด๋“œ โ€” ์–ด๋–ค ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ๋„ ๋˜‘๊ฐ™์ด ์žฌํ˜„ํ•˜๊ธฐ

9-1. ์™œ Docker๋ฅผ ์“ฐ๋‚˜์š”?

  • ์ด ๊ฒŒ์ž„์„ ๊ทธ๋ƒฅ ์‹คํ–‰ํ•˜๋ ค๋ฉด PC์— Python 3.10 ์ด์ƒ์ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ๋ฐ PC๋งˆ๋‹ค OS, Python ๋ฒ„์ „, ๋ฌธ์ž ์ธ์ฝ”๋”ฉ์ด ๋‹ฌ๋ผ์„œ "๋‚ด PC์—์„œ๋Š” ๋˜๋Š”๋ฐ ๋‹ค๋ฅธ PC์—์„œ๋Š” ์•ˆ ๋˜๋Š”" ์ผ์ด ์ƒ๊น๋‹ˆ๋‹ค.
  • Docker๋Š” Linux + Python 3.12.16 + ๊ฒŒ์ž„ ์ฝ”๋“œ๋ฅผ ํ•˜๋‚˜์˜ ์ด๋ฏธ์ง€๋กœ ๋ฌถ์Šต๋‹ˆ๋‹ค. ๋ˆ„๊ฐ€ ์–ด๋–ค OS์—์„œ ์‹คํ–‰ํ•ด๋„ ์ปจํ…Œ์ด๋„ˆ ์•ˆ์€ ๋˜‘๊ฐ™์€ ํ™˜๊ฒฝ์ž…๋‹ˆ๋‹ค.
  • PC์— Python์„ ์„ค์น˜ํ•˜์ง€ ์•Š์•„๋„ ๋ฉ๋‹ˆ๋‹ค. Docker๋งŒ ์žˆ์œผ๋ฉด ๋ฉ๋‹ˆ๋‹ค.
์šฉ์–ด ๋œป
์ด๋ฏธ์ง€ ์‹คํ–‰ ํ™˜๊ฒฝ๊ณผ ์ฝ”๋“œ๋ฅผ ๋ฌถ์€ '์„ค์น˜๋ณธ'. Dockerfile๋กœ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
์ปจํ…Œ์ด๋„ˆ ์ด๋ฏธ์ง€๋ฅผ ์‹คํ–‰ํ•œ ๊ฒƒ. ๊ฒŒ์ž„ ํ•œ ๋ฒˆ = ์ปจํ…Œ์ด๋„ˆ ํ•˜๋‚˜. ๋๋‚˜๋ฉด ์ง€์›Œ๋„ ๋ฉ๋‹ˆ๋‹ค.
๋ณผ๋ฅจ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ง€์›Œ๋„ ๋‚จ๋Š” ์ €์žฅ ๊ณต๊ฐ„. state.json์„ ์—ฌ๊ธฐ์— ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค.

9-2. ์ค€๋น„๋ฌผ

OS ์„ค์น˜ํ•  ๊ฒƒ
Windows 10/11 Docker Desktop (์„ค์น˜ ์ค‘ WSL 2 ์‚ฌ์šฉ ์„ ํƒ)
macOS (Intel / Apple Silicon) Docker Desktop
Linux Docker Engine + Docker Compose ํ”Œ๋Ÿฌ๊ทธ์ธ
docker --version
docker compose version

9-3. ์‹คํ–‰ํ•˜๊ธฐ

๋ฐฉ๋ฒ• A. Docker Compose (๊ถŒ์žฅ)

git clone https://github.com/buildergarlic/python-quiz-game.git
cd python-quiz-game
docker compose build          # ์ด๋ฏธ์ง€ ๋งŒ๋“ค๊ธฐ (์ฒ˜์Œ ํ•œ ๋ฒˆ, ์ฝ”๋“œ๊ฐ€ ๋ฐ”๋€” ๋•Œ๋งˆ๋‹ค)
docker compose run --rm quiz  # ๊ฒŒ์ž„ ์‹คํ–‰
  • run --rm: ๊ฒŒ์ž„์ด ๋๋‚˜๋ฉด ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ง€์›๋‹ˆ๋‹ค. ๋ฐ์ดํ„ฐ๋Š” ๋ณผ๋ฅจ(python-quiz-game_quiz-data)์— ๋‚จ์Šต๋‹ˆ๋‹ค.
  • ์ด ๊ฒŒ์ž„์€ ํ„ฐ๋ฏธ๋„์—์„œ ํ‚ค๋ณด๋“œ ์ž…๋ ฅ์„ ์ฃผ๊ณ ๋ฐ›๊ธฐ ์œ„ํ•ด docker compose run --rm quiz๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• B. docker ๋ช…๋ น์–ด๋งŒ ์‚ฌ์šฉ

docker build -t python-quiz-game .
docker run --rm -it -v quiz-data:/data python-quiz-game
์˜ต์…˜ ๋œป
-t python-quiz-game (build) ๋งŒ๋“  ์ด๋ฏธ์ง€์— ์ด๋ฆ„์„ ๋ถ™์ž…๋‹ˆ๋‹ค.
--rm ๊ฒŒ์ž„์ด ๋๋‚˜๋ฉด ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ง€์›๋‹ˆ๋‹ค.
-it -i ํ‚ค๋ณด๋“œ ์ž…๋ ฅ + -t ํ„ฐ๋ฏธ๋„ ํ™”๋ฉด. ๋น ์ง€๋ฉด ์ž…๋ ฅํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.
-v quiz-data:/data quiz-data ๋ณผ๋ฅจ์„ ์ปจํ…Œ์ด๋„ˆ์˜ /data์— ์—ฐ๊ฒฐํ•ด state.json์„ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• A์˜ ๋ณผ๋ฅจ(python-quiz-game_quiz-data)๊ณผ ๋ฐฉ๋ฒ• B์˜ ๋ณผ๋ฅจ(quiz-data)์€ ์„œ๋กœ ๋‹ค๋ฅธ ์ €์žฅ ๊ณต๊ฐ„์ž…๋‹ˆ๋‹ค. ํ•œ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์„ ๊ณ„์† ์“ฐ์„ธ์š”.

์ข…๋ฃŒ: ๋ฉ”๋‰ด 7, Ctrl+C, ๋‹ค๋ฅธ ํ„ฐ๋ฏธ๋„์—์„œ docker stop ๋ชจ๋‘ ๋ฐ์ดํ„ฐ๋ฅผ ์ €์žฅํ•œ ๋’ค ์ •์ƒ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค. (docker stop์€ Dockerfile์˜ STOPSIGNAL SIGINT ์„ค์ •์œผ๋กœ Ctrl+C์™€ ๊ฐ™์€ ์‹ ํ˜ธ๋ฅผ ๋ณด๋ƒ…๋‹ˆ๋‹ค.)

9-4. ๋ฐ์ดํ„ฐ(state.json) ๊ด€๋ฆฌ

ํ•˜๊ณ  ์‹ถ์€ ์ผ ๋ฐฉ๋ฒ• A (Compose) ๋ฐฉ๋ฒ• B (docker)
์ €์žฅ๋œ ๋‚ด์šฉ ๋ณด๊ธฐ docker compose run --rm -T quiz cat /data/state.json docker run --rm -v quiz-data:/data python-quiz-game cat /data/state.json
๋ณผ๋ฅจ ๋ชฉ๋ก ๋ณด๊ธฐ docker volume ls docker volume ls
์ฒ˜์Œ ์ƒํƒœ๋กœ ์ดˆ๊ธฐํ™” (๋ฐ์ดํ„ฐ ์‚ญ์ œ) docker compose down -v docker volume rm quiz-data

๋‚ด PC ํด๋”์— state.json์„ ๋‘๊ณ  ์‹ถ์„ ๋•Œ (ํŒŒ์ผ์„ ์ง์ ‘ ์—ด์–ด ๋ณด๊ฑฐ๋‚˜ ๋ฐฑ์—…ํ•  ๋•Œ)

๋จผ์ € ํ”„๋กœ์ ํŠธ ํด๋” ์•ˆ์— data ํด๋”๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค: mkdir data

ํ™˜๊ฒฝ ๋ช…๋ น
macOS docker compose run --rm -v "$(pwd)/data:/data" quiz
Linux docker compose run --rm --user "$(id -u):$(id -g)" -v "$(pwd)/data:/data" quiz
Windows PowerShell docker compose run --rm -v "${PWD}/data:/data" quiz
Windows ๋ช…๋ น ํ”„๋กฌํ”„ํŠธ(cmd) docker compose run --rm -v "%cd%\data:/data" quiz
  • Linux์—์„œ --user๋ฅผ ๋ถ™์ด๋Š” ์ด์œ : ์ปจํ…Œ์ด๋„ˆ ์•ˆ ์‚ฌ์šฉ์ž(uid 1000)์™€ ํด๋” ์ฃผ์ธ์ด ๋‹ค๋ฅด๋ฉด โš ๏ธ ๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค: Permission denied๊ฐ€ ๋‚˜์˜ต๋‹ˆ๋‹ค. --user๋กœ ๋‚ด ๊ณ„์ •๊ณผ ๊ฐ™์€ ์‚ฌ์šฉ์ž๋กœ ์‹คํ–‰ํ•˜๋ฉด ํ•ด๊ฒฐ๋ฉ๋‹ˆ๋‹ค. (Docker Desktop์€ ๊ถŒํ•œ์„ ์ž๋™์œผ๋กœ ๋งž์ถฐ ์ค๋‹ˆ๋‹ค.)
  • data/state.json์€ .gitignore์˜ state.json ๊ทœ์น™ ๋•Œ๋ฌธ์— Git์— ์˜ฌ๋ผ๊ฐ€์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

9-5. ์šด์˜์ฒด์ œ๋ณ„ ์ฐจ์ด

ํ™˜๊ฒฝ ๊ฒŒ์ž„ ์‹คํ–‰ ๋ช…๋ น ํ˜„์žฌ ํด๋” ํ‘œ๊ธฐ ์ฐธ๊ณ 
macOS / Linux ํ„ฐ๋ฏธ๋„ docker compose run --rm quiz $(pwd)
Windows PowerShell / Windows Terminal (๊ถŒ์žฅ) docker compose run --rm quiz ${PWD}
Windows ๋ช…๋ น ํ”„๋กฌํ”„ํŠธ(cmd) docker compose run --rm quiz %cd% ํ•œ๊ธ€์ด ๊นจ์ง€๋ฉด chcp 65001 ์‹คํ–‰ ํ›„ ๋‹ค์‹œ ์‹œ์ž‘
Windows Git Bash winpty docker compose run --rm quiz $(pwd) ์ž…๋ ฅ์ด ์•ˆ ๋˜๋ฉด winpty๋ฅผ ์•ž์— ๋ถ™์ž…๋‹ˆ๋‹ค. ๊ถŒ์žฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • Apple Silicon(M1~M4) Mac์—์„œ๋„ ๊ทธ๋Œ€๋กœ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค. ๊ณต์‹ Python ์ด๋ฏธ์ง€๊ฐ€ arm64๋ฅผ ์ง€์›ํ•˜๊ณ , GitHub Actions์—์„œ arm64 ์‹คํ–‰์„ ๋งค๋ฒˆ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

9-6. ์žฌํ˜„ ํ™•์ธ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

์•„๋ž˜ ๊ฒฐ๊ณผ๊ฐ€ ๊ทธ๋Œ€๋กœ ๋‚˜์˜ค๋ฉด ์ด ํ”„๋กœ์ ํŠธ๊ฐ€ ์—ฌ๋Ÿฌ๋ถ„์˜ PC์—์„œ ๋˜‘๊ฐ™์ด ์žฌํ˜„๋œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

์ˆœ์„œ ๋ช…๋ น / ๋™์ž‘ ๊ธฐ๋Œ€ ๊ฒฐ๊ณผ
1 docker compose build Image python-quiz-game Built
2 docker compose run --rm -T quiz python --version Python 3.12.16
3 docker compose run --rm quiz (์ฒ˜์Œ ์‹คํ–‰) ๐Ÿ“‚ ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๊ฐ€ ์—†์–ด ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๊ฐœ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
4 ๋ฉ”๋‰ด 2๋กœ ํ€ด์ฆˆ 1๊ฐœ ์ถ”๊ฐ€ โ†’ 7 ์ข…๋ฃŒ โ†’ 3๋ฒˆ ๋ช…๋ น ๋‹ค์‹œ ์‹คํ–‰ ๐Ÿ“‚ ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถˆ๋Ÿฌ์™”์Šต๋‹ˆ๋‹ค. (ํ€ด์ฆˆ 9๊ฐœ, ...)
5 ์ž…๋ ฅ ์—†์ด ์ž๋™ ํ™•์ธ: printf '7\n' | docker compose run --rm -T quiz (PowerShell: "7" | docker compose run --rm -T quiz) ๋ฉ”๋‰ด ์ถœ๋ ฅ ํ›„ ๐Ÿ‘‹ ๊ฒŒ์ž„์„ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ์— ๋˜ ๋งŒ๋‚˜์š”!
์„ ํƒ ๋ฐ์ดํ„ฐ๋ฅผ ๋ชจ๋‘ ์ง€์šธ ๋•Œ๋งŒ ์ฒ˜์Œ ์ƒํƒœ๋กœ ๋˜๋Œ๋ฆฌ๊ธฐ: docker compose down -v Volume python-quiz-game_quiz-data Removed โ€” ํ€ด์ฆˆยท์ ์ˆ˜ยท๊ฒŒ์ž„ ๊ธฐ๋ก ์‚ญ์ œ. ์„ค์น˜ ํ™•์ธ์—๋Š” ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

9-7. ๋‹ค๋ฅธ Python ๋ฒ„์ „์œผ๋กœ ์‹คํ–‰ํ•ด ๋ณด๊ธฐ

๊ณผ์ œ ๊ธฐ์ค€ ์ตœ์†Œ ๋ฒ„์ „(Python 3.10)์—์„œ๋„ ๋˜‘๊ฐ™์ด ๋™์ž‘ํ•˜๋Š”์ง€ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

docker build --build-arg PYTHON_VERSION=3.10 -t python-quiz-game:py3.10 .
docker run --rm -it -v quiz-data:/data python-quiz-game:py3.10

9-8. ํ•จ๊ป˜ ์ž‘์—…ํ•˜๊ธฐ

์ƒํ™ฉ ํ•  ์ผ
์ฒ˜์Œ ํ”„๋กœ์ ํŠธ์— ์ฐธ์—ฌ git clone โ†’ docker compose build โ†’ docker compose run --rm quiz
๋‹ค๋ฅธ ์‚ฌ๋žŒ์ด ์ฝ”๋“œ๋ฅผ ๋ฐ”๊ฟ” pushํ•จ git pull โ†’ docker compose build โ†’ docker compose run --rm quiz (์ด๋ฏธ์ง€๋Š” ๋นŒ๋“œํ•  ๋•Œ์˜ ์ฝ”๋“œ๋ฅผ ๋‹ด๊ณ  ์žˆ์–ด์„œ, ์ฝ”๋“œ๊ฐ€ ๋ฐ”๋€Œ๋ฉด ๋‹ค์‹œ ๋นŒ๋“œํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค)
์ฝ”๋“œ๋ฅผ ๊ณ ์น˜๋ฉด์„œ ๋ฐ”๋กœ ํ™•์ธ docker compose run --rm -v "$(pwd):/app" quiz โ€” ๋‚ด ํด๋”์˜ ์ฝ”๋“œ๋ฅผ ์ปจํ…Œ์ด๋„ˆ์— ์—ฐ๊ฒฐํ•ด ๋‹ค์‹œ ๋นŒ๋“œํ•˜์ง€ ์•Š๊ณ  ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
๋ณ€๊ฒฝ ์‚ฌํ•ญ์„ ์˜ฌ๋ฆผ (push / Pull Request) GitHub Actions๊ฐ€ ์ž๋™์œผ๋กœ Docker ์ด๋ฏธ์ง€๋ฅผ ๋นŒ๋“œํ•˜๊ณ  ์‹คํ–‰ํ•ด ๋ด…๋‹ˆ๋‹ค. ์œ„ ๋ฐฐ์ง€์™€ PR์˜ ์ฒดํฌ ํ‘œ์‹œ๊ฐ€ ์ดˆ๋ก์ƒ‰์ด๋ฉด ์žฌํ˜„์„ฑ์ด ์œ ์ง€๋œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.
  • ๊ฐ์ž์˜ ํ”Œ๋ ˆ์ด ๊ธฐ๋ก(state.json)์€ ๊ฐ์ž์˜ ๋ณผ๋ฅจ์—๋งŒ ์ €์žฅ๋˜๊ณ  Git์œผ๋กœ ๊ณต์œ ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • ์ž๋™ ๊ฒ€์‚ฌ(.github/workflows/docker.yml) ๋‚ด์šฉ: ์ด๋ฏธ์ง€ ๋นŒ๋“œ, ๋‹จ์œ„ ํ…Œ์ŠคํŠธ(Python 3.12.16ยท3.10), ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ ์ธก์ • ์Šคํฌ๋ฆฝํŠธ, ์ฒซ ์‹คํ–‰, ๋ฐ์ดํ„ฐ ์œ ์ง€, docker stop ์‹œ ์ €์žฅ, Python 3.10 ๋นŒ๋“œ, Docker Compose ์‹คํ–‰, arm64 ๋นŒ๋“œยท์‹คํ–‰

9-9. ๋ฌธ์ œ ํ•ด๊ฒฐ

์ฆ์ƒ ์›์ธ ํ•ด๊ฒฐ
Cannot connect to the Docker daemon / error during connect Docker๊ฐ€ ์‹คํ–‰ ์ค‘์ด ์•„๋‹˜ Docker Desktop์„ ์‹คํ–‰ํ•˜๊ณ  ๋‹ค์‹œ ์‹œ๋„
the input device is not a TTY ํŒŒ์ดํ”„ยท์ถœ๋ ฅ ๋ฆฌ๋””๋ ‰์…˜ ๋“ฑ ์‹ค์ œ ํ„ฐ๋ฏธ๋„์ด ์•„๋‹Œ ํ™˜๊ฒฝ์—์„œ TTY๋ฅผ ์š”์ฒญํ•จ, ๋˜๋Š” ํ„ฐ๋ฏธ๋„ ํ˜ธํ™˜ ๋ฌธ์ œ ๊ฒŒ์ž„์€ PowerShell ์ฐฝ์—์„œ docker compose run --rm quiz๋ฅผ ์ง์ ‘ ์‹คํ–‰. ์ž…๋ ฅ์„ ์ „๋‹ฌํ•˜๋Š” ์ž๋™ ๊ฒ€์‚ฌ์—์„œ๋Š” -T ์‚ฌ์šฉ
๋ฉ”๋‰ด๋Š” ๋‚˜์˜ค๋Š”๋ฐ ์ž…๋ ฅ์ด ์•ˆ ๋จ -i ์˜ต์…˜์ด ๋น ์ง docker run --rm -it ...
ํ•œ๊ธ€ยท์ด๋ชจ์ง€๊ฐ€ ๊นจ์ง (Windows) ์ฝ˜์†” ๋ฌธ์ž ์ฝ”๋“œ๊ฐ€ UTF-8์ด ์•„๋‹˜ Windows Terminal ์‚ฌ์šฉ, ๋˜๋Š” chcp 65001 ์‹คํ–‰ ํ›„ ๋‹ค์‹œ ์‹œ์ž‘
๋‹ค์‹œ ์‹คํ–‰ํ–ˆ๋”๋‹ˆ ํ€ด์ฆˆยท์ ์ˆ˜๊ฐ€ ์‚ฌ๋ผ์ง -v ์˜ต์…˜ ๋น ์ง, ๋ฐฉ๋ฒ• AยทB๋ฅผ ์„ž์–ด ์”€, down -v ์‹คํ–‰ 9-3, 9-4 ์ฐธ๊ณ 
โš ๏ธ ๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค: Permission denied Linux์—์„œ ๋‚ด PC ํด๋”๋ฅผ ์—ฐ๊ฒฐํ–ˆ๊ณ  ํด๋” ์ฃผ์ธ์ด ๋‹ค๋ฆ„ --user "$(id -u):$(id -g)" ์ถ”๊ฐ€
์ฝ”๋“œ๋ฅผ ๊ณ ์ณค๋Š”๋ฐ ๋ฐ˜์˜๋˜์ง€ ์•Š์Œ ์ด๋ฏธ์ง€๋ฅผ ๋‹ค์‹œ ๋นŒ๋“œํ•˜์ง€ ์•Š์Œ docker compose build

9-10. Docker ๊ด€๋ จ ํŒŒ์ผ ์„ค๋ช…

ํŒŒ์ผ ์—ญํ• 
Dockerfile ์ด๋ฏธ์ง€ ์„ค๊ณ„๋„. python:3.12.16-slim ์œ„์— ๊ฒŒ์ž„ ์ฝ”๋“œ๋ฅผ ๋ณต์‚ฌํ•˜๊ณ , UTF-8 ์ž…์ถœ๋ ฅ, ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž(quiz, uid 1000)๋กœ ์‹คํ–‰, ๋ฐ์ดํ„ฐ ๊ฒฝ๋กœ QUIZ_STATE_PATH=/data/state.json, docker stop ์‹œ SIGINT๋ฅผ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. ์™ธ๋ถ€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ์—†์–ด pip install ๋‹จ๊ณ„๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.
compose.yaml docker compose ์„ค์ •. ์ž…๋ ฅ ์—ฐ๊ฒฐ(stdin_open, tty)๊ณผ quiz-data ๋ณผ๋ฅจ ์—ฐ๊ฒฐ์„ ์ ์–ด ๋‘์–ด ์งง์€ ๋ช…๋ น์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
.dockerignore .git, state.json, ๋ฌธ์„œ ๋“ฑ ์ด๋ฏธ์ง€์— ํ•„์š” ์—†๋Š” ํŒŒ์ผ์„ ๋นผ์„œ ๋นŒ๋“œ๋ฅผ ๋น ๋ฅด๊ฒŒ ํ•˜๊ณ  ๋‚ด PC์˜ ๋ฐ์ดํ„ฐ๊ฐ€ ์ด๋ฏธ์ง€์— ์„ž์ด์ง€ ์•Š๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
.github/workflows/docker.yml pushยทPR๋งˆ๋‹ค GitHub ์„œ๋ฒ„์—์„œ ์œ„ ์ฒดํฌ๋ฆฌ์ŠคํŠธ๋ฅผ ์ž๋™์œผ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

10. ํ…Œ์ŠคํŠธ

# Python์œผ๋กœ (Windows๋Š” python, macOS/Linux๋Š” python3)
python -m unittest discover -s tests -v

# Docker๋กœ (Python ์„ค์น˜ ์—†์ด, ์ด๋ฏธ์ง€์™€ ๊ฐ™์€ Python 3.12.16)
docker compose build
docker compose run --rm -T -v "$(pwd):/src:ro" -w /src quiz python -m unittest discover -s tests -v
  • ์™ธ๋ถ€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์—†์ด ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ unittest๋งŒ ์”๋‹ˆ๋‹ค. ํ…Œ์ŠคํŠธ๋Š” ์ž„์‹œ ํด๋”์—์„œ๋งŒ ํŒŒ์ผ์„ ๋งŒ๋“ค๊ธฐ ๋•Œ๋ฌธ์— ๋‚ด state.json์€ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • push์™€ Pull Request๋งˆ๋‹ค GitHub Actions๊ฐ€ Python 3.12.16๊ณผ ์ตœ์†Œ ์ง€์› ๋ฒ„์ „ 3.10์—์„œ ๊ฐ™์€ ํ…Œ์ŠคํŠธ๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. (9-8)
ํŒŒ์ผ ๊ฐœ์ˆ˜ ํ™•์ธํ•˜๋Š” ๊ฒƒ
test_input_utils.py 11 parse_int: ์•ž๋’ค ๊ณต๋ฐฑ ์ œ๊ฑฐ, ๋นˆ ์ž…๋ ฅ, ์ˆซ์ž ์•„๋‹˜(abc, 1.5), ๋ฒ”์œ„ ๋ฐ–(0, 8, -1), ๊ฒฝ๊ณ„๊ฐ’. read_intยทread_textยทread_yes_no: ์˜ฌ๋ฐ”๋ฅธ ๊ฐ’์ด ๋‚˜์˜ฌ ๋•Œ๊นŒ์ง€ ๋‹ค์‹œ ๋ฌป๊ธฐ, ํ•œ๊ธ€ ์žํŒ(ใ…›/ใ…œ). Ctrl+Cยท์ž…๋ ฅ ์ข…๋ฃŒ๋ฅผ ์‚ผํ‚ค์ง€ ์•Š๊ณ  ์œ„๋กœ ์ „๋‹ฌ
test_quiz.py 7 ์ •๋‹ต ํ™•์ธ, dict ๋ณ€ํ™˜ ์™•๋ณต, ์ด์ „ ํ˜•์‹(ํžŒํŠธ ์—†์Œ) ํ˜ธํ™˜, ์ž˜๋ชป๋œ ๋ฐ์ดํ„ฐ 9์ข… ๊ฑฐ๋ถ€(์ •๋‹ต true ํฌํ•จ). ๊ธฐ๋ณธ ํ€ด์ฆˆ๊ฐ€ 5๊ฐœ ์ด์ƒ(ํ˜„์žฌ 8๊ฐœ)์ด๊ณ  ๋ชจ๋‘ ์ €์žฅ ํ˜•์‹ ๊ฒ€์‚ฌ๋ฅผ ํ†ต๊ณผํ•˜๋Š”์ง€
test_scoring.py 10 ๋ชจ๋‘ ์ •๋‹ต 100์ , README ์˜ˆ์‹œ 50์ (๊ทธ๋ƒฅ ์ •๋‹ต + ํžŒํŠธ ์ •๋‹ต + ์˜ค๋‹ต), ํžŒํŠธ ๋ณด๊ณ  ์˜ค๋‹ต 0์ , ๋ฐ˜์˜ฌ๋ฆผ(33์ ), ํžŒํŠธ ์—†๋Š” ๋ฌธ์ œ๋Š” ๊ฐ์  ์—†์Œ, ใ…—๋กœ ํžŒํŠธ, ์ตœ๊ณ  ์ ์ˆ˜๋Š” ๋” ๋†’์„ ๋•Œ๋งŒ ๊ฐฑ์‹ , ํ’€์ด ํ›„ ๊ธฐ๋ก ์ €์žฅ, ์ž˜๋ชป๋œ ์ž…๋ ฅ ์žฌ์งˆ๋ฌธ, ํ€ด์ฆˆ๊ฐ€ ์—†์„ ๋•Œ
test_storage.py 16 UTF-8๋กœ ํ•œ๊ธ€ ๊ทธ๋Œ€๋กœ ์ €์žฅ, ์ž„์‹œ ํŒŒ์ผ์ด ๋‚จ์ง€ ์•Š์Œ, ์ €์žฅ ํด๋” ์ž๋™ ์ƒ์„ฑ, ์ €์žฅ ๋„์ค‘ ์‹คํŒจํ•ด๋„ ๊ธฐ์กด ํŒŒ์ผ ์œ ์ง€, 1,000๊ฐœ ์ €์žฅยท๋ถˆ๋Ÿฌ์˜ค๊ธฐ, ์—†์Œยท์†์ƒ(7์ข…)ยท์ฝ๊ธฐ ๋ถˆ๊ฐ€ ๊ตฌ๋ถ„, .bak ๋ฐฑ์—… ํ›„ ๋ณต๊ตฌ, ์ฝ๊ธฐ ๋ถˆ๊ฐ€ ํŒŒ์ผ์€ ๋ฎ์–ด์“ฐ์ง€ ์•Š์Œ, ์ €์žฅ ์‹คํŒจ ์‹œ ์•ˆ๋‚ด ํ›„ ๊ณ„์†
test_exit.py 4 main.py๋ฅผ ์‹ค์ œ๋กœ ์‹คํ–‰: ๋ฉ”๋‰ด 7 ์ข…๋ฃŒ ํ›„ ํŒŒ์ผ ์ƒ์„ฑ, ์ถ”๊ฐ€ํ•œ ํ€ด์ฆˆ๊ฐ€ ์žฌ์‹คํ–‰ ํ›„ ๋‚จ์Œ, ์ž…๋ ฅ ์ข…๋ฃŒ(Ctrl+D) ์‹œ ์ €์žฅ, SIGINT(Ctrl+C)ยทSIGTERM ์‹ ํ˜ธ์—๋„ ์ €์žฅ ํ›„ ์ข…๋ฃŒ ์ฝ”๋“œ 0

์‹คํ–‰ ๊ฒฐ๊ณผ (Docker, ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž ๊ถŒํ•œ, ์š”์•ฝ):

$ docker compose run --rm -T -v "$(pwd):/src:ro" -w /src quiz python -m unittest discover -s tests -v
test_added_quiz_survives_restart (test_exit.ExitTest...) ... ok
test_signals_save_and_exit (test_exit.ExitTest...) ... ok
test_not_a_number (test_input_utils.ParseIntTest...) ... ok
test_readme_example_is_50 (test_scoring.ScoringTest...) ... ok
test_failed_write_keeps_old_file (test_storage.SaveLoadTest...) ... ok
โ€ฆ (48๊ฐœ)
----------------------------------------------------------------------
Ran 48 tests in 1.262s

OK

์ €์žฅ ์‹คํŒจ ํ…Œ์ŠคํŠธ๋Š” ํด๋”๋ฅผ ์ฝ๊ธฐ ์ „์šฉ์œผ๋กœ ๋ฐ”๊ฟ” ํ™•์ธํ•˜๋ฏ€๋กœ, ๊ถŒํ•œ๊ณผ ์ƒ๊ด€์—†์ด ์“ธ ์ˆ˜ ์žˆ๋Š” ๊ด€๋ฆฌ์ž(root) ๊ณ„์ •๊ณผ Windows์—์„œ๋Š” ๊ฑด๋„ˆ๋œ๋‹ˆ๋‹ค(skipped=1). ์‹ ํ˜ธ ํ…Œ์ŠคํŠธ๋„ Windows์—์„œ๋Š” ๊ฑด๋„ˆ๋œ๋‹ˆ๋‹ค. GitHub Actions์—์„œ๋Š” ์ผ๋ฐ˜ ์‚ฌ์šฉ์ž(uid 1000) ์ปจํ…Œ์ด๋„ˆ๋กœ ์‹คํ–‰ํ•ด ๋ชจ๋‘ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

11. ๋Œ€๋Ÿ‰ ๋ฐ์ดํ„ฐ(ํ€ด์ฆˆ 1,000๊ฐœ ์ด์ƒ) ํ•œ๊ณ„ ๋ถ„์„๊ณผ ๊ฐœ์„ ์•ˆ

11-1. ์ธก์ • ๋ฐฉ๋ฒ•

tools/benchmark.py๊ฐ€ ์‹ค์ œ ๊ฒŒ์ž„ ์ฝ”๋“œ(Quiz, StateStorage, QuizGame)๋กœ ํ€ด์ฆˆ 1,000 / 10,000 / 100,000๊ฐœ์™€ ๊ฐ™์€ ์ˆ˜์˜ ๊ฒŒ์ž„ ๊ธฐ๋ก์„ ๋งŒ๋“ค์–ด ์ž„์‹œ ํด๋”์—์„œ ์ธก์ •ํ•ฉ๋‹ˆ๋‹ค. ๊ฐ ๊ฐ’์€ 3๋ฒˆ ์žฌ์„œ ๊ฐ€์žฅ ๋น ๋ฅธ ๊ฐ’์ž…๋‹ˆ๋‹ค.

python tools/benchmark.py              # 1,000 / 10,000 / 100,000๊ฐœ (์•ฝ 10์ดˆ)
python tools/benchmark.py 1000 5000    # ์›ํ•˜๋Š” ๊ฐœ์ˆ˜๋งŒ
docker compose run --rm -T -v "$(pwd):/src:ro" -w /src quiz python tools/benchmark.py   # Docker๋กœ

์ธก์ • ํ™˜๊ฒฝ: Linux(4 vCPU, 16GB ๋ฉ”๋ชจ๋ฆฌ), Python 3.13.18, 2026-11-10. ์‹œ๊ฐ„์€ PC๋งˆ๋‹ค ๋‹ค๋ฅด๋ฏ€๋กœ ๊ฐœ์ˆ˜๊ฐ€ 10๋ฐฐ์ผ ๋•Œ ๋ช‡ ๋ฐฐ๊ฐ€ ๋˜๋Š”์ง€๋ฅผ ๋ณด๋ฉด ๋ฉ๋‹ˆ๋‹ค.

11-2. ์ธก์ • ๊ฒฐ๊ณผ โ€” ํ˜„์žฌ ๊ตฌ์กฐ (state.json ํ•œ ํŒŒ์ผ)

ํ€ด์ฆˆ ์ˆ˜ state.json ํฌ๊ธฐ ์ €์žฅ 1ํšŒ (์ถ”๊ฐ€ยท์‚ญ์ œยทํ’€์ด ์ข…๋ฃŒ๋งˆ๋‹ค) ์‹œ์ž‘ํ•  ๋•Œ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ ์ตœ๋Œ€ ๋ฉ”๋ชจ๋ฆฌ ๋ชฉ๋กยท์‚ญ์ œ ํ™”๋ฉด ์ค„ ์ˆ˜ ๋ฌธ์ œ ๊ฒ€์ƒ‰ (์ „์ฒด ํ›‘๊ธฐ) 10๋ฌธ์ œ ๋ฌด์ž‘์œ„ ๋ฝ‘๊ธฐ ๋งจ ์•ž ํ€ด์ฆˆ ์‚ญ์ œ
1,000 0.58 MB 8.6 ms 3.7 ms 2.3 MB 1,004์ค„ 0.02 ms 0.004 ms 0.001 ms
10,000 5.81 MB 78.3 ms 44.6 ms 23.3 MB 10,004์ค„ 0.25 ms 0.003 ms 0.012 ms
100,000 58.64 MB 842.0 ms 500.6 ms 234.6 MB 100,004์ค„ 2.66 ms 0.004 ms 0.449 ms

๋น„๊ต์šฉ์œผ๋กœ ๊ฐ™์€ ํ€ด์ฆˆ๋ฅผ SQLite(ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ sqlite3) ํ‘œ์— ๋„ฃ๊ณ  ์žฐ ๊ฐ’์ž…๋‹ˆ๋‹ค.

ํ€ด์ฆˆ ์ˆ˜ DB ํŒŒ์ผ ํฌ๊ธฐ 1๊ฐœ ์ถ”๊ฐ€ (๋””์Šคํฌ ์ €์žฅ ํฌํ•จ) ๋ฌธ์ œ ๊ฒ€์ƒ‰ (LIKE) 20๊ฐœ์”ฉ ํŽ˜์ด์ง€ ์กฐํšŒ 10๋ฌธ์ œ ๋ฌด์ž‘์œ„ ๋ฝ‘๊ธฐ
1,000 0.23 MB 0.58 ms 0.04 ms 0.013 ms 0.08 ms
10,000 2.17 MB 0.78 ms 0.67 ms 0.047 ms 0.80 ms
100,000 22.63 MB 0.81 ms 7.08 ms 1.969 ms 8.75 ms

11-3. ์–ด๋””์„œ ๋จผ์ € ํ•œ๊ณ„๊ฐ€ ์˜ค๋‚˜

์ˆœ์„œ ๋ฌธ์ œ ๊ทผ๊ฑฐ (์‹ค์ธก) ์˜ํ–ฅ
1 ํ™”๋ฉด: ๋ชฉ๋กยท์‚ญ์ œ๊ฐ€ ์ „๋ถ€ ์ถœ๋ ฅ๋จ 1,000๊ฐœ๋ฉด 1,004์ค„ = ํ„ฐ๋ฏธ๋„ ํ•œ ํ™”๋ฉด(์•ฝ 40์ค„)์˜ 25๋ฐฐ 1,000๊ฐœ๋ถ€ํ„ฐ ์‚ญ์ œํ•  ๋ฒˆํ˜ธ๋ฅผ ์ฐพ์œผ๋ ค๋ฉด ๊ณ„์† ์Šคํฌ๋กคํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ถœ๋ ฅ ์‹œ๊ฐ„์€ ์งง์•„๋„ ์‚ฌ๋žŒ์ด ์“ธ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ํ˜„์žฌ๋Š” ๊ฒ€์ƒ‰ ๊ธฐ๋Šฅ๋„ ์—†์Šต๋‹ˆ๋‹ค.
2 ์ €์žฅ: ๋ฐ”๋€ 1๊ฐœ ๋•Œ๋ฌธ์— ํŒŒ์ผ ์ „์ฒด๋ฅผ ๋‹ค์‹œ ์”€ ์ €์žฅ ์‹œ๊ฐ„์ด ๊ฐœ์ˆ˜์— ๋น„๋ก€ (8.6 โ†’ 78 โ†’ 842 ms) 100,000๊ฐœ๋ฉด ํ€ด์ฆˆ ํ•˜๋‚˜๋ฅผ ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ ํ•œ ํŒ์„ ๋๋‚ผ ๋•Œ๋งˆ๋‹ค ์•ฝ 0.8์ดˆ ๋ฉˆ์ถ”๊ณ  59MB๋ฅผ ์ƒˆ๋กœ ์”๋‹ˆ๋‹ค. ๊ฐ™์€ ์ผ์„ SQLite๋Š” 0.8ms์— ํ•ฉ๋‹ˆ๋‹ค(์•ฝ 1,000๋ฐฐ ์ฐจ์ด).
3 ์‹œ์ž‘ ์‹œ๊ฐ„ยท๋ฉ”๋ชจ๋ฆฌ: ์ „๋ถ€ ๋ฉ”๋ชจ๋ฆฌ๋กœ ์ฝ์Œ 100,000๊ฐœ: 0.5์ดˆ, ์ตœ๋Œ€ 235MB (ํ€ด์ฆˆ 1๊ฐœ + ๊ธฐ๋ก 1๊ฐœ๋‹น ์•ฝ 2.3KB, ํŒŒ์ผ์—์„œ๋Š” ์•ฝ 0.6KB) JSON ๋ฌธ์ž์—ด โ†’ dict โ†’ Quiz ๊ฐ์ฒด๋กœ ๋ฐ”๋€Œ๋Š” ๋‹จ๊ณ„๋งˆ๋‹ค ๋ณต์‚ฌ๋ณธ์ด ์ƒ๊น๋‹ˆ๋‹ค. ์ €์‚ฌ์–‘ PC๋‚˜ ์ปจํ…Œ์ด๋„ˆ ๋ฉ”๋ชจ๋ฆฌ ์ œํ•œ์—์„œ ๋ฌธ์ œ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.
4 ๊ฒŒ์ž„ ๊ธฐ๋ก์ด ๋์—†์ด ์Œ“์ž„ ๊ธฐ๋ก 1๊ฐœ โ‰ˆ 115๋ฐ”์ดํŠธ (ํ€ด์ฆˆ 1๊ฐœ โ‰ˆ 300๋ฐ”์ดํŠธ) ํ€ด์ฆˆ ์ˆ˜์™€ ์ƒ๊ด€์—†์ด ํ•œ ํŒ ํ•  ๋•Œ๋งˆ๋‹ค ๋Š˜์–ด๋‚ฉ๋‹ˆ๋‹ค. 1๋งŒ ํŒ์ด๋ฉด ์•ฝ 1.2MB๊ฐ€ ์ €์žฅํ•  ๋•Œ๋งˆ๋‹ค ํ•จ๊ป˜ ๋‹ค์‹œ ์“ฐ์ž…๋‹ˆ๋‹ค.
5 ๋™์‹œ ์‹คํ–‰ ์‹œ ๋ฎ์–ด์“ฐ๊ธฐ ํŒŒ์ผ ์ž ๊ธˆ ์—†์Œ ํ”„๋กœ๊ทธ๋žจ ๋‘ ๊ฐœ๊ฐ€ ๊ฐ™์€ ํŒŒ์ผ์„ ์“ฐ๋ฉด ๋‚˜์ค‘์— ์ €์žฅํ•œ ์ชฝ๋งŒ ๋‚จ์Šต๋‹ˆ๋‹ค.
โ€” ๋ฌธ์ œ ์•„๋‹˜: ๊ฒ€์ƒ‰ยท์ถœ์ œยท์‚ญ์ œ ์†๋„ 100,000๊ฐœ์—์„œ๋„ ๊ฒ€์ƒ‰ 2.7ms, ์ถœ์ œ 0.004ms, ์‚ญ์ œ 0.45ms ๋ฉ”๋ชจ๋ฆฌ ์•ˆ์˜ ๋ฆฌ์ŠคํŠธ ์ฒ˜๋ฆฌ๋Š” ์ถฉ๋ถ„ํžˆ ๋น ๋ฆ…๋‹ˆ๋‹ค. ์ด ๊ทœ๋ชจ์˜ ๋ณ‘๋ชฉ์€ '์ธ๋ฑ์Šค๊ฐ€ ์—†์–ด์„œ'๊ฐ€ ์•„๋‹ˆ๋ผ ํ•œ ํŒŒ์ผ์„ ํ†ต์งธ๋กœ ์ฝ๊ณ  ์“ฐ๋Š” ๊ตฌ์กฐ์™€ ์ „๋ถ€ ์ถœ๋ ฅํ•˜๋Š” ํ™”๋ฉด์ž…๋‹ˆ๋‹ค.

11-4. ๊ทœ๋ชจ๋ณ„ ๊ฐœ์„ ์•ˆ

๊ทœ๋ชจ ํŒ๋‹จ ๊ฐœ์„ ์•ˆ
1,000๊ฐœ ์•ˆํŒŽ ํ˜„์žฌ ๊ตฌ์กฐ๋กœ ์ถฉ๋ถ„ (์ €์žฅ 9ms, ์‹œ์ž‘ 4ms, ๋ฉ”๋ชจ๋ฆฌ 2MB) ํ™”๋ฉด ๊ฐœ์„ : ๋ชฉ๋กยท์‚ญ์ œ๋ฅผ 20๊ฐœ์”ฉ ํŽ˜์ด์ง€๋กœ ๋‚˜๋ˆ„๊ณ (๋‹ค์Œ/์ด์ „), ํ‚ค์›Œ๋“œ ๊ฒ€์ƒ‰์œผ๋กœ ๋ฒˆํ˜ธ๋ฅผ ์ฐพ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. ์ €์žฅ ๊ตฌ์กฐ๋Š” ๊ทธ๋Œ€๋กœ ๋‘ก๋‹ˆ๋‹ค.
10,000๊ฐœ ์•ˆํŒŽ ๋™์ž‘์€ ํ•˜์ง€๋งŒ ์ €์žฅ๋งˆ๋‹ค 80ms, ํŒŒ์ผ 6MB โ‘  ์ €์žฅํ•  ๋•Œ ๋“ค์—ฌ์“ฐ๊ธฐ๋ฅผ ๋นผ๋ฉด ํŒŒ์ผ์ด 38% ์ค„์–ด๋“ญ๋‹ˆ๋‹ค(5.81 โ†’ 3.59MB). โ‘ก ๊ฒŒ์ž„ ๊ธฐ๋ก์„ ๋ณ„๋„ ํŒŒ์ผ๋กœ ๋ถ„๋ฆฌํ•˜๊ณ  JSON Lines(ํ•œ ํŒ = ํ•œ ์ค„)๋กœ ๋์— ํ•œ ์ค„๋งŒ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. ํŒŒ์ผ ์ „์ฒด๋ฅผ ๋‹ค์‹œ ์“ฐ์ง€ ์•Š๊ณ , ์ฝ์„ ๋•Œ๋„ ํ•œ ์ค„์”ฉ ์ŠคํŠธ๋ฆฌ๋ฐ์œผ๋กœ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. โ‘ข ๊ธฐ๋ก์€ ์ตœ๊ทผ 1,000๊ฐœ๋งŒ ๋ณด๊ด€ํ•˜๊ฑฐ๋‚˜ ์˜ค๋ž˜๋œ ๊ฒƒ์„ ๋”ฐ๋กœ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค.
100,000๊ฐœ ์ด์ƒ ํ•œ ํŒŒ์ผ ๊ตฌ์กฐ์˜ ํ•œ๊ณ„ SQLite๋กœ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ํ‘œ์ค€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ sqlite3๋ผ ์„ค์น˜ํ•  ๊ฒƒ์ด ์—†์Šต๋‹ˆ๋‹ค.

SQLite๋กœ ๋ฐ”๊พธ๋ฉด ๋‹ฌ๋ผ์ง€๋Š” ์ 

  • ์ €์žฅ: ๋ฐ”๋€ ํ–‰๋งŒ ์”๋‹ˆ๋‹ค. 1๊ฐœ ์ถ”๊ฐ€๊ฐ€ ๋ฐ์ดํ„ฐ ์–‘๊ณผ ์ƒ๊ด€์—†์ด ์•ฝ 0.8ms์ž…๋‹ˆ๋‹ค. ํŠธ๋žœ์žญ์…˜์œผ๋กœ ์›์ž์ ์œผ๋กœ ์ €์žฅ๋˜๊ณ , DB๊ฐ€ ํŒŒ์ผ ์ž ๊ธˆ์„ ํ•ด ๋™์‹œ ์‹คํ–‰๋„ ์•ˆ์ „ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฉ”๋ชจ๋ฆฌ: ์‹œ์ž‘ํ•  ๋•Œ ์ „๋ถ€ ์ฝ์ง€ ์•Š๊ณ  ํ•„์š”ํ•œ ํ–‰๋งŒ ์ฝ์Šต๋‹ˆ๋‹ค(LIMIT 20 OFFSET n์œผ๋กœ ํŽ˜์ด์ง€ ์กฐํšŒ 2ms).
  • ๊ฒ€์ƒ‰: LIKE๋Š” 100,000๊ฐœ์—์„œ 7ms์ž…๋‹ˆ๋‹ค. ๋‹จ์–ด ๊ฒ€์ƒ‰์ด ์žฆ์•„์ง€๋ฉด SQLite์˜ **FTS5(์ „๋ฌธ ๊ฒ€์ƒ‰ ์ธ๋ฑ์Šค)**๋กœ ์ „์ฒด๋ฅผ ํ›‘์ง€ ์•Š๊ณ  ์ฐพ์Šต๋‹ˆ๋‹ค. ๋ฒˆํ˜ธ(id)๋กœ ์ฐพ๋Š” ์‚ญ์ œ๋Š” ๊ธฐ๋ณธ ํ‚ค ์ธ๋ฑ์Šค๋กœ ๋ฐ”๋กœ ์ฐพ์Šต๋‹ˆ๋‹ค.
  • ์ถœ์ œ: ORDER BY RANDOM() LIMIT 10(100,000๊ฐœ์—์„œ 8.8ms). ์ด ๋ฐฉ์‹๋„ ์ „์ฒด๋ฅผ ํ•œ ๋ฒˆ ํ›‘๊ธฐ ๋•Œ๋ฌธ์—, ๋” ์ปค์ง€๋ฉด id ๋ฒ”์œ„์—์„œ ๋ฌด์ž‘์œ„ ๋ฒˆํ˜ธ๋ฅผ ๋ฝ‘์•„ ๋ฐ”๋กœ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.
  • ๋Œ€๊ฐ€: ๋ฉ”๋ชจ์žฅ์œผ๋กœ ์—ด์–ด ๋ณผ ์ˆ˜ ์—†๊ฒŒ ๋˜์–ด ๊ฐ€๋…์„ฑ์„ ์žƒ๊ณ , ํ‘œ ๊ตฌ์กฐ๋ฅผ ๋ฐ”๊ฟ€ ๋•Œ ๋ณ€ํ™˜ ์ž‘์—…(๋งˆ์ด๊ทธ๋ ˆ์ด์…˜)์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ 1,000๊ฐœ ์ˆ˜์ค€์ธ ์ง€๊ธˆ์€ JSON์„ ์œ ์ง€ํ•˜๊ณ , ์œ„ ํ‘œ์˜ ๊ธฐ์ค€์„ ๋„˜์„ ๋•Œ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
  • ์ „ํ™˜ ์ˆœ์„œ: โ‘  state.json์„ ํ•œ ๋ฒˆ ์ฝ์–ด ํ‘œ์— ๋„ฃ๋Š” ๋ณ€ํ™˜ ์Šคํฌ๋ฆฝํŠธ โ†’ โ‘ก StateStorage ๋Œ€์‹  add/delete/page/search/sample ๋ฉ”์„œ๋“œ๋ฅผ ๊ฐ€์ง„ ์ €์žฅ ํด๋ž˜์Šค โ†’ โ‘ข QuizGame์˜ ๋ชฉ๋กยท์‚ญ์ œยท์ถœ์ œ๊ฐ€ ๊ทธ ๋ฉ”์„œ๋“œ๋ฅผ ์“ฐ๋„๋ก ์ˆ˜์ •. Quiz์™€ ์ž…๋ ฅ ๊ฒ€์ฆ์€ ๊ทธ๋Œ€๋กœ์ž…๋‹ˆ๋‹ค. (5์žฅ ํ™•์žฅ ์‹œ๋‚˜๋ฆฌ์˜ค)

12. ์™„์ „ ์ดˆ๋ณด๋ฅผ ์œ„ํ•œ ์„ค์น˜๋ถ€ํ„ฐ ๋”ฐ๋ผํ•˜๊ธฐ ํ”Œ๋ ˆ์ด๋ถ

Windows 11 ยท ์ฝ”๋””์„ธ์ด AI ์˜ฌ์ธ์› ๊ณผ์ • ์ฐธ์—ฌ์ž์šฉ
ํ™•์ธ์ผ: 2026-11-12

๋ชฉํ‘œ๋Š” ๋‚ด Windows 11 ์ปดํ“จํ„ฐ์—์„œ Docker๋กœ ํ€ด์ฆˆ ๊ฒŒ์ž„์„ ์‹คํ–‰ํ•˜๊ณ , ๋ฌธ์ œ๋ฅผ ์ถ”๊ฐ€ํ•œ ๋’ค ๊ฒŒ์ž„์„ ๊ป๋‹ค ์ผœ๋„ ๊ธฐ๋ก์ด ๋‚จ๋Š” ๊ฒƒ์„ ํ™•์ธํ•˜๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค.

์•„๋ž˜ ๊ณผ์ •์—์„œ๋Š” GitHub์—์„œ ZIP ๋‹ค์šด๋กœ๋“œ โ†’ Docker Compose๋กœ ์‹คํ–‰ํ•˜๋Š” ํ•œ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋ช…๋ น์–ด๋Š” Windows PowerShell์— ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค. Windows์— Python์ด๋‚˜ Git์„ ๋”ฐ๋กœ ์„ค์น˜ํ•˜๊ฑฐ๋‚˜ Ubuntu ์‚ฌ์šฉ์ž ๊ณ„์ •์„ ๋งŒ๋“ค ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค.

๋ช…๋ น์–ด ์ž…๋ ฅ ๊ทœ์น™
ํšŒ์ƒ‰ ์ฝ”๋“œ ์ƒ์ž์˜ ๋‚ด์šฉ์„ ๋ณต์‚ฌํ•ด PowerShell์— ๋ถ™์—ฌ ๋„ฃ๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค. ํ•œ ๋‹จ๊ณ„์˜ ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•œ ๋’ค ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ์ด๋™ํ•˜์„ธ์š”. ํ™”๋ฉด์— ์ด๋ฏธ ํ‘œ์‹œ๋œ PS C:\...> ๊ฐ™์€ ๊ธ€์ž๋Š” ๋ณต์‚ฌํ•˜๊ฑฐ๋‚˜ ์ž…๋ ฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ฒŒ์ž„์ด ์‹คํ–‰๋œ ๋™์•ˆ์—๋Š” ๊ทธ ์ฐฝ์— PowerShell ๋ช…๋ น ๋Œ€์‹  ๊ฒŒ์ž„ ๋ฉ”๋‰ด ๋ฒˆํ˜ธ๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

12-1. ์˜ค๋Š˜ ์‚ฌ์šฉํ•  ์„ธ ๊ฐ€์ง€ ์ด๋ฆ„ ์ดํ•ดํ•˜๊ธฐ

์ด๋ฆ„ ์ด๋ฒˆ ์‹ค์Šต์—์„œ ํ•˜๋Š” ์ผ
Docker Desktop Windows์—์„œ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์‹คํ–‰ํ•˜๋Š” ํ”„๋กœ๊ทธ๋žจ์ž…๋‹ˆ๋‹ค.
์ด๋ฏธ์ง€ ๊ฒŒ์ž„ ์ฝ”๋“œ์™€ Python ์‹คํ–‰ ํ™˜๊ฒฝ์„ ํ•จ๊ป˜ ๋‹ด์€ ์‹คํ–‰ ์ค€๋น„๋ฌผ์ž…๋‹ˆ๋‹ค.
์ปจํ…Œ์ด๋„ˆ ์ด๋ฏธ์ง€๋ฅผ ์‚ฌ์šฉํ•ด ์‹ค์ œ๋กœ ์‹คํ–‰ ์ค‘์ธ ๊ฒŒ์ž„์ž…๋‹ˆ๋‹ค.

Docker Compose๋Š” ํด๋” ์•ˆ์˜ compose.yaml์„ ์ฝ์–ด ์‹คํ–‰ ์„ค์ •์„ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค. ์˜ค๋Š˜์€ ์„ค์ •์„ ์™ธ์šฐ๋Š” ๋Œ€์‹  ์ •ํ•ด์ง„ ๋ช…๋ น์–ด๋ฅผ ์‹คํ–‰ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ๊ฒŒ์ž„์€ PowerShell ์ฐฝ ์•ˆ์—์„œ ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค. ์›น๋ธŒ๋ผ์šฐ์ € ์ฃผ์†Œ๋ฅผ ์ž…๋ ฅํ•˜๊ฑฐ๋‚˜ ๋ณ„๋„์˜ ๊ฒŒ์ž„ ์ฐฝ์„ ์ฐพ์ง€ ์•Š์•„๋„ ๋ฉ๋‹ˆ๋‹ค.

12-2. Windows ์—…๋ฐ์ดํŠธ์™€ ์ปดํ“จํ„ฐ ์‚ฌ์–‘ ํ™•์ธํ•˜๊ธฐ

  1. ์‹œ์ž‘ โ†’ ์„ค์ • โ†’ Windows ์—…๋ฐ์ดํŠธ๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  2. ์—…๋ฐ์ดํŠธ๋ฅผ ํ™•์ธํ•˜๊ณ , ์„ค์น˜ ํ›„ ์žฌ์‹œ์ž‘์ด ํ•„์š”ํ•˜๋ฉด ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
  3. ์„ค์ • โ†’ ์‹œ์Šคํ…œ โ†’ ์ •๋ณด๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  4. ์„ค์น˜๋œ RAM์ด 8GB ์ด์ƒ์ธ์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  5. ์‹œ์Šคํ…œ ์ข…๋ฅ˜์™€ ํ”„๋กœ์„ธ์„œ ํ•ญ๋ชฉ์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
ํ™•์ธ ๊ฒฐ๊ณผ ๋‚˜์ค‘์— ๋ฐ›์„ Docker ์„ค์น˜ ํŒŒ์ผ
์ผ๋ฐ˜์ ์ธ Intel/AMD ๊ธฐ๋ฐ˜ x64 ์ปดํ“จํ„ฐ Windows โ€“ x86_64
ARM ๊ธฐ๋ฐ˜ ์ปดํ“จํ„ฐ Windows โ€“ Arm

Docker๋Š” Microsoft์˜ ์ง€์› ๊ธฐ๊ฐ„ ์•ˆ์— ์žˆ๋Š” Windows ๋ฒ„์ „์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. ์˜ค๋ž˜๋œ Windows 11์„ ์—…๋ฐ์ดํŠธํ•˜์ง€ ์•Š์€ ์ฑ„ ์ง„ํ–‰ํ•˜์ง€ ๋งˆ์„ธ์š”. ์‚ฌ์–‘์˜ ์ •ํ™•ํ•œ ๊ธฐ์ค€์€ Docker ๊ณต์‹ Windows ์„ค์น˜ ๋ฌธ์„œ์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

12-3. ์ปดํ“จํ„ฐ์˜ ๊ฐ€์ƒํ™”๊ฐ€ ์ผœ์ ธ ์žˆ๋Š”์ง€ ํ™•์ธํ•˜๊ธฐ

  1. ํ‚ค๋ณด๋“œ์—์„œ Ctrl + Shift + Esc๋ฅผ ํ•จ๊ป˜ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  2. ์ž‘์—… ๊ด€๋ฆฌ์ž๊ฐ€ ์—ด๋ฆฌ๋ฉด ์„ฑ๋Šฅ โ†’ CPU๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. ํ™”๋ฉด์˜ ๊ฐ€์ƒํ™” ํ•ญ๋ชฉ์„ ์ฐพ์Šต๋‹ˆ๋‹ค.
  4. ์‚ฌ์šฉ ๋˜๋Š” Enabled๋กœ ํ‘œ์‹œ๋˜๋ฉด ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ๊ฐ‘๋‹ˆ๋‹ค.

์‚ฌ์šฉ ์•ˆ ํ•จ ๋˜๋Š” Disabled๋ผ๋ฉด BIOS/UEFI์—์„œ ๊ฐ€์ƒํ™”๋ฅผ ์ผœ์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ œ์กฐ์‚ฌ์™€ ๋ชจ๋ธ๋งˆ๋‹ค ๋ฉ”๋‰ด๊ฐ€ ๋‹ค๋ฅด๋ฏ€๋กœ Microsoft์˜ ๊ฐ€์ƒํ™” ํ™œ์„ฑํ™” ์•ˆ๋‚ด์—์„œ ์ž์‹ ์˜ ์ œ์กฐ์‚ฌ ์•ˆ๋‚ด๋ฅผ ํ™•์ธํ•˜์„ธ์š”.

Windows์—์„œ ํ•ด๋‹น ์„ค์ • ํ™”๋ฉด์œผ๋กœ ๋“ค์–ด๊ฐ€๋Š” ๊ณตํ†ต ๊ฒฝ๋กœ๋Š” ์„ค์ • โ†’ ์‹œ์Šคํ…œ โ†’ ๋ณต๊ตฌ โ†’ ๊ณ ๊ธ‰ ์‹œ์ž‘ ์˜ต์…˜ โ†’ ์ง€๊ธˆ ๋‹ค์‹œ ์‹œ์ž‘ โ†’ ๋ฌธ์ œ ํ•ด๊ฒฐ โ†’ ๊ณ ๊ธ‰ ์˜ต์…˜ โ†’ UEFI ํŽŒ์›จ์–ด ์„ค์ • โ†’ ๋‹ค์‹œ ์‹œ์ž‘์ž…๋‹ˆ๋‹ค. ๊ฐ€์ƒํ™”๋ฅผ ์ผœ๊ณ  Windows๋กœ ๋Œ์•„์˜จ ๋’ค ์ž‘์—… ๊ด€๋ฆฌ์ž์—์„œ ๋‹ค์‹œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ๊ฐ€์ƒํ™”: ์‚ฌ์šฉ์ด ๋ณด์ž…๋‹ˆ๋‹ค.

12-4. ๊ด€๋ฆฌ์ž PowerShell ์—ด๊ธฐ

  1. ์ž‘์—…ํ‘œ์‹œ์ค„์˜ ์‹œ์ž‘ ๋ฒ„ํŠผ์„ ๋งˆ์šฐ์Šค ์˜ค๋ฅธ์ชฝ ๋ฒ„ํŠผ์œผ๋กœ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.
  2. **ํ„ฐ๋ฏธ๋„(๊ด€๋ฆฌ์ž)**๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. โ€œ์ด ์•ฑ์ด ๋””๋ฐ”์ด์Šค๋ฅผ ๋ณ€๊ฒฝํ•˜๋„๋ก ํ—ˆ์šฉํ•˜์‹œ๊ฒ ์–ด์š”?โ€๊ฐ€ ๋‚˜์˜ค๋ฉด ์˜ˆ๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  4. PowerShell ํƒญ์ด ์—ด๋ ธ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋ช…๋ น์ค„ ์•ž์— ๋ณดํ†ต PS๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

๋‹ค๋ฅธ ์ข…๋ฅ˜์˜ ํƒญ์ด ์—ด๋ ธ๋‹ค๋ฉด ํ„ฐ๋ฏธ๋„ ์ƒ๋‹จ์˜ ์•„๋ž˜์ชฝ ํ™”์‚ดํ‘œ โ†’ Windows PowerShell์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ์ฐฝ ์ œ๋ชฉ์— ๊ด€๋ฆฌ์ž ํ‘œ์‹œ๊ฐ€ ์žˆ๊ณ  PowerShell ๋ช…๋ น์„ ์ž…๋ ฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

12-5. WSL์ด ์ด๋ฏธ ์„ค์น˜๋˜์–ด ์žˆ๋Š”์ง€ ํ™•์ธํ•˜๊ธฐ

WSL์€ Windows์—์„œ Linux ์‹คํ–‰ ํ™˜๊ฒฝ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•˜๋Š” ๊ตฌ์„ฑ์š”์†Œ์ž…๋‹ˆ๋‹ค. ๊ด€๋ฆฌ์ž PowerShell์— ๋‹ค์Œ ๋ช…๋ น์„ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

wsl --version
  • WSL๊ณผ ์ปค๋„์˜ ๋ฒ„์ „ ์ •๋ณด๊ฐ€ ๋‚˜์˜ค๋ฉด 12-6์„ ๊ฑด๋„ˆ๋›ฐ๊ณ  12-7๋กœ ๊ฐ‘๋‹ˆ๋‹ค.
  • ์„ค์น˜๋˜์ง€ ์•Š์•˜๋‹ค๋Š” ์•ˆ๋‚ด๊ฐ€ ๋‚˜์˜ค๋ฉด 12-6์„ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฒ„์ „ ์ •๋ณด ๋Œ€์‹  ๋„์›€๋ง๋งŒ ๋‚˜์˜จ๋‹ค๋ฉด ๊ธฐ์กด Windows ๋‚ด์žฅ WSL์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. 12-7์˜ ์—…๋ฐ์ดํŠธ๋ถ€ํ„ฐ ์ง„ํ–‰ํ•œ ๋’ค ๋ฒ„์ „ ์ •๋ณด๋ฅผ ๋‹ค์‹œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

wsl --version์— ๋‚˜์˜ค๋Š” WSL ํ”„๋กœ๊ทธ๋žจ ๋ฒ„์ „๊ณผ โ€œWSL 2โ€๋ผ๋Š” ์‹คํ–‰ ๋ฐฉ์‹์˜ ์ˆซ์ž๋Š” ๋‹ค๋ฅธ ์˜๋ฏธ์ž…๋‹ˆ๋‹ค. ์ด ์‹ค์Šต์—์„œ๋Š” ์ตœ์‹  WSL๋กœ ์—…๋ฐ์ดํŠธํ•ด ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

12-6. WSL์ด ์—†๋Š” ์ปดํ“จํ„ฐ์— ์„ค์น˜ํ•˜๊ธฐ

WSL์ด ์„ค์น˜๋˜์–ด ์žˆ์ง€ ์•Š์„ ๋•Œ๋งŒ ๊ด€๋ฆฌ์ž PowerShell์—์„œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

wsl --install --no-distribution

์„ค์น˜๊ฐ€ ๋๋‚˜๋ฉด ์ž‘์—… ์ค‘์ธ ๋ฌธ์„œ๋ฅผ ์ €์žฅํ•˜๊ณ  ์‹œ์ž‘ โ†’ ์ „์› โ†’ ๋‹ค์‹œ ์‹œ์ž‘์œผ๋กœ ์ปดํ“จํ„ฐ๋ฅผ ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

--no-distribution์€ Ubuntu ๊ฐ™์€ ๋ณ„๋„ Linux ๋ฐฐํฌํŒ์„ ํ•จ๊ป˜ ์„ค์น˜ํ•˜์ง€ ์•Š๋Š”๋‹ค๋Š” ๋œป์ž…๋‹ˆ๋‹ค. ์ด ์‹ค์Šต์€ Windows PowerShell์—์„œ ์ง„ํ–‰ํ•˜๋ฏ€๋กœ Ubuntu ์„ค์น˜์™€ Ubuntu ์‚ฌ์šฉ์ž๋ช…ยท์•”ํ˜ธ ์ƒ์„ฑ์€ ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ์„ค์น˜๊ฐ€ ์™„๋ฃŒ๋˜๊ณ  Windows์— ๋‹ค์‹œ ๋กœ๊ทธ์ธํ–ˆ์Šต๋‹ˆ๋‹ค.

12-7. WSL ์—…๋ฐ์ดํŠธํ•˜๊ณ  ๋ฒ„์ „ ํ™•์ธํ•˜๊ธฐ

12-4์™€ ๊ฐ™์€ ๋ฐฉ๋ฒ•์œผ๋กœ ๊ด€๋ฆฌ์ž PowerShell์„ ์—ด๊ณ  ํ•œ ์ค„์”ฉ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

wsl --update
wsl --set-default-version 2
wsl --version

Docker์˜ ๊ณต์‹ ์ตœ์†Œ ์š”๊ฑด์€ WSL ๋ฒ„์ „ 2.1.5 ์ด์ƒ์ž…๋‹ˆ๋‹ค. โ€œ์ตœ์‹  ๋ฒ„์ „์ด ์ด๋ฏธ ์„ค์น˜๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹คโ€๋ผ๋Š” ์•ˆ๋‚ด๋„ ์ •์ƒ์ž…๋‹ˆ๋‹ค. ์žฌ์‹œ์ž‘์„ ์š”๊ตฌํ•˜๋ฉด ์žฌ์‹œ์ž‘ํ•œ ๋’ค ๋‹ค์‹œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: wsl --version์—์„œ WSL ๋ฒ„์ „์ด 2.1.5 ์ด์ƒ์œผ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. --no-distribution์œผ๋กœ ์„ค์น˜ํ•œ ๋’ค Linux ๋ฐฐํฌํŒ ๋ชฉ๋ก์ด ๋น„์–ด ์žˆ๋Š” ๊ฒƒ ์ž์ฒด๋Š” ์˜ค๋ฅ˜๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค.

12-8. Docker Desktop ์„ค์น˜ ํŒŒ์ผ ๋ฐ›๊ธฐ

  1. ์›น๋ธŒ๋ผ์šฐ์ €์—์„œ Docker ๊ณต์‹ Windows ์„ค์น˜ ํŽ˜์ด์ง€๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  2. 12-2์—์„œ ํ™•์ธํ•œ ์ปดํ“จํ„ฐ ์ข…๋ฅ˜์— ๋งž๋Š” Windows โ€“ x86_64 ๋˜๋Š” Windows โ€“ Arm ๋‹ค์šด๋กœ๋“œ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. ๋‹ค์šด๋กœ๋“œ๊ฐ€ ๋๋‚  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค.
  4. ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์˜ ๋‹ค์šด๋กœ๋“œ ํด๋”๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  5. ๋ฐ›์€ Docker Desktop Installer.exe๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

์ผ๋ฐ˜์ ์ธ Intel/AMD ์ปดํ“จํ„ฐ์—์„œ๋Š” x86_64๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค. Arm์€ ARM ๊ธฐ๋ฐ˜ ์ปดํ“จํ„ฐ์šฉ์ด๋ฉฐ, ๊ณต์‹ ํŽ˜์ด์ง€์—์„œ ์ œ๊ณต ์ƒํƒœ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.

12-9. WSL 2 ๋ฐฉ์‹์œผ๋กœ Docker ์„ค์น˜ํ•˜๊ธฐ

์„ค์น˜ ํ™”๋ฉด์— ์„ ํƒ์ง€๊ฐ€ ๋‚˜์˜ค๋ฉด ๋‹ค์Œ ๊ธฐ์ค€์œผ๋กœ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

์„ค์น˜ ํ™”๋ฉด์˜ ํ•ญ๋ชฉ ์„ ํƒํ•  ๋‚ด์šฉ
์„ค์น˜ ๋Œ€์ƒ: Per-user / All users ๊ฐœ์ธ ์‹ค์Šต PC๋ผ๋ฉด ๊ธฐ๋ณธ๊ฐ’์ธ Per-user
์‹คํ–‰ ๋ฐฉ์‹ ๋˜๋Š” Backend ์„ ํƒ WSL 2
Use WSL 2 instead of Hyper-V ์ฒดํฌ๋ฐ•์Šค๊ฐ€ ์žˆ๋Š” ์ด์ „ ํ˜•ํƒœ์˜ ํ™”๋ฉด ์ฒดํฌ

์„ค์น˜ ํ™”๋ฉด ๋ชจ์–‘์€ ๋ฒ„์ „์— ๋”ฐ๋ผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. ์ตœ์‹  ํ™”๋ฉด์—์„œ WSL 2๋ฅผ ์„ ํƒํ–ˆ๋‹ค๋ฉด ์œ„์˜ ์ฒดํฌ๋ฐ•์Šค๊ฐ€ ๋”ฐ๋กœ ์—†์–ด๋„ ๋ฉ๋‹ˆ๋‹ค.

์„ค์น˜๋ฅผ ๋งˆ์น˜๊ณ  ์žฌ์‹œ์ž‘์„ ์š”์ฒญํ•˜๋ฉด Close and restart ๋“ฑ ํ™”๋ฉด์˜ ์•ˆ๋‚ด์— ๋”ฐ๋ผ ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ๊ด€๋ฆฌ์ž ๊ถŒํ•œ์„ ์š”์ฒญํ•˜๋Š” ์ฐฝ์ด ๋‚˜์˜ค๋ฉด ๋‚ด์šฉ์„ ํ™•์ธํ•œ ๋’ค ์„ค์น˜๋ฅผ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ์‹œ์ž‘ ๋ฉ”๋‰ด์—์„œ Docker Desktop์„ ๊ฒ€์ƒ‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

12-10. Docker Desktop ์ฒ˜์Œ ์‹คํ–‰ํ•˜๊ธฐ

  1. ์‹œ์ž‘์„ ๋ˆ„๋ฅด๊ณ  Docker Desktop์„ ๊ฒ€์ƒ‰ํ•ด ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  2. ์ฒ˜์Œ ํ‘œ์‹œ๋˜๋Š” ์ด์šฉ์•ฝ๊ด€์„ ํ™•์ธํ•˜๊ณ  ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  3. ๊ฐœ์ธ ์‹ค์Šต ํ™˜๊ฒฝ์—์„œ ๋กœ๊ทธ์ธ ๊ฑด๋„ˆ๋›ฐ๊ธฐ๊ฐ€ ์ œ๊ณต๋˜๋ฉด ๊ฑด๋„ˆ๋›ฐ์–ด๋„ ๋ฉ๋‹ˆ๋‹ค. ์กฐ์ง์ด ๊ด€๋ฆฌํ•˜๋Š” PC๋Š” ์กฐ์ง์˜ ๋กœ๊ทธ์ธ ์ •์ฑ…์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
  4. Docker ์—”์ง„์ด ์‹œ์ž‘๋  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค.
  5. Settings โ†’ General์—์„œ WSL 2 ์—”์ง„์„ ์‚ฌ์šฉํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. Use WSL 2 based engine ํ•ญ๋ชฉ์ด ๋ณด์ด๋ฉด ์ผญ๋‹ˆ๋‹ค.

์ด๋ฏธ WSL 2๊ฐ€ ๊ธฐ๋ณธ์œผ๋กœ ์„ค์ •๋œ ์ปดํ“จํ„ฐ์—์„œ๋Š” ํ•ด๋‹น ํ•ญ๋ชฉ์ด ๋ณด์ด์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Windows ์ปจํ…Œ์ด๋„ˆ ๋ชจ๋“œ๋กœ ์„ค์ •๋œ ๊ฒฝ์šฐ์—๋Š” ์ž‘์—…ํ‘œ์‹œ์ค„์˜ Docker ๋ฉ”๋‰ด์—์„œ Switch to Linux containers๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: Docker Desktop์˜ ์‹œ์ž‘ ์˜ค๋ฅ˜๊ฐ€ ์—†๊ณ  ์—”์ง„์ด ์‹คํ–‰ ์ค‘์ž…๋‹ˆ๋‹ค. Windows Home์—์„œ๋„ ์ด๋ฒˆ ์‹ค์Šต์˜ Linux ์ปจํ…Œ์ด๋„ˆ ๋ฐฉ์‹์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

12-11. ์„ ํƒ: Docker ๋ฐ์ดํ„ฐ ์ €์žฅ ์œ„์น˜๋ฅผ D ๋“œ๋ผ์ด๋ธŒ๋กœ ๋ฐ”๊พธ๊ธฐ

C ๋“œ๋ผ์ด๋ธŒ ๊ณต๊ฐ„์ด ๋ถ€์กฑํ•˜๊ณ  D ๋“œ๋ผ์ด๋ธŒ๊ฐ€ ์žˆ๋Š” ๊ฒฝ์šฐ, ์ด๋ฏธ์ง€ ๋‹ค์šด๋กœ๋“œ์™€ ๊ฒŒ์ž„ ๋นŒ๋“œ ์ „์— ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค. D ๋“œ๋ผ์ด๋ธŒ๊ฐ€ ์—†๊ฑฐ๋‚˜ ๊ธฐ๋ณธ ์œ„์น˜๋ฅผ ์‚ฌ์šฉํ•  ๊ฒฝ์šฐ ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ๊ฐ‘๋‹ˆ๋‹ค.

  1. ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์—์„œ D ๋“œ๋ผ์ด๋ธŒ๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  2. ๋นˆ ์ „์šฉ ํด๋” DockerData๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
  3. Docker Desktop์—์„œ Settings โ†’ Resources โ†’ Advanced๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  4. Disk image location์—์„œ D:\DockerData๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  5. Apply ๋˜๋Š” Apply & restart๋กœ ์ ์šฉํ•˜๊ณ  ์—”์ง„์ด ๋‹ค์‹œ ์‹œ์ž‘๋  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค.

๊ฒŒ์ž„ ์†Œ์Šค๋ฅผ D ๋“œ๋ผ์ด๋ธŒ์— ์ €์žฅํ•˜๋Š” ๊ฒƒ๊ณผ Docker ๋ฐ์ดํ„ฐ ์ €์žฅ ์œ„์น˜๋ฅผ D ๋“œ๋ผ์ด๋ธŒ๋กœ ์ •ํ•˜๋Š” ๊ฒƒ์€ ๋ณ„๊ฐœ์˜ ์ž‘์—…์ž…๋‹ˆ๋‹ค. ์œ„ ์„ค์ •์€ Docker์˜ ์ด๋ฏธ์ง€ยท์ปจํ…Œ์ด๋„ˆ ๋ฐ์ดํ„ฐ๋ฅผ ์˜ฎ๊ธฐ๋Š” ์„ค์ •์ด๋ฉฐ, Windows ๊ตฌ์„ฑ์š”์†Œ์™€ Docker ํ”„๋กœ๊ทธ๋žจ์ด C ๋“œ๋ผ์ด๋ธŒ๋ฅผ ์ „ํ˜€ ์‚ฌ์šฉํ•˜์ง€ ์•Š๊ฒŒ ๋งŒ๋“œ๋Š” ์„ค์ •์€ ์•„๋‹™๋‹ˆ๋‹ค.

์œ„์น˜ ๋ณ€๊ฒฝ ํ•ญ๋ชฉ์ด ๋ณด์ด์ง€ ์•Š์œผ๋ฉด ์ž„์˜๋กœ Docker์˜ ๋ฐ์ดํ„ฐ ํด๋”๋ฅผ ์˜ฎ๊ธฐ๊ฑฐ๋‚˜ ์ง€์šฐ์ง€ ๋ง๊ณ  Docker WSL 2 ๊ณต์‹ ์•ˆ๋‚ด์™€ ์„ค์น˜ ๋ฒ„์ „์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

12-12. Docker๊ฐ€ ์‹ค์ œ๋กœ ์ž‘๋™ํ•˜๋Š”์ง€ ํ™•์ธํ•˜๊ธฐ

์ด์ œ ๊ด€๋ฆฌ์ž PowerShell์€ ๋‹ซ์•„๋„ ๋ฉ๋‹ˆ๋‹ค. ์‹œ์ž‘ โ†’ Windows PowerShell ๊ฒ€์ƒ‰ โ†’ ์‹คํ–‰์œผ๋กœ ์ผ๋ฐ˜ PowerShell์„ ์ƒˆ๋กœ ์—ฝ๋‹ˆ๋‹ค. ์•„๋ž˜ ๋ช…๋ น์„ ํ•œ ์ค„์”ฉ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

docker version

ํ™•์ธ: Client์™€ Server๊ฐ€ ๋ชจ๋‘ ๋‚˜์™€์•ผ ํ•ฉ๋‹ˆ๋‹ค. Client์˜ ์šด์˜์ฒด์ œ๋Š” Windows์—ฌ๋„ ์ •์ƒ์ด๋ฉฐ, ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์‹คํ–‰ํ•˜๋Š” Server ์ชฝ์€ Linux์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.

docker info --format '{{.OSType}}'

ํ™•์ธ: linux๊ฐ€ ์ถœ๋ ฅ๋ฉ๋‹ˆ๋‹ค.

docker compose version

ํ™•์ธ: Docker Compose ๋ฒ„์ „์ด ์ถœ๋ ฅ๋ฉ๋‹ˆ๋‹ค. ๋ฒ„์ „ ์ˆซ์ž๋Š” ์„ค์น˜ ์‹œ์ ์— ๋”ฐ๋ผ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. Compose๋Š” Docker Desktop์— ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

docker run --rm hello-world

ํ™•์ธ: ๋‚ด๋ ค๋ฐ›๊ธฐ๊ฐ€ ๋๋‚œ ๋’ค Hello from Docker!๊ฐ€ ๋‚˜์˜ต๋‹ˆ๋‹ค. ์ด ๋ฌธ๊ตฌ๋ฅผ ํ™•์ธํ•œ ๋’ค ๊ฒŒ์ž„ ์„ค์น˜๋กœ ๋„˜์–ด๊ฐ‘๋‹ˆ๋‹ค.

12-13. GitHub์—์„œ ๊ฒŒ์ž„ ZIP ํŒŒ์ผ ๋ฐ›๊ธฐ

  1. python-quiz-game ์ €์žฅ์†Œ๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  2. ํŒŒ์ผ ๋ชฉ๋ก ์œ„์˜ Code ๋ฒ„ํŠผ์„ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  3. Download ZIP์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  4. ๋‹ค์šด๋กœ๋“œ ํด๋”์— python-quiz-game-main.zip์ด ์ƒ๊ฒผ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ด๋ฒˆ ์‹ค์Šต์—์„œ๋Š” Git ํ”„๋กœ๊ทธ๋žจ ์„ค์น˜๋‚˜ git clone ๋ช…๋ น์ด ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

12-14. ZIP ์••์ถ•์„ ํ’€๊ณ  ์‹ค์ œ ๊ฒŒ์ž„ ํด๋” ์ฐพ๊ธฐ

  1. ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์—์„œ D ๋“œ๋ผ์ด๋ธŒ์— docker-projects ํด๋”๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค.
  2. ZIP ํŒŒ์ผ์„ ๋งˆ์šฐ์Šค ์˜ค๋ฅธ์ชฝ ๋ฒ„ํŠผ์œผ๋กœ ํด๋ฆญํ•˜๊ณ  ๋ชจ๋‘ ์••์ถ• ํ’€๊ธฐ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. ์••์ถ•์„ ํ’€ ์œ„์น˜๋ฅผ D:\docker-projects๋กœ ์ง€์ •ํ•˜๊ณ  ์••์ถ• ํ’€๊ธฐ๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  4. ์••์ถ•์„ ํ‘ผ ๋’ค python-quiz-game-main ํด๋”๋ฅผ ์—ฝ๋‹ˆ๋‹ค.

D ๋“œ๋ผ์ด๋ธŒ๊ฐ€ ์—†๋‹ค๋ฉด: ์œ„์˜ ์œ„์น˜๋ฅผ C:\docker-projects๋กœ ์ •ํ•ฉ๋‹ˆ๋‹ค. ์ดํ›„์—๋Š” ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์—์„œ ํ•ด๋‹น ํด๋”๋ฅผ ์—ด์–ด ์ง„ํ–‰ํ•˜๋ฏ€๋กœ ๋ช…๋ น์–ด๋ฅผ ์ผ์ผ์ด ์ˆ˜์ •ํ•˜์ง€ ์•Š์•„๋„ ๋ฉ๋‹ˆ๋‹ค.

ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์˜ ๋ณด๊ธฐ โ†’ ํ‘œ์‹œ โ†’ ํŒŒ์ผ ์ด๋ฆ„ ํ™•์žฅ๋ช…์„ ์ผœ๋ฉด ํŒŒ์ผ ์ด๋ฆ„ ๋’ค์˜ .yaml, .py, .md๊นŒ์ง€ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์—ด๋ฆฐ ํด๋”์—์„œ ๋‹ค์Œ ํŒŒ์ผ์ด ํ•จ๊ป˜ ๋ณด์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.

  • compose.yaml
  • Dockerfile
  • main.py
  • README.md

ํด๋” ์•ˆ์— python-quiz-game-main์ด๋ผ๋Š” ํด๋”๋งŒ ๋ณด์ด๋ฉด ๊ทธ ์•ˆ์œผ๋กœ ํ•œ ๋ฒˆ ๋” ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค. ZIP ํŒŒ์ผ ๋‚ด๋ถ€๋ฅผ ๋ณด๊ณ  ์žˆ๋Š” ์ƒํƒœ๊ฐ€ ์•„๋‹ˆ๋ผ ์••์ถ•์„ ํ‘ผ ์ผ๋ฐ˜ ํด๋”์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.

12-15. ๊ฒŒ์ž„ ํด๋”์—์„œ PowerShell ์—ด๊ธฐ

  1. compose.yaml, Dockerfile, main.py๊ฐ€ ๋ณด์ด๋Š” ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ ์ฐฝ์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  2. ์œ„์ชฝ ์ฃผ์†Œ ํ‘œ์‹œ์ค„์„ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค. ์˜ค๋ฅธ์ชฝ ๊ฒ€์ƒ‰์ฐฝ์ด ์•„๋‹™๋‹ˆ๋‹ค.
  3. ๊ธฐ์กด ๊ฒฝ๋กœ ๋Œ€์‹  powershell์ด๋ผ๊ณ  ์ž…๋ ฅํ•˜๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  4. ์ƒˆ๋กœ ์—ด๋ฆฐ PowerShell์—์„œ ๋‹ค์Œ ๋‘ ๋ช…๋ น์„ ์ฐจ๋ก€๋Œ€๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
Get-Location

์˜ˆ๋ฅผ ๋“ค์–ด D:\docker-projects\python-quiz-game-main์ด ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. C ๋“œ๋ผ์ด๋ธŒ์— ์••์ถ•์„ ํ’€์—ˆ๋‹ค๋ฉด C๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

Get-ChildItem -Name

์™„๋ฃŒ ๊ธฐ์ค€: ์ถœ๋ ฅ ๋ชฉ๋ก์— compose.yaml, Dockerfile, main.py๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ์„ธ ํŒŒ์ผ์ด ์—†๋Š” ์œ„์น˜์—์„œ๋Š” ๋‹ค์Œ ๋ช…๋ น์„ ์‹คํ–‰ํ•˜์ง€ ๋ง๊ณ  12-14์—์„œ ํด๋” ์œ„์น˜๋ฅผ ๋‹ค์‹œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

12-16. ๊ฒŒ์ž„ ์‹คํ–‰ ์ด๋ฏธ์ง€ ๋งŒ๋“ค๊ธฐ

๊ฒŒ์ž„ ํด๋”์—์„œ ์—ฐ PowerShell์— ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

docker compose build

Docker๊ฐ€ ํ•„์š”ํ•œ Python ์ด๋ฏธ์ง€์™€ ๊ฒŒ์ž„ ์ฝ”๋“œ๋ฅผ ์ค€๋น„ํ•ฉ๋‹ˆ๋‹ค. ์ฒ˜์Œ์—๋Š” ์ธํ„ฐ๋„ท์—์„œ ํŒŒ์ผ์„ ๋‚ด๋ ค๋ฐ›์œผ๋ฏ€๋กœ ์‹œ๊ฐ„์ด ๊ฑธ๋ฆด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ˜„์žฌ ํ”„๋กœ์ ํŠธ๋Š” Dockerfile์— ์ง€์ •๋œ Python์„ ์‚ฌ์šฉํ•˜๋ฏ€๋กœ Windows์— Python์„ ๋ณ„๋„๋กœ ์„ค์น˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ๋นŒ๋“œ๊ฐ€ ์˜ค๋ฅ˜ ์—†์ด ๋๋‚˜๊ณ  PS ...> ์ž…๋ ฅ์ค„๋กœ ๋Œ์•„์˜ต๋‹ˆ๋‹ค. ๋นจ๊ฐ„ ์˜ค๋ฅ˜๋‚˜ failed๊ฐ€ ๋‚˜์˜ค๋ฉด ์•„๋ž˜์˜ ๋ฌธ์ œ ํ•ด๊ฒฐ ํ‘œ์—์„œ ํ•ด๋‹น ์ฆ์ƒ์„ ๋จผ์ € ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

12-17. ํ€ด์ฆˆ ๊ฒŒ์ž„ ์‹คํ–‰ํ•˜๊ธฐ

๊ฐ™์€ ์ฐฝ์—์„œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

docker compose run --rm quiz

์ฒ˜์Œ ์ €์žฅ ๊ณต๊ฐ„์„ ๋งŒ๋“œ๋Š” ๊ฒฝ์šฐ์—๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์•ˆ๋‚ด์™€ ๊ฒŒ์ž„ ๋ฉ”๋‰ด๊ฐ€ ๋‚˜์˜ต๋‹ˆ๋‹ค.

๐Ÿ“‚ ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๊ฐ€ ์—†์–ด ๊ธฐ๋ณธ ํ€ด์ฆˆ 8๊ฐœ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
๋ฉ”๋‰ด ๋ฒˆํ˜ธ ํ•  ์ˆ˜ ์žˆ๋Š” ์ผ
1 ํ€ด์ฆˆ ํ’€๊ธฐ
2 ํ€ด์ฆˆ ์ถ”๊ฐ€
3 ํ€ด์ฆˆ ๋ชฉ๋ก ๋ณด๊ธฐ
4 ์ตœ๊ณ  ์ ์ˆ˜ ํ™•์ธ
5 ํ€ด์ฆˆ ์‚ญ์ œ
6 ์ตœ๊ทผ ํ”Œ๋ ˆ์ด ๊ธฐ๋ก ๋ณด๊ธฐ
7 ์ข…๋ฃŒ

์™„๋ฃŒ ๊ธฐ์ค€: ์„ ํƒ:์ด๋ผ๋Š” ์ž…๋ ฅ ์•ˆ๋‚ด๊ฐ€ ๋ณด์ž…๋‹ˆ๋‹ค. ๊ธฐ์กด์— ์‹คํ–‰ํ•œ ์ ์ด ์žˆ๋‹ค๋ฉด ๊ธฐ๋ณธ 8๊ฐœ ์•ˆ๋‚ด ๋Œ€์‹  ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถˆ๋Ÿฌ์™”๋‹ค๋Š” ์•ˆ๋‚ด๊ฐ€ ๋‚˜์˜ค๋Š” ๊ฒƒ์ด ์ •์ƒ์ž…๋‹ˆ๋‹ค.

12-18. ๊ธฐ๋ณธ ๋ฌธ์ œ ํ•œ ๊ฐœ ํ’€์–ด๋ณด๊ธฐ

  1. ์„ ํƒ:์— 1์„ ์ž…๋ ฅํ•˜๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  2. ๋ช‡ ๋ฌธ์ œ๋ฅผ ํ’€๊นŒ์š”?์— 1์„ ์ž…๋ ฅํ•˜๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  3. ํ™”๋ฉด์— ๋‚˜์˜จ ๋ฌธ์ œ์™€ ๋„ค ๊ฐœ์˜ ์„ ํƒ์ง€๋ฅผ ์ฝ์Šต๋‹ˆ๋‹ค. ๋ฌธ์ œ๋Š” ๋ฌด์ž‘์œ„๋กœ ์„ ํƒ๋ฉ๋‹ˆ๋‹ค.
  4. ์ •๋‹ต ์ž…๋ ฅ (1-4, ํžŒํŠธ h):์— ์ •๋‹ต์ด๋ผ๊ณ  ์ƒ๊ฐํ•˜๋Š” 1~4 ์ค‘ ํ•˜๋‚˜๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.
  5. ํžŒํŠธ๋ฅผ ๋จผ์ € ๋ณด๊ณ  ์‹ถ์œผ๋ฉด h๋ฅผ ์ž…๋ ฅํ•˜๊ณ , ๊ทธ๋‹ค์Œ ์ •๋‹ต ๋ฒˆํ˜ธ๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.
  6. ์ฑ„์  ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ฒ˜์Œ์—๋Š” ์ •๋‹ต์„ ๋งžํžˆ๋Š” ๊ฒƒ๋ณด๋‹ค ๋ฌธ์ œ ์„ ํƒ โ†’ ๋‹ต ์ž…๋ ฅ โ†’ ๊ฒฐ๊ณผ ํ™•์ธ์ด ๋™์ž‘ํ•˜๋Š”์ง€ ํ™•์ธํ•˜๋Š” ๊ฒƒ์ด ๋ชฉ์ ์ž…๋‹ˆ๋‹ค. ํ•œ ๋ฒˆ์˜ ํ”Œ๋ ˆ์ด๋ฅผ ๋๋‚ด๋ฉด ๊ฒฐ๊ณผ๊ฐ€ ํ”Œ๋ ˆ์ด ๊ธฐ๋ก์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.

12-19. ์ฝ”๋””์„ธ์ด ์ˆ˜์—… ๋ณต์Šต ๋ฌธ์ œ ํ•œ ๊ฐœ ์ถ”๊ฐ€ํ•˜๊ธฐ

๊ฒŒ์ž„ ๋ฉ”๋‰ด์˜ ์„ ํƒ:์— 2๋ฅผ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋‹ค์Œ ํ™”๋ฉด์˜ ์งˆ๋ฌธ์— ๋งž์ถฐ ์•„๋ž˜ ๋‚ด์šฉ์„ ํ•œ ์นธ์”ฉ ์ž…๋ ฅํ•˜๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.

ํ™”๋ฉด์— ๋‚˜์˜ค๋Š” ์ž…๋ ฅ ์•ˆ๋‚ด ์ž…๋ ฅํ•  ๋‚ด์šฉ
๋ฌธ์ œ๋ฅผ ์ž…๋ ฅํ•˜์„ธ์š”: Docker์—์„œ ์ด๋ฏธ์ง€๋ฅผ ๋งŒ๋“œ๋Š” ๋ฐฉ๋ฒ•์„ ์ ๋Š” ํŒŒ์ผ์€?
์„ ํƒ์ง€ 1: Dockerfile
์„ ํƒ์ง€ 2: README.md
์„ ํƒ์ง€ 3: main.py
์„ ํƒ์ง€ 4: state.json
์ •๋‹ต ๋ฒˆํ˜ธ (1-4): 1
ํžŒํŠธ (์—†์œผ๋ฉด ๊ทธ๋ƒฅ Enter): ํŒŒ์ผ ์ด๋ฆ„์— Docker๊ฐ€ ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค.

์™„๋ฃŒ ๊ธฐ์ค€: ํ€ด์ฆˆ๊ฐ€ ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค!๋ผ๋Š” ์•ˆ๋‚ด๊ฐ€ ๋‚˜์˜ต๋‹ˆ๋‹ค. ์ฒ˜์Œ ์ œ๊ณต๋˜๋Š” 8๊ฐœ์— ์ด ๋ฌธ์ œ ํ•˜๋‚˜๋ฅผ ์ถ”๊ฐ€ํ–ˆ๋‹ค๋ฉด ์ด 9๊ฐœ์ž…๋‹ˆ๋‹ค. ๊ธฐ์กด ๋ฐ์ดํ„ฐ๊ฐ€ ์žˆ๋‹ค๋ฉด ์›๋ž˜ ๊ฐœ์ˆ˜๋ณด๋‹ค ํ•˜๋‚˜ ๋Š˜์–ด๋‚ฉ๋‹ˆ๋‹ค.

์„ ํƒ:์— 3์„ ์ž…๋ ฅํ•˜์—ฌ ๋ชฉ๋ก์—์„œ ๋ฐฉ๊ธˆ ์ž…๋ ฅํ•œ ๋ฌธ์ œ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ํ€ด์ฆˆ ํ’€๊ธฐ์—์„œ๋Š” ๋ฌด์ž‘์œ„๋กœ ์ถœ์ œ๋˜๋ฏ€๋กœ, ํ•œ ๋ฌธ์ œ๋งŒ ํ’€์—ˆ์„ ๋•Œ ์ƒˆ ๋ฌธ์ œ๊ฐ€ ๋ฐ˜๋“œ์‹œ ๋‚˜์˜ค๋Š” ๊ฒƒ์€ ์•„๋‹™๋‹ˆ๋‹ค.

12-20. ์ข…๋ฃŒ ํ›„ ๋‹ค์‹œ ์‹คํ–‰ํ•ด์„œ ์ €์žฅ ํ™•์ธํ•˜๊ธฐ

  1. ๊ฒŒ์ž„ ๋ฉ”๋‰ด์˜ ์„ ํƒ:์— 7์„ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.
  2. ์ข…๋ฃŒ ์•ˆ๋‚ด๊ฐ€ ๋‚˜์˜ค๊ณ  PS ...> ์ž…๋ ฅ์ค„๋กœ ๋Œ์•„์˜ค๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  3. ๊ฐ™์€ ํด๋”์—์„œ ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
docker compose run --rm quiz
  1. ์ €์žฅ๋œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถˆ๋Ÿฌ์™”์Šต๋‹ˆ๋‹ค๋ผ๋Š” ์•ˆ๋‚ด๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  2. ๋ฉ”๋‰ด 3์—์„œ ์ถ”๊ฐ€ํ•œ Docker ๋ฌธ์ œ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  3. ๋ฉ”๋‰ด 4์—์„œ ์ตœ๊ณ  ์ ์ˆ˜๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  4. ๋ฉ”๋‰ด 6์—์„œ ์•ž์—์„œ ํ•œ ๋ฌธ์ œ๋ฅผ ํ‘ผ ๊ธฐ๋ก์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  5. ํ™•์ธ์„ ๋งˆ์น˜๋ฉด ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค.

์ด ํ”„๋กœ์ ํŠธ์˜ ์ €์žฅ ํŒŒ์ผ์€ ์ปจํ…Œ์ด๋„ˆ ์•ˆ์˜ /data/state.json์ด๋ฉฐ, ์‹ค์ œ ๋ฐ์ดํ„ฐ๋Š” python-quiz-game_quiz-data๋ผ๋Š” Docker ์ด๋ฆ„ ์žˆ๋Š” ๋ณผ๋ฅจ์— ๋ณด๊ด€๋ฉ๋‹ˆ๋‹ค. --rm์€ ์ข…๋ฃŒํ•œ ์‹คํ–‰์šฉ ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์ •๋ฆฌํ•˜๋Š” ์˜ต์…˜์ด๋ฏ€๋กœ ์ด ์ €์žฅ ๋ณผ๋ฅจ์€ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค.

์ข…๋ฃŒ ํ›„ Docker Desktop์˜ Containers ๋ชฉ๋ก์—์„œ ๊ฒŒ์ž„ ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ์‚ฌ๋ผ์ ธ๋„ ์ •์ƒ์ž…๋‹ˆ๋‹ค. ๋ฐ์ดํ„ฐ๋Š” Volumes์˜ ํ•ด๋‹น ๋ณผ๋ฅจ์— ๋‚จ์Šต๋‹ˆ๋‹ค.

์šด์˜ ๊ทœ์น™: ๊ฐ™์€ ์ €์žฅ ๊ณต๊ฐ„์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ์ž„์€ ํ•œ ๋ฒˆ์— ํ•˜๋‚˜๋งŒ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์—ฌ๋Ÿฌ ์ฐฝ์—์„œ ๋™์‹œ์— ์‹คํ–‰ํ•˜๋ฉด ๊ฐ ๊ฒŒ์ž„์˜ ์ €์žฅ ๋‚ด์šฉ์ด ์„œ๋กœ ๋ฎ์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

12-21. ๋‹ค์Œ ์ˆ˜์—…์ด๋‚˜ ๋‹ค์Œ ๋‚  ๋‹ค์‹œ ์‹คํ–‰ํ•˜๊ธฐ

์ตœ์ดˆ ์„ค์น˜๋ฅผ ๋‹ค์‹œ ํ•  ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ ์ˆœ์„œ๋งŒ ๋ฐ˜๋ณตํ•ฉ๋‹ˆ๋‹ค.

  1. Docker Desktop์„ ์‹คํ–‰ํ•˜๊ณ  ์—”์ง„ ์‹œ์ž‘์„ ๊ธฐ๋‹ค๋ฆฝ๋‹ˆ๋‹ค.
  2. ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ์—์„œ ์••์ถ•์„ ํ’€์–ด ๋‘” ๊ฒŒ์ž„ ํด๋”๋ฅผ ์—ฝ๋‹ˆ๋‹ค.
  3. ์ฃผ์†Œ ํ‘œ์‹œ์ค„์— powershell์„ ์ž…๋ ฅํ•˜๊ณ  Enter๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
  4. ์•„๋ž˜ ๋ช…๋ น์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
docker compose run --rm quiz
  1. ์‹ค์Šต์„ ๋งˆ์น˜๋ฉด ๊ฒŒ์ž„ ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•ฉ๋‹ˆ๋‹ค.

๊ฒŒ์ž„ ์†Œ์Šค๋‚˜ Dockerfile์„ ๋ฐ”๊ฟจ์„ ๋•Œ๋Š” ๋‹ค์‹œ docker compose build๋ฅผ ์‹คํ–‰ํ•œ ๋’ค ๊ฒŒ์ž„์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ํ‰์†Œ ์žฌ์‹คํ–‰์—๋Š” ๋นŒ๋“œ๊ฐ€ ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ZIP ํŒŒ์ผ์„ ์ƒˆ๋กœ ๋‹ค์šด๋กœ๋“œํ•˜๋Š” ์ž‘์—…๋„ ๋งค๋ฒˆ ํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.

12-22. ์„ ํƒ: ์ €์žฅ ๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ๋กœ ๋ฐฑ์—…ํ•˜๊ธฐ

๋จผ์ € ์‹คํ–‰ ์ค‘์ธ ๊ฒŒ์ž„์„ ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•˜๊ณ , ์ €์žฅ ์‹คํŒจ ๊ฒฝ๊ณ ๊ฐ€ ์—†์—ˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. Docker Desktop์€ ์ผœ ๋‘ก๋‹ˆ๋‹ค. ๊ฒŒ์ž„ ํด๋”์˜ PowerShell์—์„œ ์•„๋ž˜ ๋ช…๋ น์„ ์ˆœ์„œ๋Œ€๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

$quizBackupStamp = Get-Date -Format "yyyyMMdd-HHmmss"
New-Item -ItemType Directory -Path .\backup -Force
docker compose run --rm -v "${PWD}/backup:/backup" quiz cp /data/state.json "/backup/state-$quizBackupStamp.json"
Get-Item ".\backup\state-$quizBackupStamp.json"

์™„๋ฃŒ ๊ธฐ์ค€: ๊ฒŒ์ž„ ํด๋” ์•ˆ์˜ backup ํด๋”์— state-๋‚ ์งœ-์‹œ๊ฐ.json ํŒŒ์ผ์ด ์ƒ๊น๋‹ˆ๋‹ค. ์ด ํŒŒ์ผ์„ ๋‹ค๋ฅธ ์ €์žฅ์žฅ์น˜์—๋„ ๋ณต์‚ฌํ•˜๋ฉด ์ปดํ“จํ„ฐ ๋ฌธ์ œ์— ๋Œ€๋น„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ๋ช…๋ น์€ ์ €์žฅ ํŒŒ์ผ์„ ๊ทธ๋Œ€๋กœ ๋ณต์‚ฌํ•˜๋ฏ€๋กœ ํ•œ๊ธ€ ๋ฐ์ดํ„ฐ์˜ ์ธ์ฝ”๋”ฉ์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. PowerShell์˜ > ๊ธฐํ˜ธ๋กœ ๋‚ด์šฉ์„ ์ถœ๋ ฅํ•ด ๋ฐฑ์—…ํ•˜๋Š” ๋ฐฉ์‹์œผ๋กœ ๋ฐ”๊พธ์ง€ ๋งˆ์„ธ์š”. /data/state.json์ด ์—†๋‹ค๋Š” ์˜ค๋ฅ˜๊ฐ€ ๋‚˜์˜ค๋ฉด ๊ฒŒ์ž„์„ ์‹คํ–‰ํ•ด ํ•œ ๋ฒˆ ํ”Œ๋ ˆ์ดํ•˜๊ณ  ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•œ ๋’ค ๋‹ค์‹œ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

๋ง‰ํ˜”์„ ๋•Œ: ํ™”๋ฉด์˜ ์ฆ์ƒ๋ถ€ํ„ฐ ํ™•์ธํ•˜๊ธฐ

์ฆ์ƒ ๋จผ์ € ํ™•์ธํ•˜๊ณ  ํ•  ์ผ
docker๊ฐ€ ๋ช…๋ น์œผ๋กœ ์ธ์‹๋˜์ง€ ์•Š์Œ Docker Desktop์ด ์„ค์น˜๋๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ์„ค์น˜ ์ „๋ถ€ํ„ฐ ์—ด๋ ค ์žˆ๋˜ PowerShell์„ ๋‹ซ๊ณ  ์ƒˆ๋กœ ์—ฝ๋‹ˆ๋‹ค.
Client๋งŒ ๋‚˜์˜ค๊ณ  Server ์—ฐ๊ฒฐ์— ์‹คํŒจํ•จ Docker Desktop์„ ์‹คํ–‰ํ•˜๊ณ  ์—”์ง„์ด ์‹œ์ž‘๋  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฐ ๋’ค docker version์„ ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
WSL needs updating ๋˜๋Š” WSL ์—…๋ฐ์ดํŠธ ์š”๊ตฌ ๊ด€๋ฆฌ์ž PowerShell์—์„œ wsl --update๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์žฌ์‹œ์ž‘์ด ํ•„์š”ํ•˜๋ฉด ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.
Virtualization support not detected 12-3์œผ๋กœ ๋Œ์•„๊ฐ€ ์ž‘์—… ๊ด€๋ฆฌ์ž์˜ ๊ฐ€์ƒํ™” ์ƒํƒœ์™€ ์ œ์กฐ์‚ฌ ์•ˆ๋‚ด๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
no configuration file provided ๋˜๋Š” ์„ค์ • ํŒŒ์ผ์„ ์ฐพ์„ ์ˆ˜ ์—†์Œ Get-Location๊ณผ Get-ChildItem -Name์œผ๋กœ ํ˜„์žฌ ์œ„์น˜๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. compose.yaml์ด ์žˆ๋Š” ํด๋”์—์„œ ์‹คํ–‰ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
Dockerfile์„ ์ฐพ์„ ์ˆ˜ ์—†์Œ ZIP์„ ์‹ค์ œ๋กœ ํ’€์—ˆ๋Š”์ง€, Dockerfile๊ณผ compose.yaml์ด ๊ฐ™์€ ํด๋”์— ์žˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. Dockerfile.txt๋กœ ์ด๋ฆ„์„ ๋ฐ”๊พธ๋ฉด ์•ˆ ๋ฉ๋‹ˆ๋‹ค.
no matching manifest for windows/amd64 ๋“ฑ Windows ์ด๋ฏธ์ง€ ๊ด€๋ จ ์˜ค๋ฅ˜ Docker ๋ฉ”๋‰ด์—์„œ Switch to Linux containers๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค. docker info --format '{{.OSType}}'์˜ ๊ฒฐ๊ณผ๊ฐ€ linux์ธ์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
๋‹ค์šด๋กœ๋“œ๊ฐ€ ์˜ค๋ž˜ ๊ฑธ๋ฆฌ๊ฑฐ๋‚˜ timeout, DNS, ํ”„๋ก์‹œ ์˜ค๋ฅ˜๊ฐ€ ๋‚จ ์ธํ„ฐ๋„ท ์—ฐ๊ฒฐ๊ณผ ํ•™๊ตยทํšŒ์‚ฌ ๋„คํŠธ์›Œํฌ์˜ ๋‹ค์šด๋กœ๋“œ ํ—ˆ์šฉ ์—ฌ๋ถ€๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ์˜ค๋ฅ˜๊ฐ€ ๋๋‚œ ๋’ค ๊ฐ™์€ ๋ช…๋ น์„ ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
429, toomanyrequests ๋˜๋Š” ์ด๋ฏธ์ง€ ๋‹ค์šด๋กœ๋“œ ์ œํ•œ Docker Hub ๋‹ค์šด๋กœ๋“œ ์ œํ•œ์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. Docker Desktop์— ๋ณธ์ธ ๊ณ„์ •์œผ๋กœ ๋กœ๊ทธ์ธํ•œ ๋’ค ๋‹ค์‹œ ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค.
ํ•œ๊ธ€์ด ๊นจ์ง€๊ฑฐ๋‚˜ ๊ธฐํ˜ธ๊ฐ€ ๋„ค๋ชจ๋กœ ๋ณด์ž„ Windows Terminal์˜ PowerShell ํƒญ์—์„œ ๋‹ค์‹œ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ๋‹จ์ˆœํ•œ ์ด๋ชจ์ง€ ๊ธ€๊ผด ํ‘œ์‹œ ๋ฌธ์ œ์™€ ์‹ค์ œ ํ•œ๊ธ€ ๋ฐ์ดํ„ฐ ์†์ƒ์„ ๊ตฌ๋ถ„ํ•ฉ๋‹ˆ๋‹ค. ๊นจ์ง„ ๋‚ด์šฉ์„ ๋‹ค์‹œ ์ €์žฅํ•˜๊ธฐ ์ „์— ์ฐฝ์˜ ๊ธ€๊ผดยทํ‘œ์‹œ ์ƒํƒœ๋ฅผ ๋จผ์ € ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
the input device is not a TTY ๋˜๋Š” ๊ฒŒ์ž„ ์ž…๋ ฅ์„ ํ•  ์ˆ˜ ์—†์Œ ์ผ๋ฐ˜ PowerShell ์ฐฝ์—์„œ docker compose run --rm quiz๋ฅผ ์ง์ ‘ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. -T๋ฅผ ๋ถ™์ด๊ฑฐ๋‚˜ ๋‹ค๋ฅธ ๋ช…๋ น์˜ ์ถœ๋ ฅ๊ณผ ์—ฐ๊ฒฐํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
๋ฐ์ดํ„ฐ๋ฅผ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ๋ชปํ–ˆ์Šต๋‹ˆ๋‹ค๋ผ๋Š” ์ €์žฅ ์‹คํŒจ ์•ˆ๋‚ด ๊ฒŒ์ž„์ด ์•„์ง ์‹คํ–‰ ์ค‘์ด๋ฉด ์ฐฝ์„ ์—ด์–ด ๋‘” ์ฑ„ ์˜ค๋ฅ˜ ๋ฌธ๊ตฌ๋ฅผ ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค. ๋””์Šคํฌ ๊ณต๊ฐ„ ๋ถ€์กฑ ๋“ฑ ์›์ธ์„ ํ•ด๊ฒฐํ•œ ๋’ค ๋ฉ”๋‰ด 7๋กœ ์ €์žฅยท์ข…๋ฃŒ๋ฅผ ๋‹ค์‹œ ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฏธ ์ข…๋ฃŒ๋œ ๊ฒฝ์šฐ์—๋Š” ๋งˆ์ง€๋ง‰์œผ๋กœ ์ €์žฅ์— ์„ฑ๊ณตํ•œ ํŒŒ์ผ์„ ๊ธฐ์ค€์œผ๋กœ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ํ•ด๊ฒฐ๋˜์ง€ ์•Š์œผ๋ฉด ๋‹ด๋‹น ๊ฐ•์‚ฌ์—๊ฒŒ ๋ฌธ์˜ํ•˜๊ณ , ๊ธฐ์กด ๋ณผ๋ฅจ์€ ์‚ญ์ œํ•˜๊ฑฐ๋‚˜ ์ดˆ๊ธฐํ™”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
state.json์„ ๋ถˆ๋Ÿฌ์˜ค์ง€ ๋ชปํ•ด ๋˜๋Š” ์ด๋ฒˆ ์‹คํ–‰์—์„œ๋Š” ์ €์žฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค๋ผ๋Š” ์•ˆ๋‚ด ๊ธฐ์กด ํŒŒ์ผ์„ ๋ณดํ˜ธํ•˜๊ธฐ ์œ„ํ•ด ์ €์žฅ์ด ์ค‘์ง€๋œ ์ƒํƒœ์ž…๋‹ˆ๋‹ค. ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•œ ๋’ค ์˜ค๋ฅ˜ ๋ฌธ๊ตฌ์™€ ํ•จ๊ป˜ ๋‹ด๋‹น ๊ฐ•์‚ฌ์—๊ฒŒ ๋ฌธ์˜ํ•˜๊ณ  ๊ธฐ์กด ์ €์žฅ ๊ณต๊ฐ„์˜ ์ฝ๊ธฐยท์“ฐ๊ธฐ ๊ถŒํ•œ์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
์ข…๋ฃŒ ํ›„ ์ถ”๊ฐ€ ๋ฌธ์ œ๊ฐ€ ๋ณด์ด์ง€ ์•Š์Œ ๊ฐ™์€ compose.yaml๋กœ ์‹คํ–‰ํ–ˆ๋Š”์ง€, ์‹œ์ž‘ ์‹œ ์ €์žฅ ๋ฐ์ดํ„ฐ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ ์•ˆ๋‚ด๊ฐ€ ๋‚˜์™”๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋‹ค๋ฅธ PC๋‚˜ ๋‹ค๋ฅธ Docker ์—”์ง„์˜ ์ €์žฅ ๊ณต๊ฐ„๊ณผ ์ž๋™์œผ๋กœ ๊ณต์œ ๋˜์ง€๋Š” ์•Š์Šต๋‹ˆ๋‹ค.

์„ค์น˜๋‚˜ ์ €์žฅ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋ ค๊ณ  Docker Desktop์˜ Reset/์ดˆ๊ธฐํ™”, ๋ณผ๋ฅจ ์‚ญ์ œ, ์ „์ฒด ์ •๋ฆฌ ๋ช…๋ น์„ ๋จผ์ € ์‹คํ–‰ํ•˜์ง€ ๋งˆ์„ธ์š”. ์ด๋ฒˆ ์ •์ƒ ์‹ค์Šต ์ˆœ์„œ์—๋Š” ์ €์žฅ ๋ฐ์ดํ„ฐ ์‚ญ์ œ๊ฐ€ ํฌํ•จ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋„์›€์„ ์š”์ฒญํ•  ๋•Œ๋Š” ์‹คํ–‰ํ•œ ๋ช…๋ น, Get-Location์˜ ๊ฒฐ๊ณผ, ์˜ค๋ฅ˜ ๋ฌธ๊ตฌ ์ „์ฒด๋ฅผ ํ•จ๊ป˜ ์ „๋‹ฌํ•˜๋ฉด ์›์ธ์„ ์ฐพ๊ธฐ ์‰ฝ์Šต๋‹ˆ๋‹ค. Windows ์‚ฌ์šฉ์ž ์ด๋ฆ„ ๋“ฑ ๊ณต์œ ํ•˜๊ณ  ์‹ถ์ง€ ์•Š์€ ์ •๋ณด๋Š” ๊ฐ€๋ฆฌ๊ณ  ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค.

์ฐธ์—ฌ์ž ์™„๋ฃŒ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

  • Docker Desktop์ด ์‹คํ–‰๋˜๊ณ  docker version์— Client์™€ Server๊ฐ€ ๋ชจ๋‘ ๋‚˜์˜จ๋‹ค.
  • docker info --format '{{.OSType}}'์˜ ๊ฒฐ๊ณผ๊ฐ€ linux๋‹ค.
  • Hello from Docker!๋ฅผ ํ™•์ธํ–ˆ๋‹ค.
  • compose.yaml์ด ์žˆ๋Š” ํด๋”์—์„œ docker compose build๋ฅผ ์™„๋ฃŒํ–ˆ๋‹ค.
  • docker compose run --rm quiz๋กœ ๋ฉ”๋‰ด๋ฅผ ์—ด์—ˆ๋‹ค.
  • ๊ธฐ๋ณธ ๋ฌธ์ œ ํ•œ ๊ฐœ๋ฅผ ํ’€์—ˆ๋‹ค.
  • ์ˆ˜์—… ๋ณต์Šต ๋ฌธ์ œ ํ•œ ๊ฐœ๋ฅผ ์ถ”๊ฐ€ํ–ˆ๋‹ค.
  • ๋ฉ”๋‰ด 7๋กœ ์ข…๋ฃŒํ•œ ๋’ค ๋‹ค์‹œ ์‹คํ–‰ํ•ด ์ถ”๊ฐ€ ๋ฌธ์ œยท์ ์ˆ˜ยทํ”Œ๋ ˆ์ด ๊ธฐ๋ก์„ ํ™•์ธํ–ˆ๋‹ค.
  • ๋‹ค์Œ ๋‚  ์‹คํ–‰ํ•  ํด๋” ์œ„์น˜์™€ ๋ช…๋ น์„ ์•Œ๊ณ  ์žˆ๋‹ค.

๊ณต์‹ ๋ฌธ์„œ์™€ ํ”„๋กœ์ ํŠธ ๋งํฌ