DEVOCEAN

안녕하세요~ SKHYNIX DRAM EUV 노광PHOTO기술팀 장우석 TL입니다.

다들 알고 계시겠지만, 얼마 전에 큰 일이 있었어요.

인증서 문제로 인한 cdn.jsdelivr.net 접속 불능 사태 | GeekNews (hada.io)

지난 목요일(5/3)에 cdn.jsdelivr.net이 접속불능에 빠졌습니다.

저게 어떤 사이트냐면,

bootstrap, jquery 등등을 저희가 link tag로 편하게 이용하고자 할 때, 무심코 접속하게 되는 사이트입니다.

제가 js, css 번들을 다운 받을 필요 없이, 단지 저 link tag를 html에 삽입하는 것만으로 위 라이브러리들을 사용할 수 있어서 편하게 사용들을 했었는데요.

저거 넣어서 만들었던 서비스들이 여럿 깨져있어서, cdn.jsdelivr.net이 복구 될 때까지 매우 혼란스러운 하루를 보냈었습니다.

(이래서 귀찮다고 링크 태그 같은 거 쓰고 그러면 안 되나 보네요.)

대부분의 서비스는, js, css 번들 다운 받아 붙이는 걸로 금새 복구할 수 있었는데,

문제는 fastapi 였습니다.

fastapi에는 자동으로 swagger 문서를 생성해주는 매우 편리한 기능이 있는데요.

이걸 사내 api 만들어서 공유할 때 engr들이 엄청 많이 쓰고 있었는데, (사실상 fastapi를 사용하는 이유의 8할...)

문제는 fastapi에서 자동으로 만드는 swagger 문서가

https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css

https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js

이 두 녀석으로부터 css, js를 받아온다는 것이었습니다.

fastapi에서 자동으로 생성해주는 docs endpoint에 대한 configuration 때문에 고민을 좀 했었어요. 결론적으로는 이렇게 해결하시면 됩니다.

https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css

https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js

일단 swagger-ui.css 하고 swagger-ui-bundle.js 를 구합니다.

저는 그냥 브라우저로 저 url에 접속해서 구해둔 게 있어서 썼는데요. 구글 검색하시면 css, js 구하실 수 있으실 거예요.

(+ 제가 쓴 파일 압축해서 첨부 파일에도 올려뒀습니다.)

얼추 project가 이렇게 구성되어 있다고 치면,

from fastapi import FastAPI, Response
from fastapi.responses import RedirectResponse
from fastapi.openapi.docs import get_swagger_ui_html
import uvicorn
from pathlib import Path

PATH_APP_PY = Path(__file__)
PATH_PROJECT = PATH_APP_PY.parent

app = FastAPI(docs_url=None)  #remove default /docs endpoint

@app.get('/')
def index():    
    return RedirectResponse('/docs')

@app.get('/docs')
def swagger_docs():    
    rsp = get_swagger_ui_html(                                          
                                openapi_url = "/openapi.json",                                   
                                title = "SWAGGER EXAMPLE",                                    
                                swagger_css_url="/swagger_css",                                    
                                swagger_js_url = "/swagger_js"                               
                            )    
    return rsp

@app.get('/swagger_css')
def swagger_css():    
    with open(Path(PATH_PROJECT,"swagger-ui.css"),'rt',encoding='utf-8') as f:        
        swagger_css = f.read()    
    return Response(swagger_css,headers={"Content-type":"text/css"})

@app.get('/swagger_js')
def swagger_js():   
    with open(Path(PATH_PROJECT,"swagger-ui.js"),'rt',encoding='utf-8') as f:        
        swagger_js = f.read()    
    return Response(swagger_js,headers={"Content-type":"text/javascript"})

if __name__ == "__main__":    
    uvicorn.run(app,host="0.0.0.0",port=5000)

app.py를 이렇게 구성하시면 됩니다. 간단한 샘플 코드니 보면 바로 이해되실 거예요.

https://github.com/tiangolo/fastapi/blob/master/fastapi/openapi/docs.py

기본적으로 fastapi의 /docs endpoint는

fastapi.openapi.docs 에 있는 get_swagger_ui_html 을 실행해서 출력하도록 되어 있습니다.

이 부분을 원하는 대로 커스터마이징해서 실행하도록 구성하면 설정을 바꿔줄 수 있어요.

저 코드를 실행하고 docs 엔드포인트에 들어가보면

저렇게 swagger 문서에서 cdn.jsdelivr.net과의 의존성이 없어진 것을 확인하실 수 있습니다.