<div id="readability-page-1" class="page"><div id="container" role="main">

 
 
 

 
 
 

 
 
 

 
 
 

 
 
 

 
 
 

 
 
 

 
 
 <article>
 <div>
 
 

 
 <header>
 
 </header>

 

 <div>&nbsp;fastapi에서는 application 안에 application을 넣을 수 있습니다. sub application이라고 칭하겠습니다. 이 sub application들을 mount를 하면, 각 어플리케이션 별로 미들웨어 등을 넣을 수 있어요. 분리를 한다? 예를 들어, health check 어플리케이션이랑, api 어플리케이션이랑 분리할 수 있습니다.

&nbsp;이 방법을 간단하게 알아볼 거에요.&nbsp;

<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style3">
<figure data-ke-mobilestyle="widthOrigin" data-filename="su7.png" data-origin-width="443" data-origin-height="180"><img src="https://blog.kakaocdn.net/dn/byN2nH/btsjRXXdz35/ac4hoUsoCFEQmyiGFp9zB1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su7.png" data-origin-width="443" data-origin-height="180"></figure>

&nbsp;먼저 패키지 구조부터 보겠습니다. 별 다른 것은 없고요. sub 패키지 안에 sub_app_1.py와 sub_app_2.py가 있는 구조에요.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su1.png" data-origin-width="493" data-origin-height="289"><img src="https://blog.kakaocdn.net/dn/EPYUl/btsjS5tVCND/qo9Uv0K31m7goRWP7Gli01/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su1.png" data-origin-width="493" data-origin-height="289"></figure>

&nbsp;먼저 main.py를 보겠습니다. app_1과 app_2를 import 하는데요. 하나는 /sub1에, 다른 하나는 /sub2에 mount 합니다. 여기까지 어렵지 않지요? 여기까지 그림으로 그려보겠습니다.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su8.png" data-origin-width="383" data-origin-height="238"><img src="https://blog.kakaocdn.net/dn/BljXF/btsjOoIQs1a/Ckkc5pRiGMyKsIKQKa2oSk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su8.png" data-origin-width="383" data-origin-height="238"></figure>

&nbsp;/sub1은 어플리케이션 인스턴스 app_1에 mapping이 되고, /sub2는 어플리케이션 인스턴스 app_2에 매핑됩니다. 이 어플리케이션 인스턴스에는 여러 가지 설정들을 할 수 있는데요. 대표적으로 get, post와 같이 api를 추가할 수도 있고, 미들웨어를 추가할 수도 있어요.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su2.png" data-origin-width="414" data-origin-height="224"><img src="https://blog.kakaocdn.net/dn/bKs452/btsjNMplcCe/b076tPjYTIKX1knL88Kspk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su2.png" data-origin-width="414" data-origin-height="224"></figure>

&nbsp;먼저, app_1을 봅시다. app_1 = FastAPI()라고 되어 있어요. 어플리케이션 인스턴스를 선언했어요. 이 app_1은 메인 어플리케이션 객체에 mount 되어 있어서, subapp이라고 할 수 있어요. 여기에는 어떤 설정이 있나요? app_1.get("/health") 정도만 있어요. get /health 정도만 추가로 있네요. 여기까지 그림으로 그려 보겠습니다.


<figure data-ke-mobilestyle="widthOrigin" data-filename="su9.png" data-origin-width="396" data-origin-height="247"><img src="https://blog.kakaocdn.net/dn/bymrh0/btsjR8LaQB5/tkxhk6eRfKa9jRPbCIIOAk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su9.png" data-origin-width="396" data-origin-height="247"></figure>

&nbsp;그렇기 때문에, get /sub1/health로 접근하면 "ok"가 나오게 됩니다. 이제 sub2를 보겠습니다.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su3.png" data-origin-width="641" data-origin-height="269"><img src="https://blog.kakaocdn.net/dn/cBVDT6/btsjRiHib7U/p1E3kWpv2WFGUfYjoGTzKk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su3.png" data-origin-width="641" data-origin-height="269"></figure>

&nbsp;여기도 마찬가지로 어플리케이션 인스턴스를 생성하였어요. 다른 점이 하나 있다면, 미들웨어를 하나 추가했다는 것입니다. 뭔가 이상한 것을 추가한 것을 볼 수 있는데요. TrustedHostMiddleware입니다. allowed_hosts를 "localhost"로만 설정해 놓았음을 볼 수 있어요.

&nbsp;그러면 이것도 그림으로 그려볼게요.


<figure data-ke-mobilestyle="widthOrigin" data-filename="su10.png" data-origin-width="448" data-origin-height="326"><img src="https://blog.kakaocdn.net/dn/mPndK/btsjKSQZsd5/esuzkjwPp5JGMx6O97Xkwk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su10.png" data-origin-width="448" data-origin-height="326"></figure>

&nbsp;요래 되었네요. 결국, app_1과 달리, app_2는 Trusted Host 미들웨어를 타게 됩니다. 여기까지 정리하면 sub app으로 어플리케이션을 분리해서 mount를 시켜 놓았습니다. 각 sub app별로 middleware를 설정하였기 때문에, 어떤 api endpoint에서는 미들웨어를 타고, 어떤 곳에서는 타지 않게 하려면 이 방법을 쓰는 방법도 나쁘지 않습니다.

&nbsp;이제, postman으로 호출을 한 번 해 보겠습니다.

<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style3">
<figure data-ke-mobilestyle="widthOrigin" data-filename="su4.png" data-origin-width="694" data-origin-height="293"><img src="https://blog.kakaocdn.net/dn/c5wgwY/btsjPG9IDNi/6mmBgc7KFxIrhhKGmScOYk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su4.png" data-origin-width="694" data-origin-height="293"></figure>

&nbsp;먼저, http://127.0.0.1:8000/sub/health를 호출해 보겠습니다. /sub1에 mount된 app의 경우에는 아무런 Trusted Host 미들웨어가 걸려있지 않습니다. 고로, 응답은 아래와 같이 오게 됩니다.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su5.png" data-origin-width="661" data-origin-height="137"><img src="https://blog.kakaocdn.net/dn/94Vkp/btsjOpAZglv/3qHKHjOCBgBriFeiQvOTd0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su5.png" data-origin-width="661" data-origin-height="137"></figure>

&nbsp;200 OK가 잘 수행되었네요.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su6.png" data-origin-width="687" data-origin-height="412"><img src="https://blog.kakaocdn.net/dn/cjA1sS/btsjO1NggpM/PBRzgCIpL1InT9ggddmUW0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su6.png" data-origin-width="687" data-origin-height="412"></figure>

&nbsp;문제는 /sub2/health입니다. 127.0.0.1:8000의 경우 host가 127.0.0.1이였기 때문에, middleware에서 Invalid host header가 뜨면서, 400 에러를 떨구게 됩니다.


<figure data-ke-mobilestyle="widthOrigin" data-filename="su11.png" data-origin-width="691" data-origin-height="261"><img src="https://blog.kakaocdn.net/dn/pz3tN/btsjOovl6Hp/YIc39NvbJv8Kbo88R3GjE0/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su11.png" data-origin-width="691" data-origin-height="261"></figure>

&nbsp;대신에 GET http://localhost:8000/sub2/health 요래 호출하면 이야기가 달라집니다. 이 때에는 host가 localhost로 잡힙니다.

<figure data-ke-mobilestyle="widthOrigin" data-filename="su12.png" data-origin-width="529" data-origin-height="146"><img src="https://blog.kakaocdn.net/dn/QDs9O/btsjJWltYbi/h0g6kQgIaEcdUAGCkc7hc1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="su12.png" data-origin-width="529" data-origin-height="146"></figure>

&nbsp;이것은 허용 host 옵션에 있기 때문에, 200이 떨어지게 됩니다.</div>

 
 
 
 
 
 

 </div>
 </article>
 
 
 

 
									
									
 </div></div>

강아지의 코딩공부

fastapi에서는 application 안에 application을 넣을 수 있습니다. sub application이라고 칭하겠습니다. 이 sub application들을 mount를 하면, 각 어플리케이션 별로 미들웨어 등을 넣을 수 있어요. 분리를 한다? 예를 들어, health check 어플리케이션이랑, api 어플리케이션이랑 분리할 수 있습니다.
 
 이 방법을 간단하게 알아볼 거에요. 
 
 먼저 패키지 구조부터 보겠습니다. 별 다른 것은 없고요. sub 패키지 안에 sub_app_1.py와 sub_app_2.py가 있는 구조에요.
 
 먼저 main.py를 보겠습니다. app_1과 app_2를 import 하는데요. 하나는 /sub1에, 다른 하나는 /sub2에 mount 합니다. 여기까지 어렵지 않지요? 여기까지 그림으로 그려보겠습니다.
 
 /sub1은 어플리케이션 인스턴스 app_1에 mapping이 되고, /sub2는 어플리케이션 인스턴스 app_2에 매핑됩니다. 이 어플리케이션 인스턴스에는 여러 가지 설정들을 할 수 있는데요. 대표적으로 get, post와 같이 api를 추가할 수도 있고, 미들웨어를 추가할 수도 있어요.
 
 먼저, app_1을 봅시다. app_1 = FastAPI()라고 되어 있어요. 어플리케이션 인스턴스를 선언했어요. 이 app_1은 메인 어플리케이션 객체에 mount 되어 있어서, subapp이라고 할 수 있어요. 여기에는 어떤 설정이 있나요? app_1.get("/health") 정도만 있어요. get /health 정도만 추가로 있네요. 여기까지 그림으로 그려 보겠습니다.
 
 
 그렇기 때문에, get /sub1/health로 접근하면 "ok"가 나오게 됩니다. 이제 sub2를 보겠습니다.
 
 여기도 마찬가지로 어플리케이션 인스턴스를 생성하였어요. 다른 점이 하나 있다면, 미들웨어를 하나 추가했다는 것입니다. 뭔가 이상한 것을 추가한 것을 볼 수 있는데요. TrustedHostMiddleware입니다. allowed_hosts를 "localhost"로만 설정해 놓았음을 볼 수 있어요.
 
 그러면 이것도 그림으로 그려볼게요.
 
 
 요래 되었네요. 결국, app_1과 달리, app_2는 Trusted Host 미들웨어를 타게 됩니다. 여기까지 정리하면 sub app으로 어플리케이션을 분리해서 mount를 시켜 놓았습니다. 각 sub app별로 middleware를 설정하였기 때문에, 어떤 api endpoint에서는 미들웨어를 타고, 어떤 곳에서는 타지 않게 하려면 이 방법을 쓰는 방법도 나쁘지 않습니다.
 
 이제, postman으로 호출을 한 번 해 보겠습니다.
 
 먼저, http://127.0.0.1:8000/sub/health를 호출해 보겠습니다. /sub1에 mount된 app의 경우에는 아무런 Trusted Host 미들웨어가 걸려있지 않습니다. 고로, 응답은 아래와 같이 오게 됩니다.
 
 200 OK가 잘 수행되었네요.
 
 문제는 /sub2/health입니다. 127.0.0.1:8000의 경우 host가 127.0.0.1이였기 때문에, middleware에서 Invalid host header가 뜨면서, 400 에러를 떨구게 됩니다.
 
 
 대신에 GET http://localhost:8000/sub2/health 요래 호출하면 이야기가 달라집니다. 이 때에는 host가 localhost로 잡힙니다.
 
 이것은 허용 host 옵션에 있기 때문에, 200이 떨어지게 됩니다.
            
'웹 > FASTAPI' 카테고리의 다른 글
fastapi pydantic 필드 단위로 동작하는 validator를 간단하게 알아봅시다  (0)
2023.06.09
fastapi pydantic root validator를 알아봅시다.  (1)
2023.06.06
fastapi alembic revision 명령어를 쓸 때 마이그레이션 버전을 커스텀하게 생성해 봅시다.  (0)
2023.05.31
fastapi 파일 사이즈 제한을 검사하는 방법을 알아봅시다.  (0)
2023.04.29
fastapi background tasks를 간단하게 알아봅시다.  (0)
2023.04.25

fastapi sub application에 대해 알아보고 app마다 다른 middleware를 적용해 봅시다.

댓글