Browse Source

๐ŸŒ Add Korean translation for `docs/ko/docs/advanced/sub-applications.md` (#4543)

* This PR translates advanced/sub-applications.md in Korean.

    Test complete

    related: #2017

* Update sub-applications.md

* Update sub-applications.md

* Update sub-applications.md

* remove .DS_Store

* ๐ŸŽจ [pre-commit.ci] Auto format from pre-commit.com hooks

* Update docs/ko/docs/advanced/sub-applications.md

* Update docs/ko/docs/advanced/sub-applications.md

* Update docs/ko/docs/advanced/sub-applications.md

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sebastiรกn Ramรญrez <[email protected]>
Co-authored-by: Motov Yurii <[email protected]>
pull/13284/merge
ChaeYeong Hwang 7 days ago
committed by GitHub
parent
commit
095dcc8a63
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 67
      docs/ko/docs/advanced/sub-applications.md

67
docs/ko/docs/advanced/sub-applications.md

@ -0,0 +1,67 @@
# ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ - ๋งˆ์šดํŠธ
๋งŒ์•ฝ ๊ฐ๊ฐ์˜ ๋…๋ฆฝ์ ์ธ OpenAPI์™€ ๋ฌธ์„œ UI๋ฅผ ๊ฐ–๋Š” ๋‘ ๊ฐœ์˜ ๋…๋ฆฝ์ ์ธ FastAPI ์‘์šฉํ”„๋กœ๊ทธ๋žจ์ด ํ•„์š”ํ•˜๋‹ค๋ฉด, ๋ฉ”์ธ ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜์— ํ•˜๋‚˜ (๋˜๋Š” ๊ทธ ์ด์ƒ์˜) ํ•˜์œ„-์‘์šฉํ”„๋กœ๊ทธ๋žจ(๋“ค)์„ โ€œ๋งˆ์šดํŠธ"ํ•ด์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
## **FastAPI** ์‘์šฉํ”„๋กœ๊ทธ๋žจ ๋งˆ์šดํŠธ
โ€œ๋งˆ์šดํŠธ"์ด๋ž€ ์™„์ „ํžˆ โ€œ๋…๋ฆฝ์ ์ธ" ์‘์šฉํ”„๋กœ๊ทธ๋žจ์„ ํŠน์ • ๊ฒฝ๋กœ์— ์ถ”๊ฐ€ํ•˜์—ฌ ํ•ด๋‹น ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์—์„œ ์„ ์–ธ๋œ *๊ฒฝ๋กœ ๋™์ž‘*์„ ํ†ตํ•ด ํ•ด๋‹น ๊ฒฝ๋กœ ์•„๋ž˜์— ์žˆ๋Š” ๋ชจ๋“  ์ž‘์—…๋“ค์„ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜๋Š” ๊ฒƒ์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค.
### ์ตœ์ƒ๋‹จ ์‘์šฉํ”„๋กœ๊ทธ๋žจ
๋จผ์ €, ๋ฉ”์ธ, ์ตœ์ƒ๋‹จ์˜ **FastAPI** ์‘์šฉํ”„๋กœ๊ทธ๋žจ๊ณผ ์ด๊ฒƒ์˜ *๊ฒฝ๋กœ ๋™์ž‘*์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค:
{* ../../docs_src/sub_applications/tutorial001.py hl[3, 6:8] *}
### ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ
๋‹ค์Œ์œผ๋กœ, ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ๊ณผ ์ด๊ฒƒ์˜ *๊ฒฝ๋กœ ๋™์ž‘*์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค:
์ด ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์€ ๋˜ ๋‹ค๋ฅธ ํ‘œ์ค€ FastAPI ์‘์šฉํ”„๋กœ๊ทธ๋žจ์ž…๋‹ˆ๋‹ค. ๋‹ค๋งŒ ์ด๊ฒƒ์€ โ€œ๋งˆ์šดํŠธโ€๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค:
{* ../../docs_src/sub_applications/tutorial001.py hl[11, 14:16] *}
### ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ ๋งˆ์šดํŠธ
์ตœ์ƒ๋‹จ ์‘์šฉํ”„๋กœ๊ทธ๋žจ, `app`์— ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ, `subapi`๋ฅผ ๋งˆ์šดํŠธํ•ฉ๋‹ˆ๋‹ค.
์ด ์˜ˆ์‹œ์—์„œ, ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์…˜์€ `/subapi` ๊ฒฝ๋กœ์— ๋งˆ์šดํŠธ ๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค:
{* ../../docs_src/sub_applications/tutorial001.py hl[11, 19] *}
### ์ž๋™์œผ๋กœ ์ƒ์„ฑ๋œ API ๋ฌธ์„œ ํ™•์ธ
์ด์ œ, `uvicorn`์œผ๋กœ ๋ฉ”์ธ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์„ ์‹คํ–‰ํ•˜์‹ญ์‹œ์˜ค. ๋‹น์‹ ์˜ ํŒŒ์ผ์ด `main.py`๋ผ๋ฉด, ์ด๋ ‡๊ฒŒ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค:
<div class="termy">
```console
$ uvicorn main:app --reload
<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
</div>
๊ทธ๋ฆฌ๊ณ  <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>์—์„œ ๋ฌธ์„œ๋ฅผ ์—ฌ์‹ญ์‹œ์˜ค.
๋ฉ”์ธ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์˜ *๊ฒฝ๋กœ ๋™์ž‘*๋งŒ์„ ํฌํ•จํ•˜๋Š”, ๋ฉ”์ธ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์— ๋Œ€ํ•œ ์ž๋™ API ๋ฌธ์„œ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
<img src="https://fastapi.tiangolo.com//img/tutorial/sub-applications/image01.png">
๋‹ค์Œ์œผ๋กœ, <a href="http://127.0.0.1:8000/subapi/docs" class="external-link" target="_blank">http://127.0.0.1:8000/subapi/docs</a>์—์„œ ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์˜ ๋ฌธ์„œ๋ฅผ ์—ฌ์‹ญ์‹œ์˜ค.
ํ•˜์œ„ ๊ฒฝ๋กœ ์ ‘๋‘์‚ฌ `/subapi` ์•„๋ž˜์— ์„ ์–ธ๋œ *๊ฒฝ๋กœ ๋™์ž‘* ์„ ํฌํ•จํ•˜๋Š”, ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์— ๋Œ€ํ•œ ์ž๋™ API ๋ฌธ์„œ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
<img src="https://fastapi.tiangolo.com//img/tutorial/sub-applications/image02.png">
๋‘ ์‚ฌ์šฉ์ž ์ธํ„ฐํŽ˜์ด์Šค ์ค‘ ์–ด๋А ํ•˜๋‚˜๋ฅผ ์‚ฌ์šฉํ•ด์•ผํ•˜๋Š” ๊ฒฝ์šฐ, ๋ธŒ๋ผ์šฐ์ €๋Š” ํŠน์ • ์‘์šฉํ”„๋กœ๊ทธ๋žจ ๋˜๋Š” ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ๊ณผ ๊ฐ๊ฐ ํ†ต์‹ ํ•  ์ˆ˜ ์žˆ๊ธฐ ๋•Œ๋ฌธ์— ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ๋™์ž‘ํ•  ๊ฒƒ์ž…๋‹ˆ๋‹ค.
### ๊ธฐ์ˆ ์  ์„ธ๋ถ€์‚ฌํ•ญ: `root_path`
์œ„์— ์„ค๋ช…๋œ ๊ฒƒ๊ณผ ๊ฐ™์ด ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์„ ๋งˆ์šดํŠธํ•˜๋Š” ๊ฒฝ์šฐ, FastAPI๋Š” `root_path`๋ผ๊ณ  ํ•˜๋Š” ASGI ๋ช…์„ธ์˜ ๋งค์ปค๋‹ˆ์ฆ˜์„ ์‚ฌ์šฉํ•˜์—ฌ ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์— ๋Œ€ํ•œ ๋งˆ์šดํŠธ ๊ฒฝ๋กœ ํ†ต์‹ ์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
์ด๋ฅผ ํ†ตํ•ด, ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์€ ๋ฌธ์„œ UI๋ฅผ ์œ„ํ•ด ๊ฒฝ๋กœ ์ ‘๋‘์‚ฌ๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•œ๋‹ค๋Š” ์‚ฌ์‹ค์„ ์ธ์ง€ํ•ฉ๋‹ˆ๋‹ค.
ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์—๋„ ์—ญ์‹œ ๋‹ค๋ฅธ ํ•˜์œ„ ์‘์šฉํ”„๋กœ๊ทธ๋žจ์„ ๋งˆ์šดํŠธํ•˜๋Š” ๊ฒƒ์ด ๊ฐ€๋Šฅํ•˜๋ฉฐ FastAPI๊ฐ€ ๋ชจ๋“  `root_path` ๋“ค์„ ์ž๋™์ ์œผ๋กœ ์ฒ˜๋ฆฌํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๋ชจ๋“  ๊ฒƒ์€ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ๋™์ž‘ํ•  ๊ฒƒ์ž…๋‹ˆ๋‹ค.
`root_path`์™€ ์ด๊ฒƒ์„ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด์„œ๋Š” [ํ”„๋ก์‹œ์˜ ๋’ท๋‹จ](./behind-a-proxy.md){.internal-link target=_blank} ์„น์…˜์—์„œ ๋ฐฐ์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
Loadingโ€ฆ
Cancel
Save