Skip to content

Conversation

@soohyunme
Copy link
Member

๐Ÿ“ PR ํƒ€์ž…

  • ๋ฒ„๊ทธ ์ˆ˜์ •
  • ์‹ ๊ทœ ๊ธฐ๋Šฅ
  • ๋ฌธ์„œ ์—…๋ฐ์ดํŠธ
  • ์ฝ”๋“œ ์Šคํƒ€์ผ ์—…๋ฐ์ดํŠธ (ํฌ๋งทํŒ…, ์„ธ๋ฏธ์ฝœ๋ก  ์ถ”๊ฐ€ ๋“ฑ)
  • ๋ฆฌํŒฉํ† ๋ง
  • ๊ธฐํƒ€

๐Ÿ“œ ์„ค๋ช…

Traefik์˜ stripPrefix ์„ค์ •๊ณผ FastAPI์˜ /api prefix๊ฐ€ ์ถฉ๋Œํ•˜์—ฌ
ํ”„๋ก ํŠธ์—”๋“œ์—์„œ API ํ˜ธ์ถœ ์‹œ /api/api/* ๊ตฌ์กฐ๊ฐ€ ๋ฐœ์ƒํ•˜๊ณ ,
Swagger ๋ฌธ์„œ(/docs, /redoc, /openapi.json) ๋˜ํ•œ ํ”„๋ก ํŠธ๋กœ ๋ผ์šฐํŒ…๋˜์–ด 404๊ฐ€ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ–ˆ์Šต๋‹ˆ๋‹ค.

๋ณธ PR์€ getcloser ์„œ๋น„์Šค์™€ ๋™์ผํ•œ ๋ผ์šฐํŒ… ํŒจํ„ด์œผ๋กœ ์ •๋ฆฌํ•˜์—ฌ
FastAPI prefix ์œ ์ง€ + Traefik stripPrefix ์ œ๊ฑฐ ๋ฐฉ์‹์œผ๋กœ ์ •์ƒ ๋ผ์šฐํŒ…๋˜๋„๋ก ์กฐ์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.

์—ฎ์ธ ์ด์Šˆ

  • Closes #

๐Ÿ”จ ์ž‘์—… ๋‚ด์šฉ

  • FastAPI docs_url / redoc_url / openapi_url ์„ค์ • ์ œ๊ฑฐ (prefix ์ถฉ๋Œ ํ•ด์†Œ)
  • servers=[{"url": "/api"}] ์ œ๊ฑฐํ•˜์—ฌ Swagger์—์„œ ์ž˜๋ชป๋œ ๋ฒ ์ด์Šค ๊ฒฝ๋กœ๊ฐ€ ์žกํžˆ๋Š” ๋ฌธ์ œ ํ•ด๊ฒฐ
  • Traefik backend ๋ผ์šฐํŒ… rule์„ /api, /docs, /redoc, /health, /openapi.json ์ „์ฒด๋ฅผ backend๋กœ ์ „๋‹ฌํ•˜๋„๋ก ํ†ตํ•ฉ
  • ๊ธฐ์กด stripPrefix ๋ฏธ๋“ค์›จ์–ด ๋ฐ ๋ณ„๋„ docs router ์ œ๊ฑฐ
  • ํ”„๋ก ํŠธ์—์„œ ์ ‘๊ทผํ•˜๋˜ /api/api/* ๋ฌธ์ œ ํ•ด๊ฒฐ

๐Ÿ“ธ ์Šคํฌ๋ฆฐ์ƒท


๐Ÿง‘โ€๐Ÿ’ป ํ…Œ์ŠคํŠธ ๊ฒฐ๊ณผ

  • https://<domain>/api/upload โ†’ ์ •์ƒ ํ˜ธ์ถœ
  • https://<domain>/docs โ†’ ์ •์ƒ ์ ‘๊ทผ
  • ํ”„๋ก ํŠธ์—์„œ ๋” ์ด์ƒ /api/api/* ํ˜•ํƒœ๋กœ ํ˜ธ์ถœ๋˜์ง€ ์•Š์Œ

๐Ÿ“… ์ฒดํฌ๋ฆฌ์ŠคํŠธ

  • ์ดํ•ดํ•˜๊ธฐ ์–ด๋ ค์šด ๋ถ€๋ถ„์— ์ฃผ์„์„ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค.
  • ๊ด€๋ จ๋œ ๋ฌธ์„œ๋ฅผ ์—…๋ฐ์ดํŠธํ–ˆ์Šต๋‹ˆ๋‹ค.

@yesinkim
Copy link
Member

์ˆ˜ํ˜„๋‹˜! ํ˜น์‹œ ๋กœ๊ทธ์ธ api์•ž์—๋„ api/auth/๋กœ ๋ถ™์–ด์•ผ ํ• ๊นŒ์š”?! ์ œ๊ฐ€ ์ด๊ฑธ ์ง€๊ธˆ ํ™•์ธํ–ˆ๋„ค์š”!

@soohyunme
Copy link
Member Author

@yesinkim
์ œ๊ฐ€ ์ดํ•ด๋ฅผ ์ž˜ ๋ชปํ–ˆ๋Š”๋ฐ, ๋ณธ PR์ด ๊ธฐ์กด ์ฝ”๋“œ์—์„œ ๋™์ž‘๋˜๋„๋ก ์ˆ˜์ •ํ•œ PR์ž…๋‹ˆ๋‹ค !

@soohyunme soohyunme requested a review from yesinkim November 27, 2025 16:16
@soohyunme
Copy link
Member Author

@yesinkim
fastapi์—์„œ /api prefix๋ฅผ ๋ชจ๋“  ๋ผ์šฐํŠธ์— ์ž๋™์œผ๋กœ ์ถ”๊ฐ€ํ•ด์„œ ์•ˆ๋ถ™์—ฌ์ค˜๋„ ๊ดœ์ฐฎ์Šต๋‹ˆ๋‹ค !

@soohyunme soohyunme merged commit 06b9c2f into dev Nov 30, 2025
@soohyunme soohyunme deleted the fix/backend-traefik-routing branch November 30, 2025 14:36
@github-actions github-actions bot added merged and removed approved labels Nov 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants