Browse Source

๐ŸŒ Update Korean translation for `/docs/ko/docs/deployment/docker.md` (#11113)

pull/11126/head
Kani Kim 1 year ago
committed by GitHub
parent
commit
378623294e
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 20
      docs/ko/docs/deployment/docker.md

20
docs/ko/docs/deployment/docker.md

@ -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`์˜ ์ผ๋ถ€๋กœ์„œ ๋‚˜์ค‘์— ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ ํŒŒ์ผ๋“ค์„ ์ƒ์„ฑํ•˜๊ธฐ ์œ„ํ•œ **์ผ์‹œ์ ์ธ ์ปจํ…Œ์ด๋„ˆ ์ด๋ฏธ์ง€**๋กœ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

Loadingโ€ฆ
Cancel
Save