]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/advanced/sub-applications.md` (#4543)
authorChaeYeong Hwang <79563565+NinaHwang@users.noreply.github.com>
Thu, 12 Jun 2025 07:32:09 +0000 (09:32 +0200)
committerGitHub <noreply@github.com>
Thu, 12 Jun 2025 07:32:09 +0000 (09:32 +0200)
* 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 <tiangolo@gmail.com>
Co-authored-by: Motov Yurii <109919500+YuriiMotov@users.noreply.github.com>
docs/ko/docs/advanced/sub-applications.md [new file with mode: 0644]

diff --git a/docs/ko/docs/advanced/sub-applications.md b/docs/ko/docs/advanced/sub-applications.md
new file mode 100644 (file)
index 0000000..c5835de
--- /dev/null
@@ -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} μ„Ήμ…˜μ—μ„œ λ°°μšΈ μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.