Technote

개발 워크플로우 실무

연재 깨지지 않는 업데이트 루틴 8부 중 4부

스테이징에서 먼저 올려 보는 30분

스테이징은 개발자만 쓰는 장치가 아닙니다. 프로덕션에서 복구하는 데 드는 하루와 스테이징에서 확인하는 30분을 비교하면, 이것은 취향이 아니라 계산입니다.

스테이징(staging)은 프로덕션과 같은 구성으로 만들어 둔 복제 사이트입니다. 방문자는 오지 않고, 여기서 무엇이 깨져도 매출이나 문의가 사라지지 않습니다. 업데이트를 여기서 먼저 해 보는 것이 이번 회차의 전부입니다.

많은 운영자가 이것을 “규모가 커지면 하는 일” 로 미룹니다. 그런데 규모가 작을수록 복구 인력도 없습니다. 혼자 운영하는 사이트에서 프로덕션이 깨지면 그날 하루가 통째로 복구에 들어가고, 그동안 사이트는 닫혀 있습니다.

계산이 단순합니다

같은 업데이트, 다른 무대 — 무대가 결과의 성격을 바꾼다

중요한 것은 스테이징이 깨지지 않게 해 주는 장치가 아니라는 점입니다. 스테이징에서도 똑같이 깨집니다. 다른 것은 깨졌을 때의 비용이고, 그 비용이 0에 가까우면 우리는 훨씬 대담하게 확인하고 훨씬 정확하게 원인을 찾습니다.

스테이징 만들기 — 세 가지 방법

거창하게 만들 필요가 없습니다. 목적은 업데이트가 어떻게 동작하는지 미리 보는 것이므로, 구성이 프로덕션과 비슷하기만 하면 충분합니다.

스테이징을 만드는 방법 — 위에서부터 시도한다

서브도메인 방식을 쓴다면 검색엔진 색인 차단을 반드시 켭니다. 복제 사이트가 색인되면 원본과 중복 콘텐츠가 되어 검색 노출에 손해가 납니다. 접근 자체를 비밀번호로 막는 것이 가장 확실합니다.

로컬 환경은 편하지만 서버 설정(PHP 버전 · 캐시 · 확장 모듈)이 프로덕션과 다를 수 있습니다. 그 차이가 있는 채로 “괜찮았는데” 라고 판단하면 스테이징의 의미가 절반으로 줄어듭니다. 가능하면 같은 PHP 버전만이라도 맞춰 두세요.

30분 안에 무엇을 보나

절차는 네 단계입니다 — 복제 → 업데이트 → 핵심 화면 확인 → 로그 확인. 앞의 두 단계는 기계가 하고, 실제 검증은 뒤의 두 단계에서 일어납니다.

복제본을 최신 상태로 맞추고, 프로덕션에서 하려던 업데이트를 그대로 순서대로 진행합니다. 그리고 이 사이트에서 돈이 되는 화면을 직접 열어 봅니다 — 문의 폼을 실제로 제출해 보고, 결제가 있다면 결제까지 가 보고, 로그인해 봅니다. 관리자 대시보드가 초록색인 것은 확인이 아닙니다.

마지막으로 에러 로그를 봅니다. 화면은 멀쩡해도 로그에 새 경고가 늘었다면, 그것은 다음 버전에서 깨질 예정이라는 뜻입니다.

스테이징에서 프로덕션으로 옮기는 배포 방식은 개발 워크플로우 아카이브에서 다루고, 스테이징 구성을 포함한 재현 가능한 배포 환경 자체를 맡기고 싶다면 최적화 지원 사업에 Docker 기반 구성이 포함됩니다.

다음 회차

모든 업데이트를 이렇게 다룰 수는 없습니다. 다음 회차는 무엇을 자동에 맡기고 무엇을 손으로 할지 — 판단 기준은 되돌림 비용입니다.

이 주제의 다른 글

노하우 목록으로

개발 워크플로우 실무

예외는 QA 가 아니라 명세에서 다룹니다

빈 상태 · 실패 · 권한 없음 · 아주 긴 값. 구현이 의도에서 갈라지는 자리는 거의 항상 이 넷 중 하나이고, 넷 다 명세에서 한 줄이면 끝나는 것들입니다.

기획자 3분 읽기

개발 워크플로우 실무

자주 울리는 알림은 결국 꺼집니다

알림을 무시하기 시작하면 그 감시는 이미 고장 난 것입니다. 게다가 꺼진 알림은 없는 알림보다 나쁩니다 — 지켜지고 있다는 착각을 남기기 때문입니다.

운영 · 관리자 4분 읽기

개발 워크플로우 실무

도메인 치환 — SQL 한 줄이 설정을 지웁니다

데이터베이스 안의 옛 주소를 SQL 로 바꾸면 위젯과 테마 설정이 조용히 빈 값이 됩니다. 직렬화가 문자열 길이를 함께 저장하기 때문입니다.

운영 · 관리자 4분 읽기

₩270,000 · 신청하기