배포

배포는 내 컴퓨터에서만 돌던 프로그램을 인터넷에 연결된 서버에 올려, 누구나 주소로 들어와 쓸 수 있게 만드는 일이에요. 집 부엌에서 만든 요리를 가게 진열대에 올리는 것과 같아요.

배포하면 무슨 일이 일어나요?

세 단계로 나눠 보면 쉬워요.

세 단계를 섞지 말고 따로 두라는 원칙이 널리 쓰여요. 그래야 "어떤 번호의 묶음이 지금 돌고 있는지"가 분명해지고, 문제가 나면 이전 번호로 바로 돌아갈 수 있어요.

왜 내 컴퓨터에서는 남이 못 들어와요?

2026-10-29 사무실 PC 에서 파이썬으로 작은 웹 서버를 켜 봤어요.

$ python -m http.server 8765 --bind 127.0.0.1
$ curl -I http://localhost:8765/
HTTP/1.0 200 OK
Server: SimpleHTTP/0.6 Python/3.12.8

내 컴퓨터에서는 200(정상)이 나와요. 하지만 localhost(127.0.0.1)는 '나 자신'을 뜻하는 주소예요. 옆자리 사람이 같은 주소를 치면 그 사람 컴퓨터를 찾아가요.

집 공유기 안쪽 주소(192.168.…)도 밖에서는 보이지 않아요. 그래서 24시간 켜져 있고, 인터넷에서 찾아올 수 있는 주소와 도메인이 붙은 서버에 올려야 해요. 이 일이 배포예요.

배포와 릴리스는 뭐가 달라요?

둘을 섞어 쓰기도 하지만 엄밀히는 달라요. 배포는 새 코드를 서버에 올려 켜는 기술적인 일이에요. 릴리스는 그 기능을 손님에게 공개하는 결정이에요.

예를 들어 새 결제 화면 코드를 미리 배포해 두고, 스위치(기능 플래그)를 꺼 둘 수 있어요. 준비가 끝난 날 스위치만 켜면 그게 릴리스예요.

서비스를 안 멈추고 바꾸는 법이 있나요?

혼자 운영하는 작은 서비스라면 한 번에 교체로 충분해요. 손님이 많은 시간을 피해서 하면 돼요.

잘못 배포하면 어떻게 되돌려요?

바로 전 버전으로 다시 배포하는 걸 롤백이라고 해요. 묶음에 번호(태그)를 매겨 두었다면 "v1.2 로 다시"처럼 번호만 바꿔 배포하면 돼요.

데이터베이스 구조를 바꾼 배포는 코드만 되돌려선 안 될 때가 있어요. 그래서 큰 배포 전에는 백업이나 스냅샷을 먼저 남겨요.

직접 배포하고 되돌려 보면 어때요?

2026-10-29 사무실 PC 에서 웹 서버 컨테이너(nginx)로 작은 실험을 했어요. 화면에 "v1" 만 찍는 페이지를 배포하고, "v2" 로 바꾼 뒤, 다시 v1 로 롤백했어요. 그동안 0.05초마다 페이지를 열어 보며 몇 번 끊기는지 셌어요.

docker run -d --name web -p 127.0.0.1:28413:80 -v ./v1:/usr/share/nginx/html:ro nginx:1.30.6-alpine
docker rm -f web          # 옛 버전 끄기
docker run -d --name web ... -v ./v2:/usr/share/nginx/html:ro ...   # 새 버전 켜기

12초 동안 149번 열어 봤는데 14번이 실패했어요. 옛 버전을 끄고 새 버전이 뜨기 전까지 1초쯤 빈틈이 생긴 거예요. 한 번에 교체하는 방식의 약점이 바로 이 빈틈이에요. 롤링이나 블루-그린은 새 버전을 먼저 띄운 뒤 길을 돌려서 이 1초를 없애요.

롤백도 결국 '옛 번호로 다시 배포'였어요. v1 폴더(이미지)를 지우지 않고 남겨 두었기 때문에 2초 안에 돌아갈 수 있었어요.

자주 하는 오해는 뭐예요?

퓨쳐인프라에서는 어떻게 배포해요?

퓨쳐인프라 앱 호스팅은 도커 이미지 이름만 알려 주면 배포돼요. API 로는 두 번이면 끝나요.

POST /v1/apps                 { "slug": "myshop" }
POST /v1/apps/<id>/deploy     { "image": "ghcr.io/me/myshop:v1.2.0" }
# https://myshop.futureinfra.app 이 열려요

주소와 HTTPS 가 같이 붙고, 태그를 바꿔 다시 배포하면 그게 업데이트예요. 한 달 5,500원이에요. 실제로 올려 본 시간과 다른 곳 요금은 도커 호스팅 비용 글에 있어요.

자주 묻는 질문

배포는 영어로 뭐예요?

deploy(동사), deployment(명사)예요. 원래 '병력을 배치하다'라는 뜻에서 왔어요.

무료로 배포할 수 있는 곳이 있나요?

정적인 홈페이지는 무료로 올려 주는 곳이 많아요. 데이터베이스나 계속 도는 프로그램이 있으면 보통 유료예요. 비교는 버셀 도메인 연결, 넷리파이 글을 참고하세요.

배포하면 바로 도메인이 생기나요?

서비스마다 달라요. 퓨쳐인프라는 myshop.futureinfra.app 같은 기본 주소를 바로 주고, 가진 도메인도 붙일 수 있어요.

배포 중에 손님이 들어오면 어떻게 돼요?

한 번에 교체하는 방식이면 몇 초~몇십 초 동안 접속이 안 될 수 있어요. 손님이 적은 시간에 하거나 롤링·블루-그린 방식을 써요.

함께 알아 두면 좋은 용어

컨테이너 · 도커 · PaaS · 쿠버네티스 · 스냅샷 · 바이브 코딩