개발자가 "배포 중이에요"라고 할 때 일어나는 일
개발자와 함께 일하면서 “지금 배포 중이에요”라는 말에 고개만 끄덕여 왔다면, 이 글은 바로 그런 분을 위한 글이에요. 다 읽고 나면 배포가 무엇인지, 왜 몇 분씩 기다려야 하는지, 끝났다는데 내 화면은 왜 그대로인지 직접 설명할 수 있게 돼요. 코드는 한 줄도 나오지 않아요. 새벽배송이나 다음 날 배송 같은 온라인 쇼핑에 빗대어 설명하고, 직접 눌러 볼 수 있는 데모도 준비했어요.
웹사이트에는 두 쪽이 있어요
쇼핑몰에는 상품을 진열하는 쪽과 주문하는 쪽이 있죠. 웹사이트도 똑같아요. 개발자는 고친 내용을 진열하고, 우리는 크롬이나 사파리 같은 브라우저로 그걸 주문해서 받아 봐요.
“배포 중이에요”와 “새로고침해 보세요”는 이 그림에서 서로 다른 쪽을 가리키는 말이에요. 앞의 말은 진열하는 쪽, 뒤의 말은 주문하는 쪽 이야기죠. 진열하는 쪽부터 볼게요.
진열하는 쪽: 배포
개발자가 버그를 고치거나 새 기능을 만들면, 그 결과물은 처음엔 개발자 컴퓨터 안에만 있어요. 개발자 화면에서는 이미 잘 돌아가지만, 다른 사람은 아직 아무도 볼 수 없어요.
온라인 쇼핑몰에서 새 상품을 파는 상황을 떠올려 보세요. 공장에서 상품을 다 만들었어도, 쇼핑몰에 진열되기 전까지는 아무도 주문할 수 없어요.
배포가 바로 이 진열이에요. 개발자 컴퓨터에 있는 결과물을 누구나 받아 갈 수 있는 곳에 올려 두는 일이죠. 그래서 “다 고쳤어요”와 “배포했어요”는 다른 말이에요. 고쳤다는 건 상품을 다 만들었다는 뜻이고, 배포했다는 건 이제 주문할 수 있게 진열했다는 뜻이에요.
왜 몇 분씩 걸릴까요
올려 두기만 하면 될 것 같은데 왜 몇 분씩 걸릴까요? 상품이 진열되어 주문을 받을 수 있게 되기까지의 과정을 따라가 보면 이해가 돼요.
먼저 검수하고 포장해요. 많은 팀은 고친 부분이 다른 곳을 망가뜨리지 않았는지 기계가 자동으로 검사하게 해 둬요. 검사를 통과하면, 개발자가 쓴 코드를 브라우저가 바로 읽을 수 있는 웹페이지 형태로 다시 포장해요. 둘 중 하나라도 실패하면 배포는 거기서 멈추고, 개발자가 문제를 고친 뒤 처음부터 다시 시작해요. 기다리는 시간은 대부분 이 단계에서 나와요.
그다음 전국 센터로 실어 날라요. 다음 날 배송이 빠른 건 주문이 들어온 뒤에 멀리서 보내는 게 아니라, 집 가까운 센터에 미리 쌓아 두기 때문이죠. 웹사이트도 똑같이 포장이 끝난 결과물을 전 세계 여러 곳의 컴퓨터에 미리 나눠 보내 둬요. 그래야 주문이 들어왔을 때 서울에서든 뉴욕에서든 가장 가까운 센터에서 바로 보낼 수 있어요.
이 블로그처럼 작은 사이트도 글 한 줄 고쳐서 배포하면 45초쯤 걸려요. 서비스가 크면 검수할 것도 포장할 것도 많아져서 훨씬 오래 걸리기도 해요.
주문하는 쪽: 주소 입력과 새로고침
이번엔 반대편이에요. 웹페이지를 여는 건 쇼핑몰에서 주문하는 것과 비슷해요. 주소창에 주소를 입력하거나 링크를 누르면, 브라우저가 가장 가까운 센터에 “이 페이지 보내 주세요” 하고 주문을 넣어요. 센터는 그 순간 진열돼 있는 버전을 보내 줘요. 다행히 이 주문은 공짜고, 다음 날 배송보다 훨씬 빨라서 대개 1~2초면 도착해요.
중요한 건 주문이 한 번이라는 점이에요. 받은 뒤에는 브라우저가 새 버전이 나왔는지 다시 묻지 않아요. 지난주에 산 상품의 개선판이 나왔다고 쇼핑몰이 우리 집 물건을 몰래 바꿔 주지는 않잖아요.
그래서 새로고침은 같은 상품을 다시 주문하는 일이에요. 다시 주문하면 그 순간 진열된 버전이 와요. “배포했으니 새로고침해 보세요”는 “새 버전을 진열했으니 다시 주문해 보세요”라는 뜻이에요.
두 쪽이 엇갈릴 때
진열과 주문은 서로 따로 일어나요. 개발자가 언제 진열하든, 내 화면은 내가 마지막으로 주문한 때의 버전이에요. “배포 끝났어요”라는 말을 듣고도 화면이 그대로라면, 대부분 그 화면을 배포 전부터 열어 두고 있었던 거예요.
직접 해 보는 게 가장 빨라요. 개발자가 화면의 오타를 고쳐서 배포하는 상황이에요. 배포하기를 누른 뒤 두 화면을 새로고침하기 전과 후를 비교해 보세요. 배포가 끝나기 전에 새로고침해 보는 것도 잊지 마세요. 배포가 끝난 뒤 새로고침한 화면만 “무료 배숑”이 “무료 배송”으로 바뀌고, 배포가 끝나기 전에 새로고침한 화면은 아직 오타 그대로예요.
- 검수
- 포장
- 운반
새로고침을 했는데도 그대로라면 이유는 대개 둘 중 하나예요. 아직 진열이 다 끝나지 않았거나, 새 버전을 일부 사용자에게만 먼저 보여 주고 있는 경우예요. 새 배송 서비스를 전국에 한 번에 열지 않고 지역을 조금씩 넓히듯, 큰 서비스는 문제가 생겨도 피해가 작도록 사용자를 나눠서 차례로 바꾸기도 해요. 이걸 단계적 배포라고 해요. 데모에서 단계적 배포를 켜고 다시 배포해 보면, 동료 화면만 먼저 바뀌는 걸 볼 수 있어요. 그다음 “모두에게 공개”를 누르면, 내 화면도 새로고침했을 때 새 버전을 받아요. 동료 화면에서는 바뀌었는데 내 화면만 그대로라면 대부분 이 경우예요.
이럴 땐 개발자에게 어느 화면을 언제 봤는지 알려 주세요. 원인을 훨씬 빨리 찾을 수 있어요.
정리
- 웹사이트에는 진열하는 쪽(배포)과 주문하는 쪽(주소 입력, 새로고침)이 있어요.
- 배포는 검수, 포장, 운반을 거치느라 몇 분씩 걸려요.
- 열어 둔 화면은 예전에 주문한 물건이에요. 안 보이면 새로고침으로 다시 주문해 보고, 그래도 그대로면 언제 어느 화면을 봤는지 개발자에게 알려 주세요.
더 알아보려면
- 브라우저 캐시 (browser cache) — 다시 주문했는데 집에 쟁여 둔 예전 재고가 나오는 드문 경우가 왜 생기는지
- CDN (content delivery network) — 전국 센터에 미리 쌓아 두는 일을 웹에서는 어떻게 하는지
- 기능 플래그 (feature flag) — 진열은 끝났는데 판매 시작 버튼만 꺼 둔 상태. “배포는 했는데 아직 안 켰어요”가 무슨 뜻인지 풀려요
- 롤백 (rollback) — 문제가 생긴 배포를 되돌리는 법. “완전한 롤백은 어렵다”는 말이 왜 나오는지도
- CI/CD — 검수, 포장, 운반을 사람 손 없이 자동으로 이어 붙이는 방법