저는 FastAPI Cloud를 발견했습니다.

FastAPI 자체를 만든 동일한 팀이 구축했습니다. 아직 베타(beta) 단계입니다. 신용카드 등록 없이 최대 3개의 앱까지 사용할 수 있는 무료 취미(hobby) 계층을 제공합니다.

핵심 제안은 간단합니다. FastAPI 앱을 배포하려면 항상 FastAPI와는 상관없는 작업들이 필요했습니다. Dockerfile 작성, 포트(port) 설정, Render 또는 Railway 대시보드 구성, Procfile 작성, requirements.txt에 uvicorn을 추가하는 것을 기억하는 것 등 말이죠. 이 중 어느 것도 실제 애플리케이션과는 관련이 없습니다. 이 모든 것은 코드를 완성하고 실제 URL에서 라이브 상태로 만드는 과정 사이에 놓인 오버헤드(overhead)일 뿐입니다.

FastAPI Cloud는 이 모든 것을 제거합니다. 배포 명령어는 다음과 같습니다:

fastapi deploy

그게 전부입니다. 저는 이 링크를 코호트(cohort) 그룹 채팅방에 보낸 뒤, 즉시 제 터미널을 열어 테스트해 보았습니다.

실제로 일어난 일

저는 로컬 폴더에 있던 간단한 서점 API(별다른 기능 없이 GET /books, POST /books만 있는 것)를 대상으로 지정했습니다. fastapi deploy를 실행했습니다. CLI(Command Line Interface)가 로그인 여부를 물었고, 브라우저 인증 페이지가 열렸으며, 1분도 채 되지 않아 인증을 마쳤습니다.

그 다음 어떤 팀에 배포할지 물었습니다. 저는 RAG AI(제 워크스페이스)를 선택하고 디렉토리를 확인하자 빌드가 시작되었습니다.

빌드 로그에는 의존성(dependencies) 설치, 소스 코드 복사, 작업 디렉토리 구성 등이 스크롤되어 올라갔고, 이어서 다음과 같이 나타났습니다:

Ready the chicken! 🐔
Your app is ready at https://bookshop-api.fastapicloud.dev

저는

초록색 체크 표시. us-east-1. 마지막 업데이트 36초 전. 제 Windows 노트북에 있는 프로젝트 폴더로부터, 총 3분도 채 걸리지 않아 실제 공개 URL을 가진 실제 배포된 앱이 만들어졌습니다.

/docs - 라이브 상태이며 상호작용이 가능한 전체 Swagger UI입니다. GET /books, POST /books, 그리고 Schemas 섹션의 Book 스키마(schema)까지. 설정 파일을 작성할 필요도, 대시보드를 수동으로 만들 필요도 없이 자동 문서화가 완료된 완전한 배포 API입니다.

이것이 교육에 중요한 이유

초보자에게 FastAPI를 가르칠 때 가장 어려운 부분은 FastAPI 자체가 아닙니다. 그 이후에 따르는 모든 과정, 즉 "이제 내가 만든 것을 어떻게 다른 사람에게 보여주지?"라는 문제입니다.

학생이 로컬(local)에서 작동하는 API를 공개 URL로 옮기는 과정은 현재 사용하는 플랫폼이 무엇인지, 무엇이 고장 나는지에 따라 20분에서 수업 시간 전체가 걸리기도 합니다. Docker 혼란, Render 무료 티어의 콜드 스타트(cold starts), 누락된 환경 변수(environment variables), 잘못된 시작 명령(start commands) 등 이 모든 것은 우리가 실제로 가르치려는 기술과는 아무런 상관이 없는 마찰 요소들입니다.

fastapi deploy는 이 과정을 단 3분과 하나의 명령어로 압축합니다. 교육적인 맥락에서 이것은 작은 개선이 아닙니다. 이는 단 한 번의 세션 내에서 가능한 범위를 변화시킵니다.

알아두어야 할 주의사항

현재 베타(beta) 버전입니다. 무료 취미(hobby) 티어는 최대 3개의 앱까지 지원하며, 이는 개인 프로젝트나 빠른 데모를 보여주기에 충분합니다. API 키가 필요한 프로젝트(RAG 구축 시 필요할 것입니다)의 환경 변수 처리, 지속성 저장소(persistent storage), 또는 트래픽이 높아질 때 어떻게 작동하는지는 아직 알지 못합니다. 이는 베타 기간이 끝난 후에 확인해야 할 질문들입니다.

하지만 현재 기능만 놓고 본다면 — 단 한 번의 명령어로 FastAPI 프로젝트를 가져와 라이브 공개 URL에 배포하는 기능은 — 광고된 내용 그대로 정확하게 작동합니다.

사용해 보기

pip install "fastapi[standard]"
fastapi deploy

설정 과정이 너무 번거롭다는 이유로 프로젝트 배포를 미뤄왔다면 — 이제 그 핑계는 사라졌습니다.