판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개

판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개 1

이미 결제가 돌고 있는 서비스를 리뉴얼할 때 제일 먼저 적어야 할 목록은 새로 만들 기능이 아니라 바꾸지 않을 것입니다. 그리고 그게 안 바뀌었다는 사실을 사람 눈이 아니라 기계가 판정하게 만들어야 합니다. AI로 만드는 속도가 빨라진 1인 사업에서 병목은 만드는 능력이 아니라, 이미 돈이 들어오고 있는 것을 안 깨뜨리는 능력이기 때문입니다.

저는 전자책 한 권을 팔던 사이트에 두 번째 책과 웹소설 연재를 얹었습니다. 파는 걸 멈출 수는 없었습니다. 구매자가 이미 읽고 있었고 결제 버튼이 붙어 있었으니까요. 그때 실제로 쓴 안전장치 네 가지를 정리해 보겠습니다. 작업 전체의 기록은 판매 중인 사이트를 안 멈추고 다시 지은 일지에 따로 남겨 두었습니다.

리뉴얼은 왜 안 바꿀 것의 목록에서 시작해야 할까요?

판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개 2

리뉴얼에서 제일 위험한 문장은 어차피 바꾸는 김에입니다. 손대는 범위가 조용히 넓어지고, 어디까지가 원래 동작이었는지 아무도 기억하지 못하게 됩니다. 그래서 저는 순서를 뒤집었습니다. 바꾸지 않을 것을 먼저 적고, 그게 안 바뀌었다는 걸 증명할 자를 먼저 만들었습니다.

방법은 단순합니다. 작업을 시작하기 전에 지금 사이트가 내려주는 응답을 파일로 떠 놓았습니다. 익명 방문자 상태, 구매자 상태, 한국어, 영어까지 다섯 가지입니다. 이후 코드를 고칠 때마다 이 다섯 개와 비교했습니다. 중요한 건 판정 기준입니다. 비슷하다가 아니라 바이트가 같다로 잡았습니다. 사람 눈은 비슷한 걸 같다고 착각하지만 파일 비교는 그러지 않습니다.

결과적으로 작업이 끝날 때까지 다섯 개 전부 동일했습니다. 기존 책 34챕터는 글자 하나 바뀌지 않았고 가격도 할인 뱃지도 결제 버튼도 그대로입니다. 이 스냅샷이 없었다면 저는 매 커밋마다 사이트를 눈으로 훑으면서 괜찮아 보인다고 자기 위안을 했을 겁니다.

화면보다 먼저 깨지는 것은 왜 잠금장치일까요?

판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개 3

작품이 하나뿐일 때 잠금해제 토큰에는 샀다와 안 샀다만 있으면 됩니다. 실제로 제 토큰에는 상품 정보가 없었고 유효기간만 들어 있었습니다. 여기에 두 번째 유료 작품을 그냥 얹으면 어떻게 될까요. 첫 책을 산 사람이 신간을 공짜로 읽게 됩니다. 화면을 아무리 예쁘게 다시 만들어도 이건 안 고쳐집니다.

그래서 토큰에 어떤 작품을 샀는가를 넣되, 이미 발급된 토큰은 절대 무효화하지 않기로 했습니다. 규칙은 한 줄입니다. 작품 목록이 없는 옛날 토큰은 첫 책의 전권으로 인정한다. 기존 구매자는 아무것도 하지 않아도 어제와 똑같이 읽습니다.

이건 제가 발명한 요령이 아니라 이름이 붙어 있는 패턴입니다. 마틴 파울러가 정리한 병렬 변경 패턴은 인터페이스를 바꿀 때 확장, 이전, 축소의 세 단계로 쪼개라고 말합니다. 옛 버전과 새 버전을 동시에 지원하는 확장 단계를 먼저 두면, 사용자를 한 번에 옮기지 않아도 되고 각 단계에서 언제든 배포할 수 있습니다. 1인 운영자에게 이 패턴이 중요한 이유는 따로 있습니다. 사용자에게 지금 로그아웃 후 다시 로그인해 주세요라고 공지할 창구가 없기 때문입니다.

한 가지 더 정한 규칙이 있습니다. 상품 매핑이 빠졌을 때는 항상 안전한 쪽으로 틀리게 만들었습니다. 등록되지 않은 상품 번호가 들어오면 첫 책으로 떨어집니다. 제가 실수해서 기존 구매자가 잠기는 사고는 구조적으로 일어나지 않습니다. 틀릴 수 있다는 걸 전제로 틀리는 방향을 정해 두는 편이, 틀리지 않겠다고 다짐하는 것보다 훨씬 잘 작동합니다.

로컬에서는 되는데 배포하면 404가 나는 이유는 무엇일까요?

판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개 4

여기부터가 이 글에서 제일 쓸모 있는 부분일 겁니다. 푸시하고 확인하러 들어갔더니 본문을 내려주는 주소가 모든 작품에 대해 404를 뱉고 있었습니다. 구매자의 리더가 동작하지 않는 상태였습니다.

원인은 한 줄이었습니다. 작품 데이터를 필요할 때만 읽으려고 파일 경로를 계산해서 불러오게 했는데, 배포 환경의 번들러는 코드를 정적으로 분석해서 필요한 파일을 골라 담습니다. 경로를 계산하는 방식은 추적이 안 되니 본문 데이터가 아예 안 실렸던 겁니다. 이건 버그라기보다 규격입니다. webpack 공식 문서는 완전히 동적인 경로는 쓸 수 없다고 못박아 두었습니다. 경로에 최소한의 고정된 정보가 있어야 번들러가 어떤 파일을 담을지 정할 수 있다는 뜻입니다.

문제는 이 사고가 로컬에서 재현되지 않았다는 것입니다. 로컬 서버는 파일 시스템을 그대로 읽으니까요. 로컬 검증만으로는 절대 못 잡는 종류입니다. 저는 경로를 고정 문자열로 되돌리는 핫픽스를 바로 올려 복구했고, 같은 계열을 다시 놓치지 않으려고 배포 후에 실제 서비스 주소를 두드려 보는 점검 스크립트를 만들었습니다. 페이지가 열리는지, 본문이 실제로 내려오는지, 가격과 결제 버튼이 살아 있는지를 확인합니다.

이 대목은 개인의 부주의로 넘길 문제가 아닙니다. 구글 클라우드가 2025년 9월 24일 공개한 DORA 리포트는 전 세계 기술 실무자 약 5,000명을 조사해, 응답자의 90퍼센트가 업무에 AI를 쓰고 있으며 AI 도입이 처리량과는 긍정적 관계지만 배포 안정성과는 여전히 부정적 관계에 있다고 정리했습니다. 리포트는 그 이유를 이렇게 설명합니다. AI는 개발을 가속하는데 그 가속이 하류의 약점을 드러내며, 자동화된 테스트와 빠른 피드백 루프 같은 통제 장치가 없으면 변경량 증가가 그대로 불안정으로 이어진다는 것입니다. 리뷰어가 없는 1인 회사에서는 이 경고가 몇 배로 옵니다.

원고를 옮길 때 조용히 사라지는 것은 무엇일까요?

판매 중인 서비스를 안 멈추고 다시 짓는 법 — 무중단 리뉴얼 안전장치 4개 5

두 번째 책은 워드 파일로 있었습니다. 87메가바이트, 본문 2,379문단에 이미지 238장이었습니다. 그대로 올리면 이미지만 79.9메가바이트라 폭을 1,200픽셀로 줄이고 WebP로 바꿔 8.7메가바이트로 만들었습니다.

여기서 배운 게 하나 있습니다. 변환기는 실패해도 성공했다고 보고합니다. 처음 만든 변환기는 워드가 문단 안에 따로 저장하는 줄바꿈을 통째로 버리고 있었습니다. 오류 하나 없이 잘 끝났고, 결과물에서는 문장들이 서로 붙어 있었습니다. 285곳을 복원했습니다. 중간에 끝이 잘린 JPEG 두 장은 변환을 막았는데, 버리지 않고 있는 데까지 읽어서 살렸습니다.

번역본에서도 같은 종류의 조용한 손실이 나왔습니다. 웹소설을 한국어로 쓰고 영어, 일본어, 중국어로 옮겼는데, 중국어에서 대사 인용부호를 ASCII 따옴표로 써 둔 걸 뒤늦게 찾았습니다. 간체 중문 조판에서는 다른 부호를 씁니다. 282쌍을 전부 바꿨고, 등장인물 한 명의 한자 표기도 바꿨습니다. 제가 고른 글자가 중국 독자에게는 특정 인물의 성씨로 읽혀서 작품과 상관없는 잡음을 만들 수 있었습니다.

그래서 회차 중간에 들어가는 티저 영상은 위치를 한국어 원문에서 한 번만 확정하고 번역본이 그 자리를 물려받게 했습니다. 대신 조건을 하나 걸었습니다. 번역본의 문단 수가 원문과 다르면 빌드를 실패시킵니다. 번역하다 문단을 합치거나 나누면 영상이 엉뚱한 데 붙는데, 그걸 사람 눈이 아니라 빌드가 막습니다. 정리하면 이렇습니다. 눈으로 검수하지 말고 개수를 세게 하십시오.

안전장치무엇을 고정했나무엇을 막았나
응답 스냅샷 5종익명·구매자·한국어·영어 응답을 바이트 단위로어차피 바꾸는 김에로 번지는 범위 확대
하위호환 토큰 규칙옛 토큰은 첫 책 전권으로 인정기존 구매자가 재로그인 없이 잠기는 사고
안전한 방향의 폴백미등록 상품 번호는 첫 책으로 강등매핑 누락이 곧바로 접근 차단이 되는 것
배포 후 실주소 점검페이지·본문·가격·결제 버튼 응답로컬에서 재현 안 되는 배포 전용 장애

이 방식의 한계는 무엇일까요?

먼저 응답 스냅샷은 만능이 아닙니다. 제 사이트는 같은 입력에 같은 출력을 내주는 정적 성격이 강해서 바이트 비교가 성립했습니다. 추천 목록이나 실시간 재고처럼 매번 값이 달라지는 화면에는 그대로 못 씁니다. 그 경우에는 변하지 않아야 할 항목만 골라 비교하는 식으로 범위를 좁혀야 합니다.

배포 후 점검도 한계가 분명합니다. 제 스크립트는 결제 버튼이 살아 있는지까지만 봅니다. 실제 카드 승인이 떨어지는지는 확인하지 않습니다. 결제 대행사의 테스트 결제까지 자동화하지 않는 한, 이 구간은 여전히 사람이 주기적으로 눌러 봐야 하는 영역으로 남습니다.

하위호환 규칙은 부채라는 점도 적어 둡니다. 옛 토큰을 영원히 받아 주기로 한 순간, 코드에는 언젠가 지워야 할 분기가 하나 생깁니다. 병렬 변경 패턴이 축소 단계를 명시해 둔 이유가 여기에 있습니다. 저는 옛 토큰의 유효기간이 전부 지나는 시점을 축소 시점으로 적어 두었습니다. 적어 두지 않으면 그 분기는 5년 뒤에도 남아 있습니다.

마지막으로 이 절차 전체는 규모가 작아서 가능했습니다. 사용자 데이터베이스를 옮기거나 결제 스키마를 바꾸는 리뉴얼이라면 스냅샷 다섯 개로는 어림도 없습니다. 다만 순서는 규모와 무관하게 같습니다. 바꾸지 않을 것을 먼저 적고, 그것이 안 바뀌었다는 걸 기계가 판정하게 하고, 틀릴 방향을 미리 정하고, 배포된 실물을 두드려 보는 것입니다.

비개발자가 AI로 무언가를 만드는 단계는 이제 어렵지 않습니다. 어려운 건 만든 것을 계속 살려 두는 쪽입니다. 만드는 과정 자체가 궁금하시다면 클로드 코드로 홈페이지를 0원에 리뉴얼한 기록도 함께 보시면 좋겠습니다.

댓글

이 블로그의 인기 게시물

AI 에이전트 팀으로 1인 사업 자동화하기 (2026 실전 가이드)

MBTI 검사 그만하고 클로드한테 물어봐 — AI로 '진짜 내 성향' 진단받는 법

무료 AI 영상 툴 7개, 같은 프롬프트로 직접 돌려봤습니다 — 크레딧·워터마크·사운드 실측표