[책 리뷰] 기획에서 출시까지 FastAPI 개발 백서

책의 저자 분은 "푸딩캠프"라는 개발 커뮤니티를 운영 중인 분입니다. 푸딩캠프라는 이름을 들어본 적이 있었던 터라, 인지도 있는 커뮤니티를 운영하는 분이 집필한 책이라는 점에서 신뢰도가 한층 높아진 책입니다. 커뮤니티를 운영하고 실제로 많은 개발자들을 만나고 교육해온 분이 쓴 책이라는 점에서 내용에 대한 기대감이 자연스럽게 커졌습니다.

 

기획부터 출시까지-라는 제목도 인상적이었습니다. 단순한 FastAPI 실습 예제가 아니라 하나의 서비스를 처음부터 끝까지 만들어보는 전 과정을 경험해볼 수 있겠다, 라는 느낌을 주었고 실제로 책을 읽어보니 그 기대에 정말 잘 부합하는 구성이라는 생각이 들었습니다.

 

 

길벗 31차 개발자 리뷰어 활동을 위해 길벗 출판사에서 책을 제공받아 작성한 리뷰입니다.

표지가 이뻐용

개요

"기획에서 출시까지 FastAPI 개발 백서"는 "약속잡기 서비스"를 예제로 삼아 FastAPI를 학습합니다. 그냥 API 몇 개를 만들어보는 수준이 아니라 서비스 기획, PRD 작성, 설계, 데이터베이스 모델링, 백엔드 구현, 외부 API 연동, 프론트엔드 연동, 테스트, 모니터링, 배포까지, 제목 그대로 설계부터 출시 이후 운영까지 고려한 전 과정을 다룹니다.

 

[아래는 목차]

목차
1장. 우리가 만들 프로젝트와 도구 이해
- 1.1 프로젝트를 만들고 운영해야 하는 이유
- 1.2 FastAPI를 사용하는 이유
- 1.3 우리가 만들 프로젝트의 목표와 계획
- 1.4 약속 잡기 프로젝트에 사용하는 도구

2장. 셸 기본 기능 익히기
- 2.1 셸이란
- 2.2 경로와 디렉터리
- 2.3 파일 다루기

3장. 실습 환경 준비
- 3.1 비주얼 스튜디오 코드 설치
- 3.2 비주얼 스튜디오 코드 화면 구성
- 3.3 비주얼 스튜디오 코드 기본 사용법
- 3.4 비주얼 스튜디오 코드 확장 기능
- 3.5 파이썬 가상 환경
- 3.6 FastAPI 설치하고 맛보기

4장. 약속 잡기 서비스 기획
- 4.1 약속 잡기 서비스 기능 기획
- 4.2 주요 기능
- 4.3 사용자 인터페이스 요소 기획
- 4.4 데이터 설계

5장. 데이터 모델링
- 5.1 파이썬에서 데이터베이스를 사용하는 방법: SQLModel
- 5.2 모델링
- 5.3 데이터베이스 연결 설정
- 5.4 Alembic을 사용하여 데이터베이스 마이그레이션

6장. 코드 테스트
- 6.1 테스팅 개요
- 6.2 단위 테스트 실습
- 6.3 통합 테스트 실습
- 6.4 pytest의 픽스처 기능을 사용한 테스팅

7장. 회원가입 및 사용자 인증 구현
- 7.1 회원가입 테스트 코드 작성
- 7.2 회원가입 API 구현
- 7.3 로그인 구현
- 7.4 자기 자신의 정보를 가져오는 API 구현
- 7.5 FastAPI 캘린더, 계정 설정 페이지 구현

8장. 사용자별 캘린더 및 예약 관리 구현
- 8.1 호스트별 캘린더 가져오기
- 8.2 호스트의 캘린더를 생성하고 변경
- 8.3 타임슬롯 관리 
- 8.4 예약
- 8.5 캘린더 예약 가져오기 
- 8.6 FastAPI 캘린더, 예약 관리
- 8.7 부킹에서 참석 상태 정보 다루기
- 8.8 파일 업로드 

9장. 운영자 페이지에서 데이터 관리
- 9.1 운영자 페이지와 SQLAdmin 
- 9.2 SQLAdmin 기본 활용법
- 9.3 메서드 오버라이딩을 활용하여 기능 확장 및 변경
- 9.4 SQLAdmin 사용자 인증 체계

10장. 약속 잡기 프로젝트에 프런트엔드 연동
- 10.1 정적 파일
- 10.2 구현된 결과물을 파이썬 웹 서버로 구동
- 10.3 CORS 처리
- 10.4 호스트 목록 API
- 10.5 인증 토큰이 없는 경우에 대한 명확한 응답
- 10. 6 캘린더 흐름
- 10.7 웹 프런트엔드 개발 명세

11장. SQLAlchemy 지연 로딩 전략 
- 11.1 지연 로딩이란
- 11.2 지연 로딩의 종류 
- 11.3 SQLAlchemy 지연 로딩 적용

12장. 구글 캘린더 연동
- 12.1 구글 클라우드 API
- 12.2 구글 캘린더에 이벤트 생성
- 12.3 구글 캘린더의 이벤트 관리
- 12.4 약속 잡기 구현체에 구글 캘린더 연동 적용
- 12.5 FastAPI 백그라운드 작업

13장. 오류 기록과 관찰, 관리
- 13.1 오류 로그 체계
- 13.2 Sentry란
- 13.3 계정과 프로젝트 생성
- 13.4 약속 잡기 프로젝트에 Sentry 반영
- 13.5 오류 로그 테스트
- 13.6 수동으로 로그 남기기

14장. 아마존 웹 서비스에 배포하기
- 14.1 의존 패키지 관리
- 14.2 AWS Lightsail(라이트세일)로 서버 구성
- 14.3 인스턴스 서버에 환경 구성
- 14.4 깃허브 액션을 사용하여 배포 자동화 

목차부터...이건 진짜다라는 느낌

운영 가능한 서비스 개발

이 책을 읽으면서 가장 크게 느낀 점은, FastAPI를 잘 쓰는 법보다도 FastAPI를 사용해 실제로 굴러가는 서비스를 만드는 법에 초점이 맞춰져 있다는 점입니다. 저자님이 책 초반부터 운영의 중요성을 강조합니다. 서비스를 구현하고 끝나는게 아니라 어떻게 잘 설계하고, 어떻게 배포하고, 어떻게 모니터링하고, 어떻게 문제를 감지하고 대응할 것인지 까지 고려해야 진짜 서비스라는 관점이 목차부터 잘 드러나는 것 같습니다. 

 

프론트엔드 연동까지 경험 가능

이 책은 FastAPI를 사용해 백엔드 구현에만 그치지 않습니다. 프론트엔드를 실제로 연동해보는 과정까지 포함되어 있습니다. 

• CORS 문제
• 인증 예외 처리

처럼 프론트-백엔드 연동 시 발생할 수 있는 이슈들을 직접 다루면서, 이론으로만 알던 문제들이 실제로 어떻게 나타나는지를 경험할 수 있었습니다. 특히 프론트엔드 파일을 따로 제공해줘서 복잡한 설정 없이 다운로드해서 바로 연동해볼 수 있다는 점이 좋았습니다. 

 

백단만 다루지 않고 프론트까지 연결해보는 과정을 보면서 확실히 "실제 서비스 개발"에 한 걸음 더 가까워진 느낌이 들었습니다.

 

데이터베이스 설계와 SQLAlchemy 활용

SQLAlchemy를 활용한 데이터베이스 처리를 상당히 자세하게 다룹니다. 백엔드 개발은 부트캠프를 통해 어느 정도 배워본 상태였지만, 프로젝트에서 백엔드로 깊게 참여해본 적은 없어 DB단을 "제대로 설계하고 활용한다"는 것은 늘 어렵게 느껴졌습니다.

 

이 책에서는 

• 인증, 캘린더 등 비교적 복잡한 도메인 모델링
• SQLAlchemy를 활용한 관계 설정
• 지연 로딩 처리
• sqlAdmin을 사용한 간단한 운영자 페이지 구성

등을 다루면서, 데이터를 단순히 저장하고 꺼내쓰는 수준을 넘어 잘 설계하고, 효율적으로 구현하고, 운영하는지를 체감할 수 있었습니다.

구글 캘린더 연동, 외부 API 통합 경험

개인적으로 가장 재미있었더 부분은 구글 캘린더 연동입니다. 실제로 많이 쓰이는 외부 API 연동 과정을 꽤 실용적으로 다룹니다. 외부 API를 연동하는 전체 흐름을 한 번 제대로 경험해볼 수 있어서, 앞으로 다른 서비스를 만들때도 유용하게 쓸 수 있겠구나 생각이 듭니다.

배포와 운영: Sentry, AWS Lightsail

sentry를 활용한 로깅과, AWS Lightsail을 이용한 배포도 배울 수 있습니다. EC2, S3 등 자주 쓰는 서비스에 비해 Lightsail은 다소 낯선 서비스였습니다. 백엔드 배포도 아직은 많이 낯선데, 책을 따라가면서 Lightsail로 백엔드를 배포하는 방법을 단계적으로 배울 수 있었습니다.

느낀점

fastapi에 대해서도 정말 많은 것을 배울 수 있었지만, 가장 큰 강점으로 느껴진 부분은 역시 기획과 설계입니다. 요즘은 AI의 도움으로 코드 작성 자체의 난이도는 많이 낮아졌고, 백엔드 구현도 역시 이전보다는 접근성이 높아진 편이라고 느낍니다. 그래서 오히려 "어떤 서비스를 만들 것인지", "어떤 구조로 설계할 것인지"가 더 중요해졌다고 생각합니다.

 

그런 점에서 이 채근 기획, 설계, 운영에 대한 인사이트를 함께 제공해준다는 점에서 단순한 FastAPI 기술서 그 이상이라고 느껴졌습니다.

 

탄탄한 구성도 마음에 들었습니다. 무려 600페이지가 넘는 분량...fastapi는 가볍고 빠른 기술로 유명한 것에 반해 책은 생각이상으로 두껍고 무겁습니다. 두께만 보아도, 그리고 목차만 훑어보아도 개발 전반을 정말 꼼꼼하게 다루고 있다는 느낌을 받을 수 있습니다.

하나의 예제를 기준으로

• 기능을 추가하고
• 코드를 수정하고
• 점점 발전시키는 구조

로 진행되기 때문에, 코드 변경 흐름을 따라가고, 이 모듈은 왜 추가하지?에 대한 의문도 쉽게 해소할 수 있어서 좋았습니다. 코드 구성과 설명의 깊이 덕분에, FastAPI라는 기술을 정말 탄탄하게 익힐 수 있는 구성이라고 느꼈습니다.

최신 책인 만큼 fastapi, sqlalchemy 등 최신 버전 기준으로 학습할 수 있다는 점도 소소하지만 분명한 장점입니다.

 

+ 실습 환경 구축 파트는 보통 대충 훑고 넘어가는 편인데, 최근 Mac으로 기변할 일이 있어서 이 부분에서 정말 많은 도움을 받았습니다. fastapi 개발을 위한 환경 설정이 필요하신 분들에게 크게 도움이 될 부분...

 

추천 대상

• 개발자 취업을 준비 중인 분
• FastAPI를 본격적으로 제대로 배워보고 싶은 분
• 하나의 서비스를 기획부터 출시, 운영까지 직접 경험해보고 싶은 분

두께가 있는 편이라 FastAPI 문법만 빠르게 훑는 책을 찾는 분보다는, FastAPI를 탄탄하게 익히고 싶거나 "실제 서비스 개발 경험"을 한 번 제대로 해보고 싶은 분들께 특히 잘 맞는 책이라고 생각합니다.

 

이 책이 궁금하다면->

기획에서 출시까지 FastAPI 개발 백서 | 차경묵 | 길벗 - 예스24