"내 컴퓨터에선 잘 되는데?" 1인 개발자의 FastAPI Docker(도커) 컨테이너 도입기

👤 인스피

조회 수 14

1. 멘붕의 연속: 서버 환경과 로컬 환경은 완전히 달랐다

사건의 발단은 이렇습니다. 제 윈도우(Windows) 노트북에는 파이썬 3.11 버전이 깔려 있었고, 그 위에 FastAPI와 데이터베이스 연동을 위한 수많은 라이브러리들을 pip install로 덕지덕지 설치해 둔 상태였습니다.

코드를 다 짜고 깃허브(GitHub)를 통해 오라클 클라우드 우분투 서버로 코드를 가져왔습니다. 그리고 똑같이 라이브러리들을 설치하려고 하는데, 서버의 기본 파이썬 버전은 3.10이었고 운영체제(OS)가 리눅스다 보니 윈도우에서 잘만 깔리던 특정 라이브러리들이 C++ 컴파일러 에러를 뱉으며 설치를 거부하기 시작했습니다.

부랴부랴 우분투 서버의 파이썬 버전을 강제로 올리려다 리눅스 시스템 패키지가 꼬여버렸고, 결국 눈물을 머금고 서버 인스턴스를 통째로 삭제한 뒤 처음부터 다시 세팅해야만 했습니다. 서버를 옮길 때마다 이 짓을 반복해야 한다고 생각하니 눈앞이 캄캄해졌습니다.

2. 구원투수 도커(Docker)의 등장: 내 컴퓨터 환경을 통째로 얼려버리자

이 지독한 '환경 불일치' 문제를 어떻게 해결할까 고민하다가 도입한 것이 바로 도커(Docker)입니다.

도커의 원리는 생각보다 아주 직관적입니다. 코드를 실행하려면 코드 파일뿐만 아니라, 그 코드가 돌아가는 파이썬 버전, 운영체제(OS) 환경, 각종 라이브러리들이 모두 필요하죠? 도커는 이 모든 것을 하나의 거대한 '컨테이너(상자)' 안에 통째로 얼려서 포장해 버립니다.

이렇게 포장된 컨테이너 박스를 들고 오라클 클라우드든, AWS든, 구글 클라우드든 어디로 가져가서 압축을 풀기만 하면 '내 로컬 컴퓨터와 100% 똑같은 환경'이 그대로 펼쳐지는 것입니다. 더 이상 서버의 기본 파이썬 버전이 무엇인지 신경 쓸 필요가 전혀 없어지는 기적이 일어납니다.

3. FastAPI 서버를 도커로 감싸기: Dockerfile 작성

도커를 쓰기 위해서는 컨테이너를 어떻게 포장할 것인지 설명서(레시피)를 써주어야 합니다. 이 설명서를 Dockerfile이라고 부릅니다. 제 FastAPI 프로젝트 최상단 폴더에 파일명 확장자 없이 Dockerfile을 하나 만들고 아래와 같이 작성했습니다.

코드 주석에도 적어두었듯, 이 파일 하나가 "깨끗한 컴퓨터를 가져와서, 파이썬을 깔고, 폴더를 만들고, 코드를 넣고, 서버를 실행해라"라는 모든 명령을 대신해 줍니다.

4. 서버 배포의 쾌감: 단 두 줄의 명령어로 끝!

이제 오라클 클라우드 서버에 접속해서 도커 엔진(Docker Engine)만 딱 하나 설치해 두면 준비는 끝납니다. 더 이상 서버에 파이썬을 깔거나 pip install을 치며 에러 메시지와 싸울 필요가 없습니다.

터미널에서 딱 두 줄의 명령어만 입력했습니다.

명령어를 치고 몇 초 뒤, 브라우저를 통해 제 웹사이트 주소로 접속해 보았습니다. 윈도우 환경에서 테스트하던 그 모습 그대로, 단 하나의 에러도 없이 완벽하게 백엔드 서버가 응답을 보내왔습니다. 과거에 패키지 충돌로 서버를 몇 번이나 엎었던 고생이 주마등처럼 스쳐 지나가며 엄청난 쾌감이 밀려왔습니다.

맺으며: 1인 개발자일수록 인프라 자동화는 필수다

보통 도커나 쿠버네티스 같은 컨테이너 기술은 대기업이나 대규모 트래픽을 다루는 큰 팀에서만 쓰는 기술이라고 생각하기 쉽습니다. 하지만 제가 직접 겪어보니, 오히려 서버를 전담해 줄 인프라 엔지니어가 없는 1인 개발자에게 가장 절실하게 필요한 기술이 바로 도커였습니다.

개발 환경 세팅에 버려지는 수십 시간을 절약해 주고, 새벽에 서버가 뻗어도 컨테이너만 껐다 켜면 복구되는 이 안정성은 한 번 맛보면 절대 이전(직접 설치)으로 돌아갈 수 없게 만듭니다.

아직도 서버를 이사할 때마다 터미널에 apt-get install을 수십 번씩 치고 계시나요? 그렇다면 이번 주말에는 꼭 도커(Docker)를 공부해서 여러분의 소중한 프로젝트를 컨테이너에 담아보시길 강력하게 권해드립니다.