{"id":946,"date":"2026-05-26T23:13:52","date_gmt":"2026-05-26T15:13:52","guid":{"rendered":"https:\/\/junai.ai\/blog\/fastapi-deploy-docker-11\/"},"modified":"2026-05-26T23:13:52","modified_gmt":"2026-05-26T15:13:52","slug":"fastapi-deploy-docker-11","status":"publish","type":"post","link":"https:\/\/junai.ai\/blog\/fastapi-deploy-docker-11\/","title":{"rendered":"FastAPI \ubc30\ud3ec \u2014 Docker\uc640 Gunicorn"},"content":{"rendered":"\n<!-- WordPress REST API \ubc1c\ud589\uc6a9 HTML (\uc790\ub3d9 \uc0dd\uc131) -->\n<!-- WP-FEATURED-MEDIA-ID: 933 -->\n<div style=\"max-width:800px;margin:0 auto;\">\n<style>\n:root {--color-primary:#00897b;--color-accent:#009688;--color-bg:#fafbfc;--color-bg-card:#fff;--color-text:#1a202c;--color-text-muted:#64748b;--hero-start:#004d40;--hero-end:#00897b;}\n*{box-sizing:border-box;}\n.container{max-width:760px;margin:0 auto;padding:0 24px 80px;}\n.hero{background:linear-gradient(135deg,var(--hero-start) 0%,var(--hero-end) 100%);color:#fff;padding:80px 24px 60px;text-align:center;}\n.hero .eyebrow{display:inline-block;font-size:14px;color:#80cbc4;font-weight:700;letter-spacing:0.1em;text-transform:uppercase;margin-bottom:14px;}\n.hero h1{font-size:36px;margin:0 0 16px;line-height:1.3;font-weight:800;}\n.hero p{color:#b2dfdb;font-size:18px;max-width:640px;margin:0 auto;line-height:1.6;}\n.hero img{width:100%;max-width:640px;height:auto;margin:32px auto 0;border-radius:10px;display:block;}\narticle{padding-top:48px;}\narticle h2{font-size:26px;margin:56px 0 20px;padding-left:14px;border-left:5px solid var(--color-accent);line-height:1.4;}\narticle h3{font-size:19px;margin:32px 0 12px;color:var(--color-primary);}\narticle p{margin:16px 0;}\narticle strong{color:var(--color-primary);font-weight:700;}\narticle code{background:#b2dfdb;padding:2px 8px;border-radius:4px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;color:#004d40;}\n.databox{background:#b2dfdb;border-left:4px solid var(--color-accent);padding:16px 20px;margin:24px 0;border-radius:0 8px 8px 0;font-size:15.5px;}\n.databox strong{color:var(--color-primary);}\n.warnbox{background:linear-gradient(135deg,#fef3c7 0%,#fde68a 100%);padding:16px 20px;margin:24px 0;border-radius:8px;font-size:15.5px;}\n.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch;margin:22px 0;}\ntable{width:100%;border-collapse:collapse;font-size:15px;background:var(--color-bg-card);}\nth,td{padding:11px 12px;text-align:left;border-bottom:1px solid #e2e8f0;vertical-align:top;}\nth{background:#f1f5f9;font-weight:700;color:#0f172a;}\ntd:first-child,th:first-child{font-weight:700;}\n@media (max-width:560px){.tablewrap table,.tablewrap thead,.tablewrap tbody,.tablewrap tr,.tablewrap th,.tablewrap td{display:block;width:auto;}.tablewrap thead{display:none;}.tablewrap tr{margin:0 0 14px;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden;}.tablewrap td{border:none;border-bottom:1px solid #f1f5f9;padding:9px 14px;}.tablewrap td:first-child{background:#f1f5f9;font-weight:800;font-size:15.5px;}.tablewrap td:last-child{border-bottom:none;}.tablewrap td[data-label]::before{content:attr(data-label) \" \u2014 \";font-weight:700;color:var(--color-primary);}}\n.code-block{background:#0f172a;color:#e2e8f0;padding:16px 20px;border-radius:8px;font-family:'SF Mono',Menlo,Consolas,monospace;font-size:14px;line-height:1.6;margin:20px 0;overflow-x:auto;white-space:pre;}\n.cta{background:linear-gradient(135deg,#00897b 0%,#009688 100%);color:#fff;padding:28px 24px;border-radius:12px;margin:48px 0 0;text-align:center;}\n.cta h3{color:#fff;margin:0 0 8px;font-size:20px;}\n.cta p{color:#b2dfdb;margin:0;font-size:15.5px;}\n.footer-nav{margin-top:32px;padding-top:20px;border-top:1px solid #e2e8f0;font-size:14px;color:var(--color-text-muted);}\n.footer-nav a{color:var(--color-primary);text-decoration:none;}\n@media (max-width:480px){.hero h1{font-size:26px;}.hero p{font-size:16px;}article h2{font-size:21px;}article h3{font-size:17px;}body{font-size:16px;}}\n<\/style>\n<section class=\"hero\">\n  <span class=\"eyebrow\">FastAPI \uad50\uc7ac \u00b7 11\ud3b8 \u00b7 \ubc30\ud3ec<\/span>\n  <h1>FastAPI \ubc30\ud3ec \u2014 Docker\uc640 Gunicorn<\/h1>\n  <p>\ub0b4 \ub178\ud2b8\ubd81\uc5d0\uc11c \uc798 \ub3cc\ub358 \uc571\uc744 \uc9c4\uc9dc \uc11c\ube44\uc2a4\ub85c \ub0b4\ubcf4\ub0bc \ucc28\ub840. \ucee8\ud14c\uc774\ub108\ub85c \ubb36\uace0, \uc5ec\ub7ec \uc6cc\ucee4\ub85c \ub744\uc6b0\uace0, \uc2dc\ud06c\ub9bf\uc740 \ud658\uacbd\ubcc0\uc218\ub85c \uc228\uae34\ub2e4.<\/p>\n  <img decoding=\"async\" src=\"https:\/\/junai.ai\/blog\/wp-content\/uploads\/2026\/05\/hero-5-108.jpg\" alt=\"\ud30c\uc774\uc36c API \uc11c\ubc84\uac00 \ub3c4\ucee4 \ucee8\ud14c\uc774\ub108\uc5d0 \ub2f4\uaca8 \ud074\ub77c\uc6b0\ub4dc\ub85c \ubc30\ud3ec\ub418\ub294 \uacfc\uc815\uc744 \ud45c\ud604\ud55c \uc544\uc774\uc18c\uba54\ud2b8\ub9ad \uc77c\ub7ec\uc2a4\ud2b8\">\n<\/section>\n\n<div class=\"container\">\n<article>\n\n<p>\uc9c0\uae08\uae4c\uc9c0 \uc6b0\ub9ac\ub294 <code>fastapi dev main.py<\/code> \ud55c \uc904\ub85c \uc11c\ubc84\ub97c \ub744\uc6b0\uace0, \ube0c\ub77c\uc6b0\uc800\uc5d0\uc11c <code>\/docs<\/code> \ub97c \uc5f4\uc5b4 \uc798 \ub3c8\ub2e4\ub294 \uac78 \ud655\uc778\ud574 \uc654\ub2e4. \uadf8\ub7f0\ub370 \uadf8 \uc11c\ubc84\ub294 <strong>\ub0b4 \ucef4\ud4e8\ud130\uc5d0\uc11c\ub9cc<\/strong> \uc0b4\uc544 \uc788\ub2e4. \ub178\ud2b8\ubd81\uc744 \ub2eb\uc73c\uba74 \uaebc\uc9c0\uace0, \uce5c\uad6c\ub294 \uc811\uc18d\ud560 \uc218 \uc5c6\ub2e4. \uc774\uc81c \uc774 \uc571\uc744 \uc778\ud130\ub137 \uc5b4\ub514\uc5d0\uc11c\ub3c4 24\uc2dc\uac04 \ub3c4\ub294 <strong>\uc9c4\uc9dc \uc11c\ube44\uc2a4<\/strong>\ub85c \ub0b4\ubcf4\ub0bc \ucc28\ub840\ub2e4.<\/p>\n\n<p>11\ud3b8\uc740 \ubc30\ud3ec(deployment)\ub97c \ub2e4\ub8ec\ub2e4. \ud575\uc2ec \uc9c8\ubb38\uc740 \uc14b\uc774\ub2e4 \u2014 \uac1c\ubc1c \uc11c\ubc84\ub97c \uadf8\ub300\ub85c \ub744\uc6b0\uba74 \uc65c \uc548 \ub418\ub098, \uc571\uc744 \uc5b4\ub5bb\uac8c \ud55c \ub369\uc5b4\ub9ac\ub85c \ud3ec\uc7a5(Docker)\ud558\ub098, \uadf8\ub9ac\uace0 \uc694\uccad\uc774 \ubab0\ub824\ub3c4 \ubc84\ud2f0\uac8c \uc5b4\ub5bb\uac8c \uc5ec\ub7ec \uc77c\uafbc(\uc6cc\ucee4)\uc744 \ub458 \uac83\uc778\uac00. \ud074\ub77c\uc6b0\ub4dc \uc885\ub958\ub294 AWS\u00b7GCP\u00b7Fly.io \ub4f1 \ucc9c\ucc28\ub9cc\ubcc4\uc774\uc9c0\ub9cc, \uadf8 \uc544\ub798 \uae54\ub9b0 \uc6d0\ub9ac\ub294 \ubaa8\ub450 \uac19\ub2e4. \uadf8 \uacf5\ud1b5 \uc6d0\ub9ac\ub97c \uc7a1\ub294\ub2e4.<\/p>\n\n<h2>1. \uac1c\ubc1c \uc11c\ubc84 vs \ud504\ub85c\ub355\uc158 \uc11c\ubc84<\/h2>\n\n<p>\uac00\uc7a5 \uba3c\uc800 \uae68\uc57c \ud560 \uc2b5\uad00 \u2014 <strong><code>fastapi dev<\/code> \uc640 <code>--reload<\/code> \ub294 \uac1c\ubc1c \uc804\uc6a9\uc774\ub2e4. \ud504\ub85c\ub355\uc158\uc5d0\uc11c\ub294 \uc808\ub300 \uc4f0\uc9c0 \uc54a\ub294\ub2e4.<\/strong> \ud3b8\ud574\uc11c \ubb34\uc2ec\ucf54 \uadf8\ub300\ub85c \ubc30\ud3ec\ud558\uae30 \uc26c\uc6b4\ub370, \uc774\uac74 \uba85\ubc31\ud55c \uc0ac\uace0\ub2e4.<\/p>\n\n<p>\uc65c \uadf8\ub7f0\uac00. <code>--reload<\/code> \uc635\uc158\uc740 \ud30c\uc77c\uc774 \ubc14\ub014 \ub54c\ub9c8\ub2e4 \ucf54\ub4dc\ub97c \ub2e4\uc2dc \uc77d\uc5b4 \ub4e4\uc774\ub824\uace0 \ub514\uc2a4\ud06c\ub97c \uacc4\uc18d \uac10\uc2dc\ud55c\ub2e4. \uac1c\ubc1c\ud560 \ub550 \ucf54\ub4dc\ub97c \uace0\uce58\uba74 \ubc14\ub85c \ubc18\uc601\ub3fc\uc11c \ucc9c\uad6d\uc774\uc9c0\ub9cc, \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 \uadf8\uc800 <strong>\uc4f8\ub370\uc5c6\uc774 CPU \ub97c \uba39\uace0 \uba54\ubaa8\ub9ac\uac00 \uc0c8\ub294 \uc704\ud5d8<\/strong>\uc77c \ubfd0\uc774\ub2e4. \uac8c\ub2e4\uac00 \uac1c\ubc1c \uc11c\ubc84\ub294 \uae30\ubcf8\uc801\uc73c\ub85c <strong>\ud504\ub85c\uc138\uc2a4 \ud558\ub098<\/strong>\ub85c \ub3c8\ub2e4. \ud55c \uba85\uc758 \uc77c\uafbc\uc774 \ubaa8\ub4e0 \uc694\uccad\uc744 \uc904 \uc138\uc6cc \ucc98\ub9ac\ud558\ub2c8, \uc694\uccad\uc774 \uc870\uae08\ub9cc \ubab0\ub824\ub3c4 \uc904\uc774 \uae38\uc5b4\uc9c4\ub2e4.<\/p>\n\n<div class=\"tablewrap\">\n<table>\n<thead><tr><th>\uad6c\ubd84<\/th><th>\uac1c\ubc1c \uc11c\ubc84<\/th><th>\ud504\ub85c\ub355\uc158 \uc11c\ubc84<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>\uc2e4\ud589 \uba85\ub839<\/td><td data-label=\"\uac1c\ubc1c\">fastapi dev \/ &#8211;reload<\/td><td data-label=\"\ud504\ub85c\ub355\uc158\">uvicorn &#8211;workers \u00b7 gunicorn<\/td><\/tr>\n<tr><td>\uc6cc\ucee4 \uc218<\/td><td data-label=\"\uac1c\ubc1c\">1\uac1c (\ub2e8\uc77c \ud504\ub85c\uc138\uc2a4)<\/td><td data-label=\"\ud504\ub85c\ub355\uc158\">CPU \ucf54\uc5b4 \uae30\uc900 \uc5ec\ub7ec \uac1c<\/td><\/tr>\n<tr><td>\uc790\ub3d9 \ub9ac\ub85c\ub4dc<\/td><td data-label=\"\uac1c\ubc1c\">\ucf2c (\ud3b8\uc758)<\/td><td data-label=\"\ud504\ub85c\ub355\uc158\">\ub054 (\uc704\ud5d8\u00b7\ub0ad\ube44)<\/td><\/tr>\n<tr><td>\ubaa9\ud45c<\/td><td data-label=\"\uac1c\ubc1c\">\ube60\ub978 \ud53c\ub4dc\ubc31<\/td><td data-label=\"\ud504\ub85c\ub355\uc158\">\uc548\uc815\uc131\u00b7\ucc98\ub9ac\ub7c9<\/td><\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<p>\uc815\ub9ac\ud558\uba74 \ud504\ub85c\ub355\uc158\uc740 \ub450 \uac00\uc9c0\uac00 \ud544\uc694\ud558\ub2e4. <strong>\uc5ec\ub7ec \uac1c\uc758 \uc6cc\ucee4<\/strong>(\uc694\uccad\uc744 \ub098\ub220 \ucc98\ub9ac\ud558\ub294 \uc77c\uafbc)\uc640, \uc6cc\ucee4\uac00 \uc8fd\uc73c\uba74 \ub2e4\uc2dc \uc0b4\ub824 \uc8fc\ub294 <strong>\ud504\ub85c\uc138\uc2a4 \ub9e4\ub2c8\uc800<\/strong>\ub2e4. \uc774\uac78 \uae54\ub054\ud558\uac8c \ubb36\uc5b4 \uc8fc\ub294 \uadf8\ub987\uc774 \ubc14\ub85c Docker \ub2e4.<\/p>\n\n<h2>2. Dockerfile \uc791\uc131\ud558\uae30<\/h2>\n\n<p>Docker \ub294 \uc571\uacfc \uadf8 \uc571\uc774 \ud544\uc694\ub85c \ud558\ub294 \ubaa8\ub4e0 \uac83(\ud30c\uc774\uc36c \ubc84\uc804, \ub77c\uc774\ube0c\ub7ec\ub9ac, \ucf54\ub4dc)\uc744 <strong>\ucee8\ud14c\uc774\ub108<\/strong>\ub77c\ub294 \ud55c \uc0c1\uc790\uc5d0 \ub2f4\ub294 \uae30\uc220\uc774\ub2e4. &#8220;\ub0b4 \ucef4\ud4e8\ud130\uc5d0\uc120 \ub410\ub294\ub370\uc694?&#8221; \ub77c\ub294 \uc601\uc6d0\ud55c \ubcc0\uba85\uc744 \uc5c6\uc560 \uc900\ub2e4 \u2014 \uc0c1\uc790\uc9f8\ub85c \uc62e\uae30\ub2c8 \uc5b4\ub514\uc11c\ub4e0 \ub611\uac19\uc774 \ub3c8\ub2e4. \uadf8 \uc0c1\uc790\ub97c \uc5b4\ub5bb\uac8c \ub9cc\ub4e4\uc9c0 \uc801\uc5b4 \ub454 \uc124\uacc4\ub3c4\uac00 <code>Dockerfile<\/code> \uc774\ub2e4.<\/p>\n\n<div class=\"code-block\"># Dockerfile\nFROM python:3.12-slim\n\nWORKDIR \/code\n\n# 1) \uc758\uc874\uc131 \uba3c\uc800 \ubcf5\uc0ac \u2192 \uce90\uc2dc \ud65c\uc6a9\nCOPY requirements.txt .\nRUN pip install &#8211;no-cache-dir -r requirements.txt\n\n# 2) \uadf8\ub2e4\uc74c \uc571 \ucf54\ub4dc \ubcf5\uc0ac\nCOPY . .\n\n# 3) \ud504\ub85c\ub355\uc158 \uc2e4\ud589 (&#8211;reload \uc5c6\uc74c)\nCMD [&#8220;uvicorn&#8221;, &#8220;app.main:app&#8221;, &#8220;&#8211;host&#8221;, &#8220;0.0.0.0&#8221;, &#8220;&#8211;port&#8221;, &#8220;80&#8221;]<\/div>\n\n<p>\ud55c \uc904\uc529 \uc758\ubbf8\ub97c \ubcf4\uc790. <code>FROM python:3.12-slim<\/code> \uc740 &#8220;\ud30c\uc774\uc36c 3.12 \uac00 \uae54\ub9b0 \uac00\ubcbc\uc6b4 \ub9ac\ub205\uc2a4\uc5d0\uc11c \uc2dc\uc791&#8221; \uc774\ub77c\ub294 \ub73b\uc774\ub2e4. <code>slim<\/code> \uc740 \uad70\ub354\ub354\uae30\ub97c \ube80 \uc791\uc740 \uc774\ubbf8\uc9c0\ub77c \ube4c\ub4dc\uac00 \ube60\ub974\uace0 \ubcf4\uc548 \ud45c\uba74\ub3c4 \uc904\uc5b4\ub4e0\ub2e4. <code>WORKDIR \/code<\/code> \ub294 \ucee8\ud14c\uc774\ub108 \uc548\uc758 \uc791\uc5c5 \ud3f4\ub354\ub97c \uc815\ud55c\ub2e4.<\/p>\n\n<p>\uc5ec\uae30\uc11c \uac00\uc7a5 \uc911\uc694\ud55c \ud55c \uc218 \u2014 <strong><code>requirements.txt<\/code> \ub97c \ucf54\ub4dc\ubcf4\ub2e4 \uba3c\uc800 \ubcf5\uc0ac\ud558\uace0 \uc124\uce58<\/strong>\ud558\ub294 \uc21c\uc11c\ub2e4. Docker \ub294 \ubcc0\ud558\uc9c0 \uc54a\uc740 \ub2e8\uacc4\ub97c \uce90\uc2dc\ub85c \uc7ac\uc0ac\uc6a9\ud55c\ub2e4. \ub77c\uc774\ube0c\ub7ec\ub9ac \ubaa9\ub85d\uc740 \uac70\uc758 \uc548 \ubc14\ub00c\uace0 \ucf54\ub4dc\ub294 \uc790\uc8fc \ubc14\ub00c\ub2c8, \uc758\uc874\uc131 \uc124\uce58\ub97c \uc704\ub85c \ube7c \ub450\uba74 \ucf54\ub4dc\ub9cc \uace0\ucce4\uc744 \ub54c \ubb34\uac70\uc6b4 <code>pip install<\/code> \uc744 \uac74\ub108\ub6f4\ub2e4. \ube4c\ub4dc\uac00 \uba87 \ubc30 \ube68\ub77c\uc9c4\ub2e4.<\/p>\n\n<p>\ub9c8\uc9c0\ub9c9 <code>CMD<\/code> \uac00 \ucee8\ud14c\uc774\ub108\uac00 \ucf1c\uc9c8 \ub54c \uc2e4\ud589\ud560 \uba85\ub839\uc774\ub2e4. <code>--host 0.0.0.0<\/code> \uc740 &#8220;\ucee8\ud14c\uc774\ub108 \ubc14\uae65\uc5d0\uc11c \ub4e4\uc5b4\uc624\ub294 \uc811\uc18d\ub3c4 \ubc1b\uaca0\ub2e4&#8221; \ub294 \ub73b\uc73c\ub85c, \uc774\uac8c \uc5c6\uc73c\uba74 \uc678\ubd80\uc5d0\uc11c \uc811\uc18d\uc774 \uc548 \ub41c\ub2e4. \uc774\uc81c \uc774\ubbf8\uc9c0\ub97c \ube4c\ub4dc\ud558\uace0 \uc2e4\ud589\ud55c\ub2e4.<\/p>\n\n<div class=\"code-block\"># \uc774\ubbf8\uc9c0 \ube4c\ub4dc (\ud604\uc7ac \ud3f4\ub354\uc758 Dockerfile \ub85c, myapi \ub77c\ub294 \uc774\ub984\ud45c)\n$ docker build -t myapi .\n\n# \ucee8\ud14c\uc774\ub108 \uc2e4\ud589 (\ub0b4 PC\uc758 80\ud3ec\ud2b8 \u2194 \ucee8\ud14c\uc774\ub108\uc758 80\ud3ec\ud2b8 \uc5f0\uacb0)\n$ docker run -p 80:80 myapi<\/div>\n\n<p><code>-p 80:80<\/code> \uc758 \uc55e\ucabd\uc740 \ub0b4 \uc11c\ubc84(\ud638\uc2a4\ud2b8)\uc758 \ud3ec\ud2b8, \ub4a4\ucabd\uc740 \ucee8\ud14c\uc774\ub108 \uc548\uc758 \ud3ec\ud2b8\ub2e4. \uc774 \ub2e4\ub9ac\ub97c \ub193\uc544\uc57c \ube0c\ub77c\uc6b0\uc800\uac00 \ucee8\ud14c\uc774\ub108 \uc548\uc758 FastAPI \uae4c\uc9c0 \ub2ff\ub294\ub2e4. \uc774\uc81c \uc774 \uc774\ubbf8\uc9c0\ub294 \uc5b4\ub5a4 \ud074\ub77c\uc6b0\ub4dc\uc5d0 \ub358\uc838\ub3c4 \ub611\uac19\uc774 \ub3c8\ub2e4.<\/p>\n\n<h2>3. \uc5ec\ub7ec \uc6cc\ucee4\uc640 Gunicorn<\/h2>\n\n<p>\ucee8\ud14c\uc774\ub108 \uc548\uc5d0\uc11c <code>uvicorn<\/code> \uc744 \uadf8\ub0e5 \ub744\uc6b0\uba74 \uc5ec\uc804\ud788 \uc6cc\ucee4\uac00 \ud558\ub098\ub2e4. \ucf54\uc5b4\uac00 \uc5ec\ub7ec \uac1c\uc778 \uc11c\ubc84\ub77c\uba74 \uc77c\uafbc\uc744 \ub298\ub824 \ub3d9\uc2dc\uc5d0 \ub354 \ub9ce\uc740 \uc694\uccad\uc744 \ubc1b\ub294 \uac8c \uc774\ub4dd\uc774\ub2e4. \uac00\uc7a5 \uac04\ub2e8\ud55c \ubc29\ubc95\uc740 uvicorn \uc5d0 <code>--workers<\/code> \ub97c \uc8fc\ub294 \uac83.<\/p>\n\n<div class=\"code-block\"># \ubc29\ubc95 A \u2014 uvicorn \uc790\uccb4 \uba40\ud2f0 \uc6cc\ucee4\n$ uvicorn app.main:app &#8211;host 0.0.0.0 &#8211;port 80 &#8211;workers 4\n\n# \ubc29\ubc95 B \u2014 Gunicorn \uc744 \ub9e4\ub2c8\uc800\ub85c, uvicorn \uc744 \uc6cc\ucee4\ub85c\n$ gunicorn app.main:app \\\n    -k uvicorn.workers.UvicornWorker \\\n    -w 4 \\\n    -b 0.0.0.0:80<\/div>\n\n<p>\ub450 \ubc29\ubc95\uc758 \ucc28\uc774\ub294 <strong>\ub204\uac00 \uc6cc\ucee4\ub97c \uad00\ub9ac\ud558\ub290\ub0d0<\/strong>\ub2e4. <strong>Gunicorn<\/strong> \uc740 \uc624\ub79c \uc2dc\uac04 \uac80\uc99d\ub41c \ud504\ub85c\uc138\uc2a4 \ub9e4\ub2c8\uc800\ub85c, \uc6cc\ucee4 \ud558\ub098\uac00 \uc8fd\uc73c\uba74 \uc989\uc2dc \uc0c8\ub85c \ub744\uc6cc \uc8fc\uace0, \ubb34\uc911\ub2e8\uc73c\ub85c \uc6cc\ucee4\ub97c \uc7ac\uc2dc\uc791\ud558\ub294 \ub4f1 \uc6b4\uc601 \uae30\ub2a5\uc774 \ud0c4\ud0c4\ud558\ub2e4. <code>-k uvicorn.workers.UvicornWorker<\/code> \uac00 &#8220;\uac01 \uc6cc\ucee4\ub294 uvicorn \uc73c\ub85c \ub3cc\ub824\ub77c&#8221; \ub294 \uc9c0\uc815\uc774\uace0, <code>-w 4<\/code> \uac00 \uc6cc\ucee4 \uc218\ub2e4. FastAPI \ub294 ASGI \uc571\uc774\ub77c \ubc18\ub4dc\uc2dc \uc774 uvicorn \uc6cc\ucee4 \ud074\ub798\uc2a4\ub97c \ub07c\uc6cc\uc57c \ud55c\ub2e4\ub294 \uc810\uc744 \uc78a\uc9c0 \ub9d0\uc790.<\/p>\n\n<div class=\"databox\">\n<strong>\uc6cc\ucee4\ub294 \uba87 \uac1c\uac00 \uc801\ub2f9\ud55c\uac00<\/strong> \u2014 \ud754\ud788 \uc4f0\ub294 \ucd9c\ubc1c\uc810\uc740 <strong>(CPU \ucf54\uc5b4 \uc218 \u00d7 2) + 1<\/strong> \uc774\ub2e4. 2\ucf54\uc5b4\uba74 5\uac1c \uc815\ub3c4. \ub2e4\ub9cc \ubb34\uc791\uc815 \ub298\ub9ac\uba74 \uc6cc\ucee4\ub9c8\ub2e4 \uba54\ubaa8\ub9ac\ub97c \ub530\ub85c \uba39\uc5b4 \uc624\ud788\ub824 \ud130\uc9c8 \uc218 \uc788\uc73c\ub2c8, \uc2e4\uc81c \ubd80\ud558\ub97c \uce21\uc815\ud558\uba70 \uc870\uc808\ud558\ub294 \uac8c \uc815\uc11d\uc774\ub2e4. \ucf54\uc5b4 \uc218\ubcf4\ub2e4 \uc801\uac8c \ub450\uba74 CPU \ub97c \ub180\ub9ac\uace0, \ub108\ubb34 \ub9ce\uc774 \ub450\uba74 \uba54\ubaa8\ub9ac\uac00 \ubd80\uc871\ud574\uc9c4\ub2e4.\n<\/div>\n\n<p>\uc694\uc998\uc740 \ucee8\ud14c\uc774\ub108 \ud558\ub098\uc5d0 \uc6cc\ucee4\ub97c \ubab0\uc544\ub123\uae30\ubcf4\ub2e4, <strong>\ucee8\ud14c\uc774\ub108\ub2f9 \uc6cc\ucee4 1~2\uac1c\ub85c \uac00\ubccd\uac8c \ub450\uace0 \ucee8\ud14c\uc774\ub108 \uc790\uccb4\ub97c \uc5ec\ub7ec \uac1c \ub744\uc6b0\ub294<\/strong> \ubc29\uc2dd(\ucfe0\ubc84\ub124\ud2f0\uc2a4\u00b7\uc624\ud1a0\uc2a4\ucf00\uc77c\ub9c1)\ub3c4 \ub9ce\ub2e4. \uc5b4\ub290 \ucabd\uc774\ub4e0 &#8220;\ub2e8\uc77c \ud504\ub85c\uc138\uc2a4\ub85c\ub294 \uc808\ub300 \uc6b4\uc601\ud558\uc9c0 \uc54a\ub294\ub2e4&#8221; \ub294 \uc6d0\uce59\uc740 \uac19\ub2e4.<\/p>\n\n<h2>4. \ud658\uacbd\ubcc0\uc218\u00b7\ubcf4\uc548\u00b7\ud5ec\uc2a4\uccb4\ud06c<\/h2>\n\n<p>\ub9c8\uc9c0\ub9c9\uc740 \uc6b4\uc601\uc758 \ub514\ud14c\uc77c\uc774\ub2e4. \ucf54\ub4dc\ub294 \uadf8\ub300\ub85c\uc9c0\ub9cc \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub9cc \ucc59\uaca8\uc57c \ud558\ub294 \uac83\ub4e4\uc774 \uc788\ub2e4.<\/p>\n\n<h3>\uc2dc\ud06c\ub9bf\uc740 \ud658\uacbd\ubcc0\uc218\ub85c<\/h3>\n\n<p>DB \uc811\uc18d \uc8fc\uc18c, <code>SECRET_KEY<\/code>, \uc678\ubd80 API \ud0a4 \uac19\uc740 \ubbfc\uac10\ud55c \uac12\uc744 <strong>\ucf54\ub4dc\uc5d0 \uc9c1\uc811 \uc801\uc5b4 \ub450\uba74 \uc548 \ub41c\ub2e4.<\/strong> \ub300\uc2e0 \ud658\uacbd\ubcc0\uc218\ub85c \uc8fc\uc785\ud558\uace0, \ucf54\ub4dc\uc5d0\uc11c\ub294 <code>os.environ<\/code> \uc73c\ub85c \uc77d\ub294\ub2e4. \uac19\uc740 \uc774\ubbf8\uc9c0\ub97c \uac1c\ubc1c\u00b7\uc6b4\uc601\uc5d0 \uadf8\ub300\ub85c \uc4f0\uba74\uc11c \uac12\ub9cc \ubc14\uafc0 \uc218 \uc788\uc5b4 \uc720\uc5f0\ud558\ub2e4.<\/p>\n\n<div class=\"code-block\">import os\n\nSECRET_KEY = os.environ[&#8220;SECRET_KEY&#8221;]\nDATABASE_URL = os.environ.get(&#8220;DATABASE_URL&#8221;, &#8220;sqlite:\/\/\/.\/dev.db&#8221;)\n\n# \uc2e4\ud589 \uc2dc \uac12 \uc8fc\uc785\n# $ docker run -e SECRET_KEY=xxx -e DATABASE_URL=&#8230; -p 80:80 myapi<\/div>\n\n<div class=\"warnbox\">\n<strong>\u26a0 \uc2dc\ud06c\ub9bf\uc744 \uc774\ubbf8\uc9c0\ub098 \uae43\uc5d0 \ub123\uc9c0 \ub9d0 \uac83<\/strong> \u2014 <code>Dockerfile<\/code> \uc5d0 <code>ENV SECRET_KEY=abcd<\/code> \ucc98\ub7fc \ud0a4\ub97c \ubc15\uac70\ub098, <code>.env<\/code> \ud30c\uc77c\uc744 \uae43\uc5d0 \ucee4\ubc0b\ud558\uba74 \uadf8 \ube44\ubc00\uc740 \uc774\ubbf8\uc9c0\u00b7\uc774\ub825\uc5d0 \uc601\uc6d0\ud788 \ub0a8\ub294\ub2e4. \ub098\uc911\uc5d0 \ucf54\ub4dc\uc5d0\uc11c \uc9c0\uc6cc\ub3c4 \uae43 \ud788\uc2a4\ud1a0\ub9ac\uc5d0\uc11c \ubcf5\uc6d0\ub41c\ub2e4. \uc2dc\ud06c\ub9bf\uc740 \ubc18\ub4dc\uc2dc <strong>\uc2e4\ud589 \uc2dc\uc810\uc5d0 \ud658\uacbd\ubcc0\uc218\ub85c \uc8fc\uc785<\/strong>\ud558\uace0, <code>.env<\/code> \ub294 <code>.gitignore<\/code> \uc640 <code>.dockerignore<\/code> \uc5d0 \ub123\uc5b4 \ub454\ub2e4.\n<\/div>\n\n<h3>\ud5ec\uc2a4\uccb4\ud06c \uc5d4\ub4dc\ud3ec\uc778\ud2b8<\/h3>\n\n<p>\uc6b4\uc601 \ud658\uacbd\uc740 &#8220;\uc774 \uc11c\ubc84 \uc544\uc9c1 \uc0b4\uc544 \uc788\ub098?&#8221; \ub97c \uc8fc\uae30\uc801\uc73c\ub85c \ubb3b\ub294\ub2e4. \ub85c\ub4dc\ubc38\ub7f0\uc11c\ub098 \ucfe0\ubc84\ub124\ud2f0\uc2a4\uac00 \uc751\ub2f5\uc774 \uc5c6\ub294 \ucee8\ud14c\uc774\ub108\ub97c \uc790\ub3d9\uc73c\ub85c \ube7c\uace0 \uc0c8\ub85c \ub744\uc6b0\ub824\uba74, \uac00\ubccd\uac8c 200 \uc744 \ub3cc\ub824\uc8fc\ub294 <code>\/health<\/code> \uac19\uc740 \uc5d4\ub4dc\ud3ec\uc778\ud2b8\uac00 \uc788\uc5b4\uc57c \ud55c\ub2e4.<\/p>\n\n<div class=\"code-block\">@app.get(&#8220;\/health&#8221;)\ndef health_check():\n    return {&#8220;status&#8221;: &#8220;ok&#8221;}<\/div>\n\n<h3>HTTPS \ub294 \ub9ac\ubc84\uc2a4 \ud504\ub85d\uc2dc\uc5d0 \ub9e1\uae34\ub2e4<\/h3>\n\n<p>\ub9c8\uc9c0\ub9c9\uc73c\ub85c \ubcf4\uc548 \uc811\uc18d(HTTPS) \ucc98\ub9ac\ub2e4. FastAPI \uc571\uc774 \uc9c1\uc811 \uc778\uc99d\uc11c\ub97c \ub2e4\ub8e8\uac8c \ud558\uc9c0 \ub9d0\uace0, \uc55e\ub2e8\uc5d0 <strong>Nginx \uac19\uc740 \ub9ac\ubc84\uc2a4 \ud504\ub85d\uc2dc<\/strong>\ub97c \ub450\uc5b4 HTTPS \uc885\ub8cc\u00b7\uc778\uc99d\uc11c \uac31\uc2e0\uc744 \uc704\uc784\ud558\ub294 \uac8c \ud45c\uc900\uc774\ub2e4. \ud504\ub85d\uc2dc\uac00 \ubc14\uae65\uc758 HTTPS \uc694\uccad\uc744 \ubc1b\uc544 \ub0b4\ubd80\uc758 \ud3c9\ubb38 HTTP \ub85c FastAPI \uc5d0 \uc804\ub2ec\ud55c\ub2e4. \uc571\uc740 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc5d0\ub9cc \uc9d1\uc911\ud558\uace0, \ubcf4\uc548\u00b7\uc555\ucd95\u00b7\uc815\uc801 \ud30c\uc77c \uac19\uc740 \ubb34\uac70\uc6b4 \uc77c\uc740 \ud504\ub85d\uc2dc\uac00 \ub9e1\ub294 \uc5ed\ud560 \ubd84\ub2f4\uc774\ub2e4.<\/p>\n\n<h3>\uc694\uc57d<\/h3>\n\n<p>11\ud3b8\uc758 \ud575\uc2ec\uc744 \ud55c \ubc88\uc5d0. <strong>\uac1c\ubc1c \uc11c\ubc84(<code>fastapi dev<\/code>\u00b7<code>--reload<\/code>)\ub294 \uc808\ub300 \uc6b4\uc601\uc5d0 \uc4f0\uc9c0 \uc54a\ub294\ub2e4.<\/strong> \uc571\uc740 <code>Dockerfile<\/code> \ub85c \ucee8\ud14c\uc774\ub108\uc5d0 \ud3ec\uc7a5\ud558\ub418 <code>requirements.txt<\/code> \ub97c \uba3c\uc800 \ubcf5\uc0ac\ud574 \uce90\uc2dc\ub97c \uc0b4\ub9ac\uace0, \uc2e4\ud589\uc740 <strong>Gunicorn + uvicorn \uc6cc\ucee4 \uc5ec\ub7ec \uac1c<\/strong>\ub85c \ud55c\ub2e4(\uc6cc\ucee4 \uc218\ub294 \ucf54\uc5b4 \uae30\uc900\uc73c\ub85c \uc2dc\uc791\ud574 \uce21\uc815\uc73c\ub85c \uc870\uc808). \uc2dc\ud06c\ub9bf\uc740 \ucf54\ub4dc\u00b7\uc774\ubbf8\uc9c0\u00b7\uae43\uc774 \uc544\ub2c8\ub77c <strong>\ud658\uacbd\ubcc0\uc218<\/strong>\ub85c \uc8fc\uc785\ud558\uace0, <code>\/health<\/code> \ub85c \uc0dd\uc874\uc744 \uc54c\ub9ac\uba70, HTTPS \ub294 \ub9ac\ubc84\uc2a4 \ud504\ub85d\uc2dc\uc5d0 \uc704\uc784\ud55c\ub2e4. \uc774 \ub2e4\uc12f \uac00\uc9c0\uba74 \uc5b4\ub5a4 \ud074\ub77c\uc6b0\ub4dc\uc5d0\uc11c\ub3c4 \ud1b5\ud55c\ub2e4.<\/p>\n\n<div class=\"cta\">\n<h3>\ub2e4\uc74c \ud3b8 \uc608\uace0 \u2014 \ubbf8\ub2c8 \ud504\ub85c\uc81d\ud2b8: To-Do API<\/h3>\n<p>\ub9c8\uc9c0\ub9c9 12\ud3b8. \uc9c0\uae08\uae4c\uc9c0 \ubc30\uc6b4 \ub77c\uc6b0\ud130\u00b7DB\u00b7\uc778\uc99d\u00b7\ubc30\ud3ec\ub97c \ubaa8\ub450 \ud569\uccd0, \ucc98\uc74c\ubd80\ud130 \ub05d\uae4c\uc9c0 \ub3d9\uc791\ud558\ub294 To-Do API \ud558\ub098\ub97c \uc644\uc131\ud55c\ub2e4.<\/p>\n<\/div>\n\n<div class=\"footer-nav\">\n\uc2dc\ub9ac\uc988 \u00b7 <a href=\"https:\/\/junai.ai\/blog\/category\/fastapi\/\">\uc27d\uac8c \ubc30\uc6b0\ub294 FastAPI<\/a> \u00b7 \ud568\uaed8 \ubcf4\uae30: <a href=\"https:\/\/junai.ai\/blog\/category\/python\/\">\ud30c\uc774\uc36c \uae30\ucd08 \uc2dc\ub9ac\uc988<\/a>\n<\/div>\n\n<\/article>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Dockerfile \ub85c \uc571\uc744 \ud328\ud0a4\uc9d5\ud558\uace0 \uc5ec\ub7ec \uc6cc\ucee4\uc640 Gunicorn \uc73c\ub85c \ub744\uc6b0\ub294 \ubc95, \uc2dc\ud06c\ub9bf\uc740 \ud658\uacbd\ubcc0\uc218\ub85c. FastAPI \ud504\ub85c\ub355\uc158 \ubc30\ud3ec \uc815\uc11d. \uad50\uc7ac 11\ud3b8.<\/p>\n","protected":false},"author":1,"featured_media":933,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-946","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-fastapi"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/946","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/comments?post=946"}],"version-history":[{"count":0,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/posts\/946\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media\/933"}],"wp:attachment":[{"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/media?parent=946"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/categories?post=946"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/junai.ai\/blog\/wp-json\/wp\/v2\/tags?post=946"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}