]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Update Korean translation for `/docs/ko/docs/deployment/docker.md` (#11113)
authorKani Kim <kkh5428@gmail.com>
Fri, 9 Feb 2024 10:33:00 +0000 (19:33 +0900)
committerGitHub <noreply@github.com>
Fri, 9 Feb 2024 10:33:00 +0000 (05:33 -0500)
docs/ko/docs/deployment/docker.md

index 587b445fc25973ac556610fff801f9741a0f26f4..1c7bced2caba42cd2f61df03727757c90b6a5545 100644 (file)
@@ -4,7 +4,7 @@ FastAPI μ–΄ν”Œλ¦¬μΌ€μ΄μ…˜μ„ λ°°ν¬ν•  λ•Œ μΌλ°˜μ μΈ μ ‘κ·Ό λ°©λ²•은 **리
 
 λ¦¬λˆ…μŠ€ μ»¨ν…Œμ΄λ„ˆλ₯Ό μ‚¬μš©ν•˜λŠ” λ°μ—λŠ” **λ³΄μ•ˆ**, **반볡 κ°€λŠ₯μ„±**, **λ‹¨μˆœν•¨** λ“±μ˜ μž₯점이 μžˆμŠ΅λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     μ‹œκ°„에 μ«“κΈ°κ³  μžˆκ³  μ΄λ―Έ μ΄λŸ°κ²ƒλ“€μ„ μ•Œκ³  μžˆλ‹€λ©΄ [`Dockerfile`πŸ‘‡](#build-a-docker-image-for-fastapi)둜 μ ν”„ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
 
 <details>
@@ -130,7 +130,7 @@ Successfully installed fastapi pydantic uvicorn
 
 </div>
 
-!!! μ •보
+!!! info "정보"
     νŒ¨ν‚€μ§€ μ’…속성을 μ •μ˜ν•˜κ³  μ„€μΉ˜ν•˜κΈ° μœ„ν•œ λ°©λ²•κ³Ό λ„κ΅¬λŠ” λ‹€μ–‘ν•©λ‹ˆλ‹€.
 
     λ‚˜μ€‘에 μ•„λž˜ μ„Έμ…˜μ—μ„œ Poetryλ₯Ό μ‚¬μš©ν•œ μ˜ˆμ‹œλ₯Ό λ³΄μ΄κ² μŠ΅λ‹ˆλ‹€. πŸ‘‡
@@ -222,7 +222,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
     ν”„λ‘œκ·Έλž¨μ΄ `/code`μ—μ„œ μ‹œμž‘ν•˜κ³  κ·Έ μ†μ— `./app` λ””렉터리가 μ—¬λŸ¬λΆ„μ˜ μ½”λ“œμ™€ ν•¨κ»˜ λ“€μ–΄μžˆκΈ° λ•Œλ¬Έμ—, **Uvicorn**은 μ΄λ₯Ό λ³΄κ³  `app`을 `app.main`μœΌλ‘œλΆ€ν„° **뢈러 μ˜¬** κ²ƒμž…λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     κ° μ½”λ“œ λΌμΈμ„ μ½”λ“œμ˜ μˆ«μž λ²„블을 ν΄λ¦­ν•˜μ—¬ λ¦¬λ·°ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€. πŸ‘†
 
 μ΄μ œ μ—¬λŸ¬λΆ„은 λ‹€μŒκ³Ό κ°™μ€ λ””렉터리 κ΅¬μ‘°λ₯Ό κ°€μ§€κ³  μžˆμ„ κ²ƒμž…λ‹ˆλ‹€:
@@ -293,7 +293,7 @@ $ docker build -t myimage .
 
 </div>
 
-!!! νŒ
+!!! tip "팁"
     λ§¨ λμ— μžˆλŠ” `.` μ— μ£Όλͺ©ν•©μ‹œλ‹€. μ΄λŠ” `./`와 λ™λ“±ν•˜λ©°, λ„μ»€μ—κ²Œ μ»¨ν…Œμ΄λ„ˆ μ΄λ―Έμ§€λ₯Ό λΉŒλ“œν•˜κΈ° μœ„ν•œ λ””렉터리λ₯Ό μ•Œλ €μ€λ‹ˆλ‹€.
 
     μ΄ κ²½μš°μ—λŠ” ν˜„μž¬ λ””렉터리(`.`)와 κ°™μŠ΅λ‹ˆλ‹€.
@@ -394,7 +394,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 **HTTPS**와 **μΈμ¦μ„œ**의 **μžλ™** μ·¨λ“μ„ λ‹€λ£¨λŠ” κ²ƒμ€ λ‹€λ₯Έ μ»¨ν…Œμ΄λ„ˆκ°€ λ  μˆ˜ μžˆλŠ”λ°, μ˜ˆλ₯Ό λ“€μ–΄ <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>을 μ‚¬μš©ν•˜λŠ” κ²ƒμž…λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     Traefik은 λ„컀, μΏ λ²„λ„€ν‹°μŠ€, κ·Έλ¦¬κ³  λ‹€λ₯Έ λ„ꡬ와 ν†΅ν•©λ˜μ–΄ μžˆμ–΄ μ—¬λŸ¬λΆ„μ˜ μ»¨ν…Œμ΄λ„ˆλ₯Ό ν¬ν•¨ν•˜λŠ” HTTPSλ₯Ό μ…‹μ—…ν•˜κ³  μ„€μ •ν•˜λŠ” κ²ƒμ΄ λ§€μš° μ‰½μŠ΅λ‹ˆλ‹€.
 
 λŒ€μ•ˆμ μœΌλ‘œ, HTTPSλŠ” ν΄λΌμš°λ“œ μ œκ³΅μžμ— μ˜ν•΄ μ„œλΉ„μŠ€μ˜ μΌν™˜μœΌλ‘œ λ‹€λ£¨μ–΄μ§ˆ μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€ (μ΄λ•Œλ„ μ–΄ν”Œλ¦¬μΌ€μ΄μ…˜μ€ μ—¬μ „νžˆ μ»¨ν…Œμ΄λ„ˆμ—μ„œ μ‹€ν–‰λ  κ²ƒμž…λ‹ˆλ‹€).
@@ -423,7 +423,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 μ΄ μš”μ†Œκ°€ μš”μ²­λ“€μ˜ **λ‘œλ“œ**λ₯Ό μ½μ–΄λ“€μ΄κ³  κ° μ›Œμ»€μ—κ²Œ (λ°”λΌκ±΄λŒ€) **κ· ν˜•μ μœΌλ‘œ** λΆ„λ°°ν•œλ‹€λ©΄, μ΄ μš”μ†ŒλŠ” μΌλ°˜μ μœΌλ‘œ **λ‘œλ“œ λ°ΈλŸ°μ„œ**라고 λΆˆλ¦½λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     HTTPSλ₯Ό μœ„ν•΄ μ‚¬μš©λœ **TLS μ’…λ£Œ ν”„λ‘μ‹œ** μš”μ†Œ λ˜ν•œ **λ‘œλ“œ λ°ΈλŸ°μ„œ**κ°€ λ  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
 
 λ˜ν•œ μ»¨ν…Œμ΄λ„ˆλ‘œ μž‘μ—…ν•  λ•Œ, μ»¨ν…Œμ΄λ„ˆλ₯Ό μ‹œμž‘ν•˜κ³  κ΄€λ¦¬ν•˜κΈ° μœ„ν•΄ μ‚¬μš©ν•œ κ²ƒκ³Ό λ™μΌν•œ μ‹œμŠ€ν…œμ€ μ΄λ―Έ ν•΄λ‹Ή **λ‘œλ“œ λ°ΈλŸ°μ„œ**둜 λΆ€ν„° μ—¬λŸ¬λΆ„μ˜ μ•±μ— ν•΄λ‹Ήν•˜λŠ” μ»¨ν…Œμ΄λ„ˆλ‘œ **λ„€νŠΈμ›Œν¬ ν†΅μ‹ **(예λ₯Ό λ“€μ–΄, HTTP μš”μ²­)을 μ „μ†‘ν•˜λŠ” λ‚΄λΆ€μ μΈ λ„ꡬλ₯Ό κ°€μ§€κ³  μžˆμ„ κ²ƒμž…λ‹ˆλ‹€ (μ—¬κΈ°μ„œλ„ λ‘œλ“œ λ°ΈλŸ°μ„œλŠ” **TLS μ’…λ£Œ ν”„λ‘μ‹œ**일 μˆ˜ μžˆμŠ΅λ‹ˆλ‹€).
@@ -503,7 +503,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 λ§Œμ•½ μ—¬λŸ¬λΆ„이 **μ—¬λŸ¬κ°œμ˜ μ»¨ν…Œμ΄λ„ˆ**λ₯Ό κ°€μ§€κ³  μžˆλ‹€λ©΄, μ•„λ§ˆλ„ κ°κ°μ˜ μ»¨ν…Œμ΄λ„ˆλŠ” **ν•˜λ‚˜μ˜ ν”„λ‘œμ„ΈμŠ€**λ₯Ό κ°€μ§€κ³  μžˆμ„ κ²ƒμž…λ‹ˆλ‹€(예λ₯Ό λ“€μ–΄, **μΏ λ²„λ„€ν‹°μŠ€** ν΄λŸ¬μŠ€ν„°μ—μ„œ). κ·ΈλŸ¬λ©΄ μ—¬λŸ¬λΆ„은 λ³΅μ œλœ μ›Œμ»€ μ»¨ν…Œμ΄λ„ˆλ₯Ό μ‹€ν–‰ν•˜κΈ° **이전에**, ν•˜λ‚˜μ˜ μ»¨ν…Œμ΄λ„ˆμ— μžˆλŠ” **μ΄μ „μ˜ λ‹¨κ³„듀을** μˆ˜ν–‰ν•˜λŠ” λ‹¨μΌ ν”„λ‘œμ„ΈμŠ€λ₯Ό κ°€μ§€λŠ” **λ³„λ„μ˜ μ»¨ν…Œμ΄λ„ˆλ“€**을 κ°€μ§€κ³  μ‹Άμ„ κ²ƒμž…λ‹ˆλ‹€.
 
-!!! μ •보
+!!! info "정보"
     λ§Œμ•½ μ—¬λŸ¬λΆ„이 μΏ λ²„λ„€ν‹°μŠ€λ₯Ό μ‚¬μš©ν•˜κ³  μžˆλ‹€λ©΄, μ•„λ§ˆλ„ μ΄λŠ” <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Init Container</a>일 κ²ƒμž…λ‹ˆλ‹€.
 
 λ§Œμ•½ μ—¬λŸ¬λΆ„μ˜ μ΄μš© μ‚¬λ‘€μ—μ„œ μ΄μ „ λ‹¨κ³„듀을 **λ³‘λ ¬μ μœΌλ‘œ μ—¬λŸ¬λ²ˆ** μˆ˜ν–‰ν•˜λŠ”λ°μ— λ¬Έμ œκ°€ μ—†λ‹€λ©΄ (예λ₯Ό λ“€μ–΄ λ°μ΄ν„°λ² μ΄μŠ€ μ΄μ „을 μ‹€ν–‰ν•˜μ§€ μ•Šκ³  λ°μ΄ν„°λ² μ΄μŠ€κ°€ μ€€λΉ„λ˜μ—ˆλŠ”μ§€ ν™•μΈλ§Œ ν•˜λŠ” κ²½μš°), λ©”인 ν”„λ‘œμ„ΈμŠ€λ₯Ό μ‹œμž‘ν•˜κΈ° μ „에 μ΄ λ‹¨κ³„듀을 κ° μ»¨ν…Œμ΄λ„ˆμ— λ„£μ„ μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
@@ -520,7 +520,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 * <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
 
-!!! κ²½κ³ 
+!!! warning "κ²½κ³ "
     μ—¬λŸ¬λΆ„이 μ΄ λ² μ΄μŠ€ μ΄λ―Έμ§€ λ˜λŠ” λ‹€λ₯Έ μœ μ‚¬ν•œ μ΄λ―Έμ§€λ₯Ό ν•„μš”λ‘œ ν•˜μ§€ **μ•Šμ„** λ†’은 κ°€λŠ₯성이 μžˆμœΌλ©°, [μœ„μ—μ„œ μ„€λͺ…λœ κ²ƒμ²˜λŸΌ: FastAPIλ₯Ό μœ„ν•œ λ„컀 μ΄λ―Έμ§€ λΉŒλ“œν•˜κΈ°](#build-a-docker-image-for-fastapi) μ²˜μŒλΆ€ν„° μ΄λ―Έμ§€λ₯Ό λΉŒλ“œν•˜λŠ” κ²ƒμ΄ λ” λ‚˜μ„ μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
 
 μ΄ μ΄λ―Έμ§€λŠ” κ°€λŠ₯ν•œ CPU μ½”어에 κΈ°λ°˜ν•œ **λͺ‡κ°œμ˜ μ›Œμ»€ ν”„λ‘œμ„ΈμŠ€**λ₯Ό μ„€μ •ν•˜λŠ” **μžλ™-νŠœλ‹** λ©”μ»€λ‹ˆμ¦˜μ„ ν¬ν•¨ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€.
@@ -529,7 +529,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 λ˜ν•œ μŠ€ν¬λ¦½νŠΈλ₯Ό ν†΅ν•΄ <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**μ‹œμž‘ν•˜κΈ° μ „ μ‚¬μ „ λ‹¨κ³„**</a>λ₯Ό μ‹€ν–‰ν•˜λŠ” κ²ƒμ„ μ§€μ›ν•©λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     λͺ¨λ“  μ„€μ •κ³Ό μ˜΅μ…˜μ„ λ³΄λ €λ©΄, λ„컀 μ΄λ―Έμ§€ νŽ˜μ΄μ§€λ‘œ μ΄λ™ν•©λ‹ˆλ‹€: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
 
 ### κ³΅μ‹ λ„컀 μ΄λ―Έμ§€μ— μžˆλŠ” ν”„λ‘œμ„ΈμŠ€ κ°œμˆ˜
@@ -657,7 +657,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 11. `uvicorn` μ»€λ§¨λ“œλ₯Ό μ‹€ν–‰ν•˜μ—¬, `app.main`μ—μ„œ λΆˆλŸ¬μ˜¨ `app` κ°μ²΄λ₯Ό μ‚¬μš©ν•˜λ„둝 ν•©λ‹ˆλ‹€.
 
-!!! νŒ
+!!! tip "팁"
     λ²„λΈ” μˆ«μžλ₯Ό ν΄λ¦­ν•΄ κ° μ€„이 ν•˜λŠ” μΌμ„ μ•Œμ•„λ³Ό μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
 
 **도컀 μŠ€ν…Œμ΄μ§€**λž€ `Dockefile`의 μΌλΆ€λ‘œμ„œ λ‚˜μ€‘에 μ‚¬μš©ν•˜κΈ° μœ„ν•œ νŒŒμΌλ“€μ„ μƒμ„±ν•˜κΈ° μœ„ν•œ **μΌμ‹œμ μΈ μ»¨ν…Œμ΄λ„ˆ μ΄λ―Έμ§€**둜 μž‘λ™ν•©λ‹ˆλ‹€.