์ฝ๋์ธ์ด AI ์ฌ์ธ์ ๊ณผ์ ยท Windows 11 ์ฌ์ฉ์ ์๋ด
์ฒ์ ์ค์นํ๋ ๋ถ์ 12. ์์ ์ด๋ณด๋ฅผ ์ํ ์ค์น๋ถํฐ ๋ฐ๋ผํ๊ธฐ ํ๋ ์ด๋ถ๋ถํฐ ์์ํ์ธ์. ํด๋ฆญํ ์์น, ๋ณต์ฌํ ๋ช ๋ น์ด, ๋จ๊ณ๋ณ ์ฑ๊ณต ํ์ธ๊น์ง ์์๋๋ก ์๋ดํฉ๋๋ค.
ํฐ๋ฏธ๋์์ ๋์ํ๋ 4์ง์ ๋ค ํด์ฆ ๊ฒ์์
๋๋ค.
๋ฉ๋ด์์ ๋ฒํธ๋ฅผ ๊ณจ๋ผ ํด์ฆ๋ฅผ ํ๊ณ , ์ง์ ํด์ฆ๋ฅผ ์ถ๊ฐยท์ญ์ ํ๊ณ , ์ต๊ณ ์ ์์ ๊ฒ์ ๊ธฐ๋ก์ ํ์ธํ ์ ์์ต๋๋ค.
ํ๋ก๊ทธ๋จ์ ์ข
๋ฃํ๋ค๊ฐ ๋ค์ ์คํํด๋ ํด์ฆ์ ์ ์๋ state.json ํ์ผ์ ์ ์ฅ๋์ด ๊ทธ๋๋ก ๋จ์ ์์ต๋๋ค.
| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| ํํ | 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์ฅ) |
์ฃผ์ : Python & Git ๊ธฐ์ด
- ๋ง๋๋ ๊ณผ์ ์ด ๊ณง ๋ณต์ต์ด๋ค. ์ด ๋ฏธ์ ์์ ๋ฐฐ์ฐ๋ ์๋ฃํ, ๋ฐ๋ณต๋ฌธ, ํด๋์ค, JSON, ์์ธ ์ฒ๋ฆฌ, Git ๋ช ๋ น์ด๋ฅผ ๋ฌธ์ ๋ก ๋ง๋ค์์ต๋๋ค. ์ข์ 4์ง์ ๋ค ๋ฌธ์ ๋ฅผ ๋ด๋ ค๋ฉด ์ ๋ต๋ฟ ์๋๋ผ ์ค๋ต ์ ํ์ง๊ฐ ์ ํ๋ ธ๋์ง๋ ์์์ผ ํด์, ๋ฌธ์ ๋ฅผ ๋ง๋๋ ๊ณผ์ ์์ ๊ฐ๋ ์ ํ ๋ฒ ๋ ์ ๋ฆฌํ ์ ์์์ต๋๋ค.
- ์ฝ๋์ ํด์ฆ๊ฐ ์๋ก๋ฅผ ์ค๋ช
ํ๋ค.
int('abc')๊ฐValueError๋ฅผ ๋ด๋ ๊ฒ(์ซ์ ์ ๋ ฅ ๊ฒ์ฆ),None์ด JSON์์null๋ก ์ ์ฅ๋๋ ๊ฒ(best_score) ๋ฑ ์ด ๊ฒ์์ ๋ง๋ค๋ฉด์ ์ค์ ๋ก ๋ง์ฃผ์น ๋ด์ฉ์ ๋ฌธ์ ๋ก ๋ฃ์์ต๋๋ค. - ํจ๊ป ์ธ ์ ์๋ค. ๊ฐ์ ๊ณผ์ ์ ๋ฐ๋ ๋๋ฃ๋ค๋ ๋ฐ๋ก ํ์ด ๋ณด๋ฉฐ ๋ณต์ตํ ์ ์๋ ์ฃผ์ ์ ๋๋ค.
Windows 11์์ Docker๋ฅผ ์ฒ์ ์ฌ์ฉํ๋ ๊ณผ์ ์ฐธ์ฌ์๋ 12์ฅ ์ค์น๋ถํฐ ๋ฐ๋ผํ๊ธฐ ํ๋ ์ด๋ถ์ ์ด์ฉํ์ธ์.
๋ ๊ฐ์ง ๋ฐฉ๋ฒ์ด ์์ต๋๋ค. PC ํ๊ฒฝ๊ณผ ์๊ด์์ด ๋๊ฐ์ด ์คํํ๋ ค๋ฉด ๋ฐฉ๋ฒ 1(Docker)์ ๊ถ์ฅํฉ๋๋ค.
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 ์คํ ๊ฐ์ด๋์ ๋ชจ๋ ์์ต๋๋ค.
# 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์ฅ)
| ๋ฒํธ | ๋ฉ๋ด | ์ค๋ช |
|---|---|---|
| 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.bak1๊ฐ๋ง ์ ์งํฉ๋๋ค. ์์์ด ๋ค์ ์๊ธฐ๋ฉด ์ด์ ๋ฐฑ์ ์ ์ ์์ ํ์ผ๋ก ๋ฎ์ด์๋๋ค. ๊ทธ๋์ ๋ณต๊ตฌ ์๋ด๊ฐ ๋์ค๋ฉด ๋ค์ ์คํ ์ ์.bak์ ํ์ธํ๊ฑฐ๋ ๋ค๋ฅธ ์ด๋ฆ์ผ๋ก ๋ณต์ฌํด ๋์ธ์. ๋ฐฑ์ ์ ์คํจํ๋ฉด(๊ถํ ๋ฑ) ๊ธฐ๋ณธ๊ฐ์ผ๋ก ๋ฎ์ด์ฐ์ง ์๊ณ ๊ทธ ์คํ์์๋ ์ ์ฅ์ ๋๋๋ค. - ์ฌ์ฉ์ ์๋ฆผ: ๋ณต๊ตฌยท์ ์ฅ ์คํจยท์ ์ฅ ์ค์ง๋ ๋ชจ๋ ์ฒซ ํ๋ฉด์ด๋ ํด๋น ์์ ์
โ ๏ธ๋ฉ์์ง๋ก ์๋ฆฌ๊ณ , ๋ฐฑ์ ํ์ผ ์ด๋ฆ์ ํจ๊ป ๋ณด์ฌ ์ค๋๋ค. - ๋์ ์คํ: ๊ฐ์
state.json์ผ๋ก ํ๋ก๊ทธ๋จ์ ๋ ๊ฐ ๋์์ ์คํํ๋ฉด ๋์ค์ ์ ์ฅํ ์ชฝ์ ๋ด์ฉ์ด ๋จ์ต๋๋ค(ํ์ผ ์ ๊ธ ์์). ํ์ผ์ด ๊นจ์ง์ง๋ ์์ง๋ง(๊ต์ฒด ๋ฐฉ์) ๋จผ์ ์ ์ฅํ ์ชฝ์ ๋ณ๊ฒฝ์ ์ฌ๋ผ์ง ์ ์์ผ๋ ํ ๋ฒ์ ํ๋๋ง ์คํํ์ธ์. ์ ๊ธ์ด ํ์ํ ๊ท๋ชจ๋ผ๋ฉด 11์ฅ์ SQLite ์ ํ์์ ๋ฐ๋ฆ ๋๋ค.
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์ฅ์ ์ค์ธก๊ฐ๊ณผ ํจ๊ป ์ ๋ฆฌํ์ต๋๋ค.
| ํญ๋ชฉ | ๋ด์ฉ |
|---|---|
| ๊ฒฝ๋ก | ํ๋ก์ ํธ ๋ฃจํธ (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๋ก ์ข
๋ฃํ ํ๋ฉด๊ณผ, ๋ค์ ์คํํด์ 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 ์์ ์ข ๋ฃ |
|---|---|---|
![]() |
![]() |
![]() |
| ํญ๋ชฉ | ๋ด์ฉ (ํด๋ฆญํด์ 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 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- ๊ท์น:
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์ด ๋ค์ ์ค๋ฉด ๋ฌด์ํด ์ ์ฅ์ด ์ค๊ฐ์ ๋๊ธฐ์ง ์๊ฒ ํจ
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์ ํจ๊ป ๋ง๋ ์๊ฒฉ ์ ์ฅ์์ ์ฒซ ์ปค๋ฐ๊ณผ ๋ก์ปฌ ์ด๋ ฅ์ ํฉ์น ๋ณํฉ์ ๋๋ค.)
| ๋ช ๋ น์ด | ์ด ํ๋ก์ ํธ์์ ์ฌ์ฉํ ๊ณณ |
|---|---|
git init |
ํ๋ก์ ํธ ํด๋๋ฅผ Git ์ ์ฅ์๋ก ๋ง๋ค๊ธฐ |
git add / git commit |
๊ธฐ๋ฅ ํ๋๋ฅผ ์์ฑํ ๋๋ง๋ค ๋ณ๊ฒฝ ํ์ผ์ ์คํ ์ด์งํ๊ณ ๊ธฐ๋ก |
git checkout -b / git checkout |
๊ธฐ๋ฅ ๋ธ๋์น๋ฅผ ๋ง๋ค์ด ์ด๋, ์์
ํ main์ผ๋ก ๋ณต๊ท |
git merge |
๊ธฐ๋ฅ ๋ธ๋์น๋ฅผ main์ ๋ณํฉ |
git push |
๋ก์ปฌ ์ปค๋ฐ์ GitHub ์๊ฒฉ ์ ์ฅ์์ ์ ๋ก๋ |
git clone |
์๊ฒฉ ์ ์ฅ์๋ฅผ ๋ค๋ฅธ ํด๋์ ๋ณต์ (๋ณต์ ์ค์ต) |
git pull |
๋ณต์ ๋ณธ์์ ์ฌ๋ฆฐ ๋ณ๊ฒฝ ์ฌํญ์ ๊ธฐ์กด ์์ ํด๋๋ก ๊ฐ์ ธ์ค๊ธฐ (๋ณต์ ์ค์ต) |
- ์ด ๊ฒ์์ ๊ทธ๋ฅ ์คํํ๋ ค๋ฉด PC์ Python 3.10 ์ด์์ด ์์ด์ผ ํฉ๋๋ค. ๊ทธ๋ฐ๋ฐ PC๋ง๋ค OS, Python ๋ฒ์ , ๋ฌธ์ ์ธ์ฝ๋ฉ์ด ๋ฌ๋ผ์ "๋ด PC์์๋ ๋๋๋ฐ ๋ค๋ฅธ PC์์๋ ์ ๋๋" ์ผ์ด ์๊น๋๋ค.
- Docker๋ Linux + Python 3.12.16 + ๊ฒ์ ์ฝ๋๋ฅผ ํ๋์ ์ด๋ฏธ์ง๋ก ๋ฌถ์ต๋๋ค. ๋๊ฐ ์ด๋ค OS์์ ์คํํด๋ ์ปจํ ์ด๋ ์์ ๋๊ฐ์ ํ๊ฒฝ์ ๋๋ค.
- PC์ Python์ ์ค์นํ์ง ์์๋ ๋ฉ๋๋ค. Docker๋ง ์์ผ๋ฉด ๋ฉ๋๋ค.
| ์ฉ์ด | ๋ป |
|---|---|
| ์ด๋ฏธ์ง | ์คํ ํ๊ฒฝ๊ณผ ์ฝ๋๋ฅผ ๋ฌถ์ '์ค์น๋ณธ'. Dockerfile๋ก ๋ง๋ญ๋๋ค. |
| ์ปจํ ์ด๋ | ์ด๋ฏธ์ง๋ฅผ ์คํํ ๊ฒ. ๊ฒ์ ํ ๋ฒ = ์ปจํ ์ด๋ ํ๋. ๋๋๋ฉด ์ง์๋ ๋ฉ๋๋ค. |
| ๋ณผ๋ฅจ | ์ปจํ
์ด๋๋ฅผ ์ง์๋ ๋จ๋ ์ ์ฅ ๊ณต๊ฐ. state.json์ ์ฌ๊ธฐ์ ๋ณด๊ดํฉ๋๋ค. |
| OS | ์ค์นํ ๊ฒ |
|---|---|
| Windows 10/11 | Docker Desktop (์ค์น ์ค WSL 2 ์ฌ์ฉ ์ ํ) |
| macOS (Intel / Apple Silicon) | Docker Desktop |
| Linux | Docker Engine + Docker Compose ํ๋ฌ๊ทธ์ธ |
- ์ค์น ์๋ด: https://docs.docker.com/get-started/get-docker/ (Linux: https://docs.docker.com/engine/install/)
- WindowsยทmacOS๋ Docker Desktop์ ์คํํด ๋ ์ํ์์ ๋ช ๋ น์ด๋ฅผ ์ ๋ ฅํฉ๋๋ค.
- ์ค์น ํ์ธ:
docker --version
docker compose versiongit 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๋ก ์คํํฉ๋๋ค.
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์ ๊ฐ์ ์ ํธ๋ฅผ ๋ณด๋
๋๋ค.)
| ํ๊ณ ์ถ์ ์ผ | ๋ฐฉ๋ฒ 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์ ์ฌ๋ผ๊ฐ์ง ์์ต๋๋ค.
| ํ๊ฒฝ | ๊ฒ์ ์คํ ๋ช ๋ น | ํ์ฌ ํด๋ ํ๊ธฐ | ์ฐธ๊ณ |
|---|---|---|---|
| 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 ์คํ์ ๋งค๋ฒ ํ์ธํฉ๋๋ค.
์๋ ๊ฒฐ๊ณผ๊ฐ ๊ทธ๋๋ก ๋์ค๋ฉด ์ด ํ๋ก์ ํธ๊ฐ ์ฌ๋ฌ๋ถ์ 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 โ ํด์ฆยท์ ์ยท๊ฒ์ ๊ธฐ๋ก ์ญ์ . ์ค์น ํ์ธ์๋ ํ์ํ์ง ์์ต๋๋ค. |
๊ณผ์ ๊ธฐ์ค ์ต์ ๋ฒ์ (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| ์ํฉ | ํ ์ผ |
|---|---|
| ์ฒ์ ํ๋ก์ ํธ์ ์ฐธ์ฌ | 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 ๋น๋ยท์คํ
| ์ฆ์ | ์์ธ | ํด๊ฒฐ |
|---|---|---|
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 |
| ํ์ผ | ์ญํ |
|---|---|
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 ์๋ฒ์์ ์ ์ฒดํฌ๋ฆฌ์คํธ๋ฅผ ์๋์ผ๋ก ์คํํฉ๋๋ค. |
# 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) ์ปจํ ์ด๋๋ก ์คํํด ๋ชจ๋ ํ์ธํฉ๋๋ค.
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๋ฐฐ์ผ ๋ ๋ช ๋ฐฐ๊ฐ ๋๋์ง๋ฅผ ๋ณด๋ฉด ๋ฉ๋๋ค.
| ํด์ฆ ์ | 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 |
| ์์ | ๋ฌธ์ | ๊ทผ๊ฑฐ (์ค์ธก) | ์ํฅ |
|---|---|---|---|
| 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 | ๋ฉ๋ชจ๋ฆฌ ์์ ๋ฆฌ์คํธ ์ฒ๋ฆฌ๋ ์ถฉ๋ถํ ๋น ๋ฆ ๋๋ค. ์ด ๊ท๋ชจ์ ๋ณ๋ชฉ์ '์ธ๋ฑ์ค๊ฐ ์์ด์'๊ฐ ์๋๋ผ ํ ํ์ผ์ ํต์งธ๋ก ์ฝ๊ณ ์ฐ๋ ๊ตฌ์กฐ์ ์ ๋ถ ์ถ๋ ฅํ๋ ํ๋ฉด์ ๋๋ค. |
| ๊ท๋ชจ | ํ๋จ | ๊ฐ์ ์ |
|---|---|---|
| 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์ฅ ํ์ฅ ์๋๋ฆฌ์ค)
Windows 11 ยท ์ฝ๋์ธ์ด AI ์ฌ์ธ์ ๊ณผ์ ์ฐธ์ฌ์์ฉ
ํ์ธ์ผ: 2026-11-12
๋ชฉํ๋ ๋ด Windows 11 ์ปดํจํฐ์์ Docker๋ก ํด์ฆ ๊ฒ์์ ์คํํ๊ณ , ๋ฌธ์ ๋ฅผ ์ถ๊ฐํ ๋ค ๊ฒ์์ ๊ป๋ค ์ผ๋ ๊ธฐ๋ก์ด ๋จ๋ ๊ฒ์ ํ์ธํ๋ ๊ฒ์ ๋๋ค.
์๋ ๊ณผ์ ์์๋ GitHub์์ ZIP ๋ค์ด๋ก๋ โ Docker Compose๋ก ์คํํ๋ ํ ๊ฐ์ง ๋ฐฉ๋ฒ์ ์ฌ์ฉํฉ๋๋ค. ๋ช ๋ น์ด๋ Windows PowerShell์ ์ ๋ ฅํฉ๋๋ค. Windows์ Python์ด๋ Git์ ๋ฐ๋ก ์ค์นํ๊ฑฐ๋ Ubuntu ์ฌ์ฉ์ ๊ณ์ ์ ๋ง๋ค ํ์๋ ์์ต๋๋ค.
๋ช ๋ น์ด ์ ๋ ฅ ๊ท์น
ํ์ ์ฝ๋ ์์์ ๋ด์ฉ์ ๋ณต์ฌํด PowerShell์ ๋ถ์ฌ ๋ฃ๊ณ Enter๋ฅผ ๋๋ฆ ๋๋ค. ํ ๋จ๊ณ์ ๊ฒฐ๊ณผ๋ฅผ ํ์ธํ ๋ค ๋ค์ ๋จ๊ณ๋ก ์ด๋ํ์ธ์. ํ๋ฉด์ ์ด๋ฏธ ํ์๋PS C:\...>๊ฐ์ ๊ธ์๋ ๋ณต์ฌํ๊ฑฐ๋ ์ ๋ ฅํ์ง ์์ต๋๋ค. ๊ฒ์์ด ์คํ๋ ๋์์๋ ๊ทธ ์ฐฝ์ PowerShell ๋ช ๋ น ๋์ ๊ฒ์ ๋ฉ๋ด ๋ฒํธ๋ฅผ ์ ๋ ฅํฉ๋๋ค.
| ์ด๋ฆ | ์ด๋ฒ ์ค์ต์์ ํ๋ ์ผ |
|---|---|
| Docker Desktop | Windows์์ ์ปจํ ์ด๋๋ฅผ ์คํํ๋ ํ๋ก๊ทธ๋จ์ ๋๋ค. |
| ์ด๋ฏธ์ง | ๊ฒ์ ์ฝ๋์ Python ์คํ ํ๊ฒฝ์ ํจ๊ป ๋ด์ ์คํ ์ค๋น๋ฌผ์ ๋๋ค. |
| ์ปจํ ์ด๋ | ์ด๋ฏธ์ง๋ฅผ ์ฌ์ฉํด ์ค์ ๋ก ์คํ ์ค์ธ ๊ฒ์์ ๋๋ค. |
Docker Compose๋ ํด๋ ์์ compose.yaml์ ์ฝ์ด ์คํ ์ค์ ์ ์ ์ฉํฉ๋๋ค. ์ค๋์ ์ค์ ์ ์ธ์ฐ๋ ๋์ ์ ํด์ง ๋ช
๋ น์ด๋ฅผ ์คํํ๋ฉด ๋ฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: ๊ฒ์์ PowerShell ์ฐฝ ์์์ ์งํ๋ฉ๋๋ค. ์น๋ธ๋ผ์ฐ์ ์ฃผ์๋ฅผ ์ ๋ ฅํ๊ฑฐ๋ ๋ณ๋์ ๊ฒ์ ์ฐฝ์ ์ฐพ์ง ์์๋ ๋ฉ๋๋ค.
- ์์ โ ์ค์ โ Windows ์ ๋ฐ์ดํธ๋ฅผ ์ฝ๋๋ค.
- ์ ๋ฐ์ดํธ๋ฅผ ํ์ธํ๊ณ , ์ค์น ํ ์ฌ์์์ด ํ์ํ๋ฉด ์ฌ์์ํฉ๋๋ค.
- ์ค์ โ ์์คํ โ ์ ๋ณด๋ฅผ ์ฝ๋๋ค.
- ์ค์น๋ RAM์ด 8GB ์ด์์ธ์ง ํ์ธํฉ๋๋ค.
- ์์คํ ์ข ๋ฅ์ ํ๋ก์ธ์ ํญ๋ชฉ์ ํ์ธํฉ๋๋ค.
| ํ์ธ ๊ฒฐ๊ณผ | ๋์ค์ ๋ฐ์ Docker ์ค์น ํ์ผ |
|---|---|
| ์ผ๋ฐ์ ์ธ Intel/AMD ๊ธฐ๋ฐ x64 ์ปดํจํฐ | Windows โ x86_64 |
| ARM ๊ธฐ๋ฐ ์ปดํจํฐ | Windows โ Arm |
Docker๋ Microsoft์ ์ง์ ๊ธฐ๊ฐ ์์ ์๋ Windows ๋ฒ์ ์ ์ง์ํฉ๋๋ค. ์ค๋๋ Windows 11์ ์ ๋ฐ์ดํธํ์ง ์์ ์ฑ ์งํํ์ง ๋ง์ธ์. ์ฌ์์ ์ ํํ ๊ธฐ์ค์ Docker ๊ณต์ Windows ์ค์น ๋ฌธ์์์ ํ์ธํ ์ ์์ต๋๋ค.
- ํค๋ณด๋์์ Ctrl + Shift + Esc๋ฅผ ํจ๊ป ๋๋ฆ ๋๋ค.
- ์์ ๊ด๋ฆฌ์๊ฐ ์ด๋ฆฌ๋ฉด ์ฑ๋ฅ โ CPU๋ฅผ ์ ํํฉ๋๋ค.
- ํ๋ฉด์ ๊ฐ์ํ ํญ๋ชฉ์ ์ฐพ์ต๋๋ค.
- ์ฌ์ฉ ๋๋ Enabled๋ก ํ์๋๋ฉด ๋ค์ ๋จ๊ณ๋ก ๊ฐ๋๋ค.
์ฌ์ฉ ์ ํจ ๋๋ Disabled๋ผ๋ฉด BIOS/UEFI์์ ๊ฐ์ํ๋ฅผ ์ผ์ผ ํฉ๋๋ค. ์ ์กฐ์ฌ์ ๋ชจ๋ธ๋ง๋ค ๋ฉ๋ด๊ฐ ๋ค๋ฅด๋ฏ๋ก Microsoft์ ๊ฐ์ํ ํ์ฑํ ์๋ด์์ ์์ ์ ์ ์กฐ์ฌ ์๋ด๋ฅผ ํ์ธํ์ธ์.
Windows์์ ํด๋น ์ค์ ํ๋ฉด์ผ๋ก ๋ค์ด๊ฐ๋ ๊ณตํต ๊ฒฝ๋ก๋ ์ค์ โ ์์คํ โ ๋ณต๊ตฌ โ ๊ณ ๊ธ ์์ ์ต์ โ ์ง๊ธ ๋ค์ ์์ โ ๋ฌธ์ ํด๊ฒฐ โ ๊ณ ๊ธ ์ต์ โ UEFI ํ์จ์ด ์ค์ โ ๋ค์ ์์์ ๋๋ค. ๊ฐ์ํ๋ฅผ ์ผ๊ณ Windows๋ก ๋์์จ ๋ค ์์ ๊ด๋ฆฌ์์์ ๋ค์ ํ์ธํฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: ๊ฐ์ํ: ์ฌ์ฉ์ด ๋ณด์
๋๋ค.
- ์์ ํ์์ค์ ์์ ๋ฒํผ์ ๋ง์ฐ์ค ์ค๋ฅธ์ชฝ ๋ฒํผ์ผ๋ก ํด๋ฆญํฉ๋๋ค.
- **ํฐ๋ฏธ๋(๊ด๋ฆฌ์)**๋ฅผ ์ ํํฉ๋๋ค.
- โ์ด ์ฑ์ด ๋๋ฐ์ด์ค๋ฅผ ๋ณ๊ฒฝํ๋๋ก ํ์ฉํ์๊ฒ ์ด์?โ๊ฐ ๋์ค๋ฉด ์๋ฅผ ๋๋ฆ ๋๋ค.
- PowerShell ํญ์ด ์ด๋ ธ๋์ง ํ์ธํฉ๋๋ค. ๋ช
๋ น์ค ์์ ๋ณดํต
PS๊ฐ ํ์๋ฉ๋๋ค.
๋ค๋ฅธ ์ข ๋ฅ์ ํญ์ด ์ด๋ ธ๋ค๋ฉด ํฐ๋ฏธ๋ ์๋จ์ ์๋์ชฝ ํ์ดํ โ Windows PowerShell์ ์ ํํฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: ์ฐฝ ์ ๋ชฉ์ ๊ด๋ฆฌ์ ํ์๊ฐ ์๊ณ PowerShell ๋ช ๋ น์ ์ ๋ ฅํ ์ ์์ต๋๋ค.
WSL์ Windows์์ Linux ์คํ ํ๊ฒฝ์ ์ฌ์ฉํ ์ ์๊ฒ ํ๋ ๊ตฌ์ฑ์์์ ๋๋ค. ๊ด๋ฆฌ์ PowerShell์ ๋ค์ ๋ช ๋ น์ ์ ๋ ฅํฉ๋๋ค.
wsl --version- WSL๊ณผ ์ปค๋์ ๋ฒ์ ์ ๋ณด๊ฐ ๋์ค๋ฉด 12-6์ ๊ฑด๋๋ฐ๊ณ 12-7๋ก ๊ฐ๋๋ค.
- ์ค์น๋์ง ์์๋ค๋ ์๋ด๊ฐ ๋์ค๋ฉด 12-6์ ์งํํฉ๋๋ค.
- ๋ฒ์ ์ ๋ณด ๋์ ๋์๋ง๋ง ๋์จ๋ค๋ฉด ๊ธฐ์กด Windows ๋ด์ฅ WSL์ผ ์ ์์ต๋๋ค. 12-7์ ์ ๋ฐ์ดํธ๋ถํฐ ์งํํ ๋ค ๋ฒ์ ์ ๋ณด๋ฅผ ๋ค์ ํ์ธํฉ๋๋ค.
wsl --version์ ๋์ค๋ WSL ํ๋ก๊ทธ๋จ ๋ฒ์ ๊ณผ โWSL 2โ๋ผ๋ ์คํ ๋ฐฉ์์ ์ซ์๋ ๋ค๋ฅธ ์๋ฏธ์
๋๋ค. ์ด ์ค์ต์์๋ ์ต์ WSL๋ก ์
๋ฐ์ดํธํด ์ฌ์ฉํฉ๋๋ค.
WSL์ด ์ค์น๋์ด ์์ง ์์ ๋๋ง ๊ด๋ฆฌ์ PowerShell์์ ์คํํฉ๋๋ค.
wsl --install --no-distribution์ค์น๊ฐ ๋๋๋ฉด ์์ ์ค์ธ ๋ฌธ์๋ฅผ ์ ์ฅํ๊ณ ์์ โ ์ ์ โ ๋ค์ ์์์ผ๋ก ์ปดํจํฐ๋ฅผ ์ฌ์์ํฉ๋๋ค.
--no-distribution์ Ubuntu ๊ฐ์ ๋ณ๋ Linux ๋ฐฐํฌํ์ ํจ๊ป ์ค์นํ์ง ์๋๋ค๋ ๋ป์
๋๋ค. ์ด ์ค์ต์ Windows PowerShell์์ ์งํํ๋ฏ๋ก Ubuntu ์ค์น์ Ubuntu ์ฌ์ฉ์๋ช
ยท์ํธ ์์ฑ์ ํ์ํ์ง ์์ต๋๋ค.
์๋ฃ ๊ธฐ์ค: ์ค์น๊ฐ ์๋ฃ๋๊ณ Windows์ ๋ค์ ๋ก๊ทธ์ธํ์ต๋๋ค.
12-4์ ๊ฐ์ ๋ฐฉ๋ฒ์ผ๋ก ๊ด๋ฆฌ์ PowerShell์ ์ด๊ณ ํ ์ค์ฉ ์คํํฉ๋๋ค.
wsl --updatewsl --set-default-version 2wsl --versionDocker์ ๊ณต์ ์ต์ ์๊ฑด์ WSL ๋ฒ์ 2.1.5 ์ด์์ ๋๋ค. โ์ต์ ๋ฒ์ ์ด ์ด๋ฏธ ์ค์น๋์ด ์์ต๋๋คโ๋ผ๋ ์๋ด๋ ์ ์์ ๋๋ค. ์ฌ์์์ ์๊ตฌํ๋ฉด ์ฌ์์ํ ๋ค ๋ค์ ํ์ธํฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: wsl --version์์ WSL ๋ฒ์ ์ด 2.1.5 ์ด์์ผ๋ก ํ์๋ฉ๋๋ค. --no-distribution์ผ๋ก ์ค์นํ ๋ค Linux ๋ฐฐํฌํ ๋ชฉ๋ก์ด ๋น์ด ์๋ ๊ฒ ์์ฒด๋ ์ค๋ฅ๊ฐ ์๋๋๋ค.
- ์น๋ธ๋ผ์ฐ์ ์์ Docker ๊ณต์ Windows ์ค์น ํ์ด์ง๋ฅผ ์ฝ๋๋ค.
- 12-2์์ ํ์ธํ ์ปดํจํฐ ์ข ๋ฅ์ ๋ง๋ Windows โ x86_64 ๋๋ Windows โ Arm ๋ค์ด๋ก๋๋ฅผ ์ ํํฉ๋๋ค.
- ๋ค์ด๋ก๋๊ฐ ๋๋ ๋๊น์ง ๊ธฐ๋ค๋ฆฝ๋๋ค.
- ํ์ผ ํ์๊ธฐ์ ๋ค์ด๋ก๋ ํด๋๋ฅผ ์ฝ๋๋ค.
- ๋ฐ์
Docker Desktop Installer.exe๋ฅผ ์คํํฉ๋๋ค.
์ผ๋ฐ์ ์ธ Intel/AMD ์ปดํจํฐ์์๋ x86_64๋ฅผ ์ ํํฉ๋๋ค. Arm์ ARM ๊ธฐ๋ฐ ์ปดํจํฐ์ฉ์ด๋ฉฐ, ๊ณต์ ํ์ด์ง์์ ์ ๊ณต ์ํ๋ฅผ ํ์ธํ์ธ์.
์ค์น ํ๋ฉด์ ์ ํ์ง๊ฐ ๋์ค๋ฉด ๋ค์ ๊ธฐ์ค์ผ๋ก ์งํํฉ๋๋ค.
| ์ค์น ํ๋ฉด์ ํญ๋ชฉ | ์ ํํ ๋ด์ฉ |
|---|---|
์ค์น ๋์: Per-user / All users |
๊ฐ์ธ ์ค์ต PC๋ผ๋ฉด ๊ธฐ๋ณธ๊ฐ์ธ Per-user |
| ์คํ ๋ฐฉ์ ๋๋ Backend ์ ํ | WSL 2 |
Use WSL 2 instead of Hyper-V ์ฒดํฌ๋ฐ์ค๊ฐ ์๋ ์ด์ ํํ์ ํ๋ฉด |
์ฒดํฌ |
์ค์น ํ๋ฉด ๋ชจ์์ ๋ฒ์ ์ ๋ฐ๋ผ ๋ค๋ฆ ๋๋ค. ์ต์ ํ๋ฉด์์ WSL 2๋ฅผ ์ ํํ๋ค๋ฉด ์์ ์ฒดํฌ๋ฐ์ค๊ฐ ๋ฐ๋ก ์์ด๋ ๋ฉ๋๋ค.
์ค์น๋ฅผ ๋ง์น๊ณ ์ฌ์์์ ์์ฒญํ๋ฉด Close and restart ๋ฑ ํ๋ฉด์ ์๋ด์ ๋ฐ๋ผ ์ฌ์์ํฉ๋๋ค. ๊ด๋ฆฌ์ ๊ถํ์ ์์ฒญํ๋ ์ฐฝ์ด ๋์ค๋ฉด ๋ด์ฉ์ ํ์ธํ ๋ค ์ค์น๋ฅผ ์งํํฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: ์์ ๋ฉ๋ด์์ Docker Desktop์ ๊ฒ์ํ ์ ์์ต๋๋ค.
- ์์์ ๋๋ฅด๊ณ
Docker Desktop์ ๊ฒ์ํด ์คํํฉ๋๋ค. - ์ฒ์ ํ์๋๋ ์ด์ฉ์ฝ๊ด์ ํ์ธํ๊ณ ์งํํฉ๋๋ค.
- ๊ฐ์ธ ์ค์ต ํ๊ฒฝ์์ ๋ก๊ทธ์ธ ๊ฑด๋๋ฐ๊ธฐ๊ฐ ์ ๊ณต๋๋ฉด ๊ฑด๋๋ฐ์ด๋ ๋ฉ๋๋ค. ์กฐ์ง์ด ๊ด๋ฆฌํ๋ PC๋ ์กฐ์ง์ ๋ก๊ทธ์ธ ์ ์ฑ ์ ๋ฐ๋ฆ ๋๋ค.
- Docker ์์ง์ด ์์๋ ๋๊น์ง ๊ธฐ๋ค๋ฆฝ๋๋ค.
- Settings โ General์์ WSL 2 ์์ง์ ์ฌ์ฉํ๋์ง ํ์ธํฉ๋๋ค.
Use WSL 2 based engineํญ๋ชฉ์ด ๋ณด์ด๋ฉด ์ผญ๋๋ค.
์ด๋ฏธ WSL 2๊ฐ ๊ธฐ๋ณธ์ผ๋ก ์ค์ ๋ ์ปดํจํฐ์์๋ ํด๋น ํญ๋ชฉ์ด ๋ณด์ด์ง ์์ ์ ์์ต๋๋ค. Windows ์ปจํ ์ด๋ ๋ชจ๋๋ก ์ค์ ๋ ๊ฒฝ์ฐ์๋ ์์ ํ์์ค์ Docker ๋ฉ๋ด์์ Switch to Linux containers๋ฅผ ์ ํํฉ๋๋ค.
์๋ฃ ๊ธฐ์ค: Docker Desktop์ ์์ ์ค๋ฅ๊ฐ ์๊ณ ์์ง์ด ์คํ ์ค์ ๋๋ค. Windows Home์์๋ ์ด๋ฒ ์ค์ต์ Linux ์ปจํ ์ด๋ ๋ฐฉ์์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
C ๋๋ผ์ด๋ธ ๊ณต๊ฐ์ด ๋ถ์กฑํ๊ณ D ๋๋ผ์ด๋ธ๊ฐ ์๋ ๊ฒฝ์ฐ, ์ด๋ฏธ์ง ๋ค์ด๋ก๋์ ๊ฒ์ ๋น๋ ์ ์ ์งํํฉ๋๋ค. D ๋๋ผ์ด๋ธ๊ฐ ์๊ฑฐ๋ ๊ธฐ๋ณธ ์์น๋ฅผ ์ฌ์ฉํ ๊ฒฝ์ฐ ๋ค์ ๋จ๊ณ๋ก ๊ฐ๋๋ค.
- ํ์ผ ํ์๊ธฐ์์ D ๋๋ผ์ด๋ธ๋ฅผ ์ฝ๋๋ค.
- ๋น ์ ์ฉ ํด๋
DockerData๋ฅผ ๋ง๋ญ๋๋ค. - Docker Desktop์์ Settings โ Resources โ Advanced๋ฅผ ์ฝ๋๋ค.
- Disk image location์์
D:\DockerData๋ฅผ ์ ํํฉ๋๋ค. - Apply ๋๋ Apply & restart๋ก ์ ์ฉํ๊ณ ์์ง์ด ๋ค์ ์์๋ ๋๊น์ง ๊ธฐ๋ค๋ฆฝ๋๋ค.
๊ฒ์ ์์ค๋ฅผ D ๋๋ผ์ด๋ธ์ ์ ์ฅํ๋ ๊ฒ๊ณผ Docker ๋ฐ์ดํฐ ์ ์ฅ ์์น๋ฅผ D ๋๋ผ์ด๋ธ๋ก ์ ํ๋ ๊ฒ์ ๋ณ๊ฐ์ ์์ ์ ๋๋ค. ์ ์ค์ ์ Docker์ ์ด๋ฏธ์งยท์ปจํ ์ด๋ ๋ฐ์ดํฐ๋ฅผ ์ฎ๊ธฐ๋ ์ค์ ์ด๋ฉฐ, Windows ๊ตฌ์ฑ์์์ Docker ํ๋ก๊ทธ๋จ์ด C ๋๋ผ์ด๋ธ๋ฅผ ์ ํ ์ฌ์ฉํ์ง ์๊ฒ ๋ง๋๋ ์ค์ ์ ์๋๋๋ค.
์์น ๋ณ๊ฒฝ ํญ๋ชฉ์ด ๋ณด์ด์ง ์์ผ๋ฉด ์์๋ก Docker์ ๋ฐ์ดํฐ ํด๋๋ฅผ ์ฎ๊ธฐ๊ฑฐ๋ ์ง์ฐ์ง ๋ง๊ณ Docker WSL 2 ๊ณต์ ์๋ด์ ์ค์น ๋ฒ์ ์ ํ์ธํฉ๋๋ค.
์ด์ ๊ด๋ฆฌ์ 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!๊ฐ ๋์ต๋๋ค. ์ด ๋ฌธ๊ตฌ๋ฅผ ํ์ธํ ๋ค ๊ฒ์ ์ค์น๋ก ๋์ด๊ฐ๋๋ค.
- python-quiz-game ์ ์ฅ์๋ฅผ ์ฝ๋๋ค.
- ํ์ผ ๋ชฉ๋ก ์์ Code ๋ฒํผ์ ๋๋ฆ ๋๋ค.
- Download ZIP์ ์ ํํฉ๋๋ค.
- ๋ค์ด๋ก๋ ํด๋์
python-quiz-game-main.zip์ด ์๊ฒผ๋์ง ํ์ธํฉ๋๋ค.
์ด๋ฒ ์ค์ต์์๋ Git ํ๋ก๊ทธ๋จ ์ค์น๋ git clone ๋ช
๋ น์ด ํ์ํ์ง ์์ต๋๋ค.
- ํ์ผ ํ์๊ธฐ์์ D ๋๋ผ์ด๋ธ์
docker-projectsํด๋๋ฅผ ๋ง๋ญ๋๋ค. - ZIP ํ์ผ์ ๋ง์ฐ์ค ์ค๋ฅธ์ชฝ ๋ฒํผ์ผ๋ก ํด๋ฆญํ๊ณ ๋ชจ๋ ์์ถ ํ๊ธฐ๋ฅผ ์ ํํฉ๋๋ค.
- ์์ถ์ ํ ์์น๋ฅผ
D:\docker-projects๋ก ์ง์ ํ๊ณ ์์ถ ํ๊ธฐ๋ฅผ ๋๋ฆ ๋๋ค. - ์์ถ์ ํผ ๋ค
python-quiz-game-mainํด๋๋ฅผ ์ฝ๋๋ค.
D ๋๋ผ์ด๋ธ๊ฐ ์๋ค๋ฉด: ์์ ์์น๋ฅผ C:\docker-projects๋ก ์ ํฉ๋๋ค. ์ดํ์๋ ํ์ผ ํ์๊ธฐ์์ ํด๋น ํด๋๋ฅผ ์ด์ด ์งํํ๋ฏ๋ก ๋ช
๋ น์ด๋ฅผ ์ผ์ผ์ด ์์ ํ์ง ์์๋ ๋ฉ๋๋ค.
ํ์ผ ํ์๊ธฐ์ ๋ณด๊ธฐ โ ํ์ โ ํ์ผ ์ด๋ฆ ํ์ฅ๋ช
์ ์ผ๋ฉด ํ์ผ ์ด๋ฆ ๋ค์ .yaml, .py, .md๊น์ง ํ์ธํ ์ ์์ต๋๋ค.
์ด๋ฆฐ ํด๋์์ ๋ค์ ํ์ผ์ด ํจ๊ป ๋ณด์ฌ์ผ ํฉ๋๋ค.
compose.yamlDockerfilemain.pyREADME.md
ํด๋ ์์ python-quiz-game-main์ด๋ผ๋ ํด๋๋ง ๋ณด์ด๋ฉด ๊ทธ ์์ผ๋ก ํ ๋ฒ ๋ ๋ค์ด๊ฐ๋๋ค. ZIP ํ์ผ ๋ด๋ถ๋ฅผ ๋ณด๊ณ ์๋ ์ํ๊ฐ ์๋๋ผ ์์ถ์ ํผ ์ผ๋ฐ ํด๋์ฌ์ผ ํฉ๋๋ค.
compose.yaml,Dockerfile,main.py๊ฐ ๋ณด์ด๋ ํ์ผ ํ์๊ธฐ ์ฐฝ์ ์ ์งํฉ๋๋ค.- ์์ชฝ ์ฃผ์ ํ์์ค์ ํด๋ฆญํฉ๋๋ค. ์ค๋ฅธ์ชฝ ๊ฒ์์ฐฝ์ด ์๋๋๋ค.
- ๊ธฐ์กด ๊ฒฝ๋ก ๋์
powershell์ด๋ผ๊ณ ์ ๋ ฅํ๊ณ Enter๋ฅผ ๋๋ฆ ๋๋ค. - ์๋ก ์ด๋ฆฐ PowerShell์์ ๋ค์ ๋ ๋ช ๋ น์ ์ฐจ๋ก๋๋ก ์คํํฉ๋๋ค.
Get-Location์๋ฅผ ๋ค์ด D:\docker-projects\python-quiz-game-main์ด ํ์๋ฉ๋๋ค. C ๋๋ผ์ด๋ธ์ ์์ถ์ ํ์๋ค๋ฉด C๋ก ์์ํฉ๋๋ค.
Get-ChildItem -Name์๋ฃ ๊ธฐ์ค: ์ถ๋ ฅ ๋ชฉ๋ก์ compose.yaml, Dockerfile, main.py๊ฐ ์์ต๋๋ค. ์ด ์ธ ํ์ผ์ด ์๋ ์์น์์๋ ๋ค์ ๋ช
๋ น์ ์คํํ์ง ๋ง๊ณ 12-14์์ ํด๋ ์์น๋ฅผ ๋ค์ ํ์ธํฉ๋๋ค.
๊ฒ์ ํด๋์์ ์ฐ PowerShell์ ์ ๋ ฅํฉ๋๋ค.
docker compose buildDocker๊ฐ ํ์ํ Python ์ด๋ฏธ์ง์ ๊ฒ์ ์ฝ๋๋ฅผ ์ค๋นํฉ๋๋ค. ์ฒ์์๋ ์ธํฐ๋ท์์ ํ์ผ์ ๋ด๋ ค๋ฐ์ผ๋ฏ๋ก ์๊ฐ์ด ๊ฑธ๋ฆด ์ ์์ต๋๋ค. ํ์ฌ ํ๋ก์ ํธ๋ Dockerfile์ ์ง์ ๋ Python์ ์ฌ์ฉํ๋ฏ๋ก Windows์ Python์ ๋ณ๋๋ก ์ค์นํ์ง ์์ต๋๋ค.
์๋ฃ ๊ธฐ์ค: ๋น๋๊ฐ ์ค๋ฅ ์์ด ๋๋๊ณ PS ...> ์
๋ ฅ์ค๋ก ๋์์ต๋๋ค. ๋นจ๊ฐ ์ค๋ฅ๋ failed๊ฐ ๋์ค๋ฉด ์๋์ ๋ฌธ์ ํด๊ฒฐ ํ์์ ํด๋น ์ฆ์์ ๋จผ์ ํ์ธํฉ๋๋ค.
๊ฐ์ ์ฐฝ์์ ์คํํฉ๋๋ค.
docker compose run --rm quiz์ฒ์ ์ ์ฅ ๊ณต๊ฐ์ ๋ง๋๋ ๊ฒฝ์ฐ์๋ ๋ค์๊ณผ ๊ฐ์ ์๋ด์ ๊ฒ์ ๋ฉ๋ด๊ฐ ๋์ต๋๋ค.
๐ ์ ์ฅ๋ ๋ฐ์ดํฐ๊ฐ ์์ด ๊ธฐ๋ณธ ํด์ฆ 8๊ฐ๋ก ์์ํฉ๋๋ค.
| ๋ฉ๋ด ๋ฒํธ | ํ ์ ์๋ ์ผ |
|---|---|
| 1 | ํด์ฆ ํ๊ธฐ |
| 2 | ํด์ฆ ์ถ๊ฐ |
| 3 | ํด์ฆ ๋ชฉ๋ก ๋ณด๊ธฐ |
| 4 | ์ต๊ณ ์ ์ ํ์ธ |
| 5 | ํด์ฆ ์ญ์ |
| 6 | ์ต๊ทผ ํ๋ ์ด ๊ธฐ๋ก ๋ณด๊ธฐ |
| 7 | ์ข ๋ฃ |
์๋ฃ ๊ธฐ์ค: ์ ํ:์ด๋ผ๋ ์
๋ ฅ ์๋ด๊ฐ ๋ณด์
๋๋ค. ๊ธฐ์กด์ ์คํํ ์ ์ด ์๋ค๋ฉด ๊ธฐ๋ณธ 8๊ฐ ์๋ด ๋์ ์ ์ฅ๋ ๋ฐ์ดํฐ๋ฅผ ๋ถ๋ฌ์๋ค๋ ์๋ด๊ฐ ๋์ค๋ ๊ฒ์ด ์ ์์
๋๋ค.
์ ํ:์ 1์ ์ ๋ ฅํ๊ณ Enter๋ฅผ ๋๋ฆ ๋๋ค.๋ช ๋ฌธ์ ๋ฅผ ํ๊น์?์ 1์ ์ ๋ ฅํ๊ณ Enter๋ฅผ ๋๋ฆ ๋๋ค.- ํ๋ฉด์ ๋์จ ๋ฌธ์ ์ ๋ค ๊ฐ์ ์ ํ์ง๋ฅผ ์ฝ์ต๋๋ค. ๋ฌธ์ ๋ ๋ฌด์์๋ก ์ ํ๋ฉ๋๋ค.
์ ๋ต ์ ๋ ฅ (1-4, ํํธ h):์ ์ ๋ต์ด๋ผ๊ณ ์๊ฐํ๋ 1~4 ์ค ํ๋๋ฅผ ์ ๋ ฅํฉ๋๋ค.- ํํธ๋ฅผ ๋จผ์ ๋ณด๊ณ ์ถ์ผ๋ฉด h๋ฅผ ์ ๋ ฅํ๊ณ , ๊ทธ๋ค์ ์ ๋ต ๋ฒํธ๋ฅผ ์ ๋ ฅํฉ๋๋ค.
- ์ฑ์ ๊ฒฐ๊ณผ๋ฅผ ํ์ธํฉ๋๋ค.
์ฒ์์๋ ์ ๋ต์ ๋งํ๋ ๊ฒ๋ณด๋ค ๋ฌธ์ ์ ํ โ ๋ต ์ ๋ ฅ โ ๊ฒฐ๊ณผ ํ์ธ์ด ๋์ํ๋์ง ํ์ธํ๋ ๊ฒ์ด ๋ชฉ์ ์ ๋๋ค. ํ ๋ฒ์ ํ๋ ์ด๋ฅผ ๋๋ด๋ฉด ๊ฒฐ๊ณผ๊ฐ ํ๋ ์ด ๊ธฐ๋ก์ ์ ์ฅ๋ฉ๋๋ค.
๊ฒ์ ๋ฉ๋ด์ ์ ํ:์ 2๋ฅผ ์
๋ ฅํฉ๋๋ค. ๊ทธ๋ค์ ํ๋ฉด์ ์ง๋ฌธ์ ๋ง์ถฐ ์๋ ๋ด์ฉ์ ํ ์นธ์ฉ ์
๋ ฅํ๊ณ Enter๋ฅผ ๋๋ฆ
๋๋ค.
| ํ๋ฉด์ ๋์ค๋ ์ ๋ ฅ ์๋ด | ์ ๋ ฅํ ๋ด์ฉ |
|---|---|
๋ฌธ์ ๋ฅผ ์
๋ ฅํ์ธ์: |
Docker์์ ์ด๋ฏธ์ง๋ฅผ ๋ง๋๋ ๋ฐฉ๋ฒ์ ์ ๋ ํ์ผ์? |
์ ํ์ง 1: |
Dockerfile |
์ ํ์ง 2: |
README.md |
์ ํ์ง 3: |
main.py |
์ ํ์ง 4: |
state.json |
์ ๋ต ๋ฒํธ (1-4): |
1 |
ํํธ (์์ผ๋ฉด ๊ทธ๋ฅ Enter): |
ํ์ผ ์ด๋ฆ์ Docker๊ฐ ๋ค์ด๊ฐ๋๋ค. |
์๋ฃ ๊ธฐ์ค: ํด์ฆ๊ฐ ์ถ๊ฐ๋์์ต๋๋ค!๋ผ๋ ์๋ด๊ฐ ๋์ต๋๋ค. ์ฒ์ ์ ๊ณต๋๋ 8๊ฐ์ ์ด ๋ฌธ์ ํ๋๋ฅผ ์ถ๊ฐํ๋ค๋ฉด ์ด 9๊ฐ์
๋๋ค. ๊ธฐ์กด ๋ฐ์ดํฐ๊ฐ ์๋ค๋ฉด ์๋ ๊ฐ์๋ณด๋ค ํ๋ ๋์ด๋ฉ๋๋ค.
์ ํ:์ 3์ ์
๋ ฅํ์ฌ ๋ชฉ๋ก์์ ๋ฐฉ๊ธ ์
๋ ฅํ ๋ฌธ์ ๋ฅผ ํ์ธํฉ๋๋ค. ํด์ฆ ํ๊ธฐ์์๋ ๋ฌด์์๋ก ์ถ์ ๋๋ฏ๋ก, ํ ๋ฌธ์ ๋ง ํ์์ ๋ ์ ๋ฌธ์ ๊ฐ ๋ฐ๋์ ๋์ค๋ ๊ฒ์ ์๋๋๋ค.
- ๊ฒ์ ๋ฉ๋ด์
์ ํ:์ 7์ ์ ๋ ฅํฉ๋๋ค. - ์ข
๋ฃ ์๋ด๊ฐ ๋์ค๊ณ
PS ...>์ ๋ ฅ์ค๋ก ๋์์ค๋์ง ํ์ธํฉ๋๋ค. - ๊ฐ์ ํด๋์์ ๋ค์ ์คํํฉ๋๋ค.
docker compose run --rm quiz- ์ ์ฅ๋ ๋ฐ์ดํฐ๋ฅผ ๋ถ๋ฌ์์ต๋๋ค๋ผ๋ ์๋ด๋ฅผ ํ์ธํฉ๋๋ค.
- ๋ฉ๋ด 3์์ ์ถ๊ฐํ Docker ๋ฌธ์ ๋ฅผ ํ์ธํฉ๋๋ค.
- ๋ฉ๋ด 4์์ ์ต๊ณ ์ ์๋ฅผ ํ์ธํฉ๋๋ค.
- ๋ฉ๋ด 6์์ ์์์ ํ ๋ฌธ์ ๋ฅผ ํผ ๊ธฐ๋ก์ ํ์ธํฉ๋๋ค.
- ํ์ธ์ ๋ง์น๋ฉด ๋ฉ๋ด 7๋ก ์ข ๋ฃํฉ๋๋ค.
์ด ํ๋ก์ ํธ์ ์ ์ฅ ํ์ผ์ ์ปจํ
์ด๋ ์์ /data/state.json์ด๋ฉฐ, ์ค์ ๋ฐ์ดํฐ๋ python-quiz-game_quiz-data๋ผ๋ Docker ์ด๋ฆ ์๋ ๋ณผ๋ฅจ์ ๋ณด๊ด๋ฉ๋๋ค. --rm์ ์ข
๋ฃํ ์คํ์ฉ ์ปจํ
์ด๋๋ฅผ ์ ๋ฆฌํ๋ ์ต์
์ด๋ฏ๋ก ์ด ์ ์ฅ ๋ณผ๋ฅจ์ ์ ์ง๋ฉ๋๋ค.
์ข ๋ฃ ํ Docker Desktop์ Containers ๋ชฉ๋ก์์ ๊ฒ์ ์ปจํ ์ด๋๊ฐ ์ฌ๋ผ์ ธ๋ ์ ์์ ๋๋ค. ๋ฐ์ดํฐ๋ Volumes์ ํด๋น ๋ณผ๋ฅจ์ ๋จ์ต๋๋ค.
์ด์ ๊ท์น: ๊ฐ์ ์ ์ฅ ๊ณต๊ฐ์ ์ฌ์ฉํ๋ ๊ฒ์์ ํ ๋ฒ์ ํ๋๋ง ์คํํฉ๋๋ค. ์ฌ๋ฌ ์ฐฝ์์ ๋์์ ์คํํ๋ฉด ๊ฐ ๊ฒ์์ ์ ์ฅ ๋ด์ฉ์ด ์๋ก ๋ฎ์ผ ์ ์์ต๋๋ค.
์ต์ด ์ค์น๋ฅผ ๋ค์ ํ ํ์๋ ์์ต๋๋ค. ๋ค์ ์์๋ง ๋ฐ๋ณตํฉ๋๋ค.
- Docker Desktop์ ์คํํ๊ณ ์์ง ์์์ ๊ธฐ๋ค๋ฆฝ๋๋ค.
- ํ์ผ ํ์๊ธฐ์์ ์์ถ์ ํ์ด ๋ ๊ฒ์ ํด๋๋ฅผ ์ฝ๋๋ค.
- ์ฃผ์ ํ์์ค์
powershell์ ์ ๋ ฅํ๊ณ Enter๋ฅผ ๋๋ฆ ๋๋ค. - ์๋ ๋ช ๋ น์ ์คํํฉ๋๋ค.
docker compose run --rm quiz- ์ค์ต์ ๋ง์น๋ฉด ๊ฒ์ ๋ฉ๋ด 7๋ก ์ข ๋ฃํฉ๋๋ค.
๊ฒ์ ์์ค๋ Dockerfile์ ๋ฐ๊ฟจ์ ๋๋ ๋ค์ docker compose build๋ฅผ ์คํํ ๋ค ๊ฒ์์ ์์ํฉ๋๋ค. ํ์ ์ฌ์คํ์๋ ๋น๋๊ฐ ํ์ํ์ง ์์ต๋๋ค. ZIP ํ์ผ์ ์๋ก ๋ค์ด๋ก๋ํ๋ ์์
๋ ๋งค๋ฒ ํ ํ์๊ฐ ์์ต๋๋ค.
๋จผ์ ์คํ ์ค์ธ ๊ฒ์์ ๋ฉ๋ด 7๋ก ์ข ๋ฃํ๊ณ , ์ ์ฅ ์คํจ ๊ฒฝ๊ณ ๊ฐ ์์๋์ง ํ์ธํฉ๋๋ค. Docker Desktop์ ์ผ ๋ก๋๋ค. ๊ฒ์ ํด๋์ PowerShell์์ ์๋ ๋ช ๋ น์ ์์๋๋ก ์คํํฉ๋๋ค.
$quizBackupStamp = Get-Date -Format "yyyyMMdd-HHmmss"New-Item -ItemType Directory -Path .\backup -Forcedocker 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๋ก ์ข ๋ฃํ ๋ค ๋ค์ ์คํํด ์ถ๊ฐ ๋ฌธ์ ยท์ ์ยทํ๋ ์ด ๊ธฐ๋ก์ ํ์ธํ๋ค.
- ๋ค์ ๋ ์คํํ ํด๋ ์์น์ ๋ช ๋ น์ ์๊ณ ์๋ค.
- ํ๋ก์ ํธ ์๋ณธ ์ ์ฅ์
- Docker Desktop: Windows ์ค์นยท๋ค์ด๋ก๋ยท์์คํ ์๊ฑด
- Docker Desktop: WSL 2 ์ค์ ๊ณผ ๋ฐ์ดํฐ ์ ์ฅ ์์น
- Docker Compose: ์ค์น ์๋ด
- Docker:
docker version๋ช ๋ น - Microsoft: WSL ์ค์น
- Microsoft: WSL ๊ธฐ๋ณธ ๋ช
๋ น๊ณผ
--no-distribution - Microsoft: Windows์์ ๊ฐ์ํ ํ์ฑํ







