FastAPI

준비 및 확인사항

지원 Python 버전

• 3.7, 3.8, 3.9, 3.10, 3.11, 3.12
• FastAPI는 최소 3.7 버전의 Python를 필요로 합니다.
• ⚠️ 로컬/테스트 환경과 클라우드타입에서 설정한 Python 버전이 상이한 경우 정상적으로 빌드되지 않을 수 있습니다.

대시보드를 통한 생성

1. 템플릿 선택하기

• Github 저장소에서 템플릿 보기

• 시작하기 페이지의 언어/플랫폼 카테고리에 접속 또는 ⌘ + K 를 사용하여 fastapi 를 검색하고 FastAPI 템플릿을 클릭하세요.

2. 새 저장소(repository) 생성하기 또는 나의 저장소 선택하기

클라우드타입은 기본적으로 사용자 Github 계정의 저장소에 반영된 소스를 배포합니다.

• 1️⃣ 배포하려는 저장소가 없다면 ⇒ 클라우드타입이 제공하는 예제 저장소를 사용자의 Github 계정에 생성합니다.
• 2️⃣ 배포하려는 저장소가 있다면 ⇒ 클라우드타입에서 배포할 사용자 본인의 저장소를 선택합니다.

1️⃣ 배포하려는 저장소가 없는 경우

• 아래의 그림처럼 비공개 저장소 설정하기 여부만 선택한 후 저장소 만들기 를 클릭하면 사용자의 Github 계정에 해당 템플릿 저장소가 자동으로 생성됩니다.

2️⃣ 배포하려는 저장소가 있는 경우

• Github 계정에 존재하는 저장소를 사용하려는 경우 아래의 화면처럼 여러 저장소 중 배포를 원하는 항목을 선택하세요. 이미 위에서 저장소를 만든 경우 이 부분은 건너뛰어주세요.
• 저장소를 직접 선택한 경우, 빌드 및 시작을 위한 명령어 등 세부 설정이 기본 설정과 다를 수 있습니다. 아래의 그림처럼 빌드 설정의 설정변경 버튼을 클릭하고 수정이 필요한 설정사항을 수정해주세요.

3. 배포하기

• 위 과정을 마친 후 마지막으로 배포할 리전을 선택하고 배포하기 버튼을 클릭하면 배포가 자동으로 진행됩니다.

CLI 를 통한 생성

1. 사전준비

아래 가이드에 따라 CLI 를 설치하고 로그인을 진행해주세요.
CLI 설치하기

2. 설정파일 생성

.cloudtype/app.yaml 파일을 생성하세요.

FastAPI

name: fastapi
app: [email protected]
options:
  ports: 8000
  start: uvicorn main:app --host=0.0.0.0 --port=8000
context:
  git:
    url: https://github.com/cloudtype-examples/fastapi.git
    branch: main
  preset: python-fastapi

3. 배포하기

$ ctype apply

참고

FAQ

• Django, Flask, FastApi 배포했는데 503 Error가 발생해요.
• No module named ‘’ 혹은 Command not found 에러 로그가 떠요.
• 에러 로그에서 CPython.c 등과 관련한 C언어 빌드 도구 의존성 에러가 발생해요.
• uvicorn: uvicorn command not found 에러가 발생하면서 어플리케이션이 실행되지 않아요.
• FastAPI 서버가 정상적으로 실행되지 않아요.

공식문서

• FastAPI Docs