Huny's Dev Blog
huny.dev

Cloudflare 배포 기록이 남아 있어도 롤백할 수 없는 이유: Workers와 Pages의 30일 보존 정책

Cloudflare Workers와 Pages의 30일·최신 100개 보존 규칙을 비교하고, 롤백 자격과 프리뷰 URL 만료, 데이터 복구를 구분한다.

Hun Jang
Hun Jang Nov 21, 2026

보관된 기록과 되돌릴 수 있는 기록이 일치하지 않는 상황을 표현한 AI 생성 개념 이미지. 실제 관리 화면이 아니다.

배포 목록에 이전 버전이 보인다고 해서 그 버전으로 되돌릴 수 있는 것은 아니다. Cloudflare가 2026년 11월 19일 발표한 Workers·Pages 보존 정책에서 두 제품은 비슷한 삭제 규칙을 적용하지만, 롤백 대상은 다르게 고른다. 예를 들어 아직 20일밖에 지나지 않은 101번째 기록이라도 Workers에선 롤백할 수 없고, Pages에선 성공한 프로덕션 배포라면 가능하다. Cloudflare 공식 공지

30일은 보존 규칙이지 롤백 기간이 아니다

Workers에서는 생성된 지 30일이 지난 버전이 해당 Worker의 최신 100개에 들지 않고 현재 트래픽도 처리하지 않을 때 삭제된다. 최신 100개는 오래됐어도 남는다. 최신 100개 밖이더라도 현재 트래픽의 일부를 처리한다면 보존되므로, 점진 배포 중인 두 버전 모두 이 예외에 해당한다. 코드뿐 아니라 설정이나 시크릿 변경도 새 버전을 만들 수 있다. Workers 버전 보존 문서

하지만 Workers의 롤백 대상으로 지정할 수 있는 것은 가장 최근에 발행된 100개 버전이다. 20일 된 101번째가 삭제되지 않았더라도 100개 범위 밖인 것은 변하지 않는다. 반대로 45일 된 70번째는 개수 기준으로 남지만, 실제 롤백이 가능한지는 연결 리소스 조건도 확인해야 한다. Workers 롤백 제한

Pages에서는 생성된 지 30일이 지난 배포가 해당 프로젝트의 최신 100개에 들지 않고 현재 프로덕션 배포도 아닐 때 삭제된다. 최신 100개는 프로덕션과 프리뷰 배포를 함께 센다. Pages의 롤백 대상은 성공적으로 빌드됐고 삭제되지 않은 프로덕션 배포이므로, 20일 된 101번째 프로덕션 배포도 이 조건을 충족하면 돌아갈 수 있다. 같은 순위에 있는 프리뷰 배포는 목록에 남아도 롤백 대상이 아니다. Pages 보존 · Pages 롤백

프리뷰 주소가 열리는 것과 릴리스가 남는 것은 다르다

Workers의 Version URL은 특정 버전에 연결된다. 별칭을 붙였어도 원본 버전이 삭제되면 주소가 동작하지 않는다. 게다가 Version URL은 프로덕션 바인딩을 사용하므로 별칭만으로 데이터나 권한이 격리됐다고 가정하면 안 된다. 브랜치나 PR의 최신 배포를 보는 목적에는 Cloudflare가 별도 Worker Previews를 권장한다. 공식 공지의 URL 안내

Pages의 해시 URL은 같은 배포를 가리키지만 해당 배포가 삭제되면 끝이다. 반면 브랜치 별칭은 그 브랜치의 최신 배포로 이동한다. 리뷰 링크를 남길 때 그때 본 결과를 다시 보여 줄 주소인지, 지금 최신 결과를 보여 줄 주소인지부터 구분한다. 검토 기록을 장기간 보존하려면 커밋, 산출물 또는 캡처를 URL과 별도로 남긴다. Pages 프리뷰 별칭 문서

코드 롤백 전에 데이터가 돌아오는지 따로 묻는다

Workers의 롤백은 연결된 저장소의 내용을 원래 상태로 돌리지 않는다. 새 코드가 데이터 구조를 바꿨다면 예전 코드가 돌아가도 요청이 실패할 수 있다. 버전 사이에 Durable Object 클래스 생명주기 변경이 있었거나 대상에 필요한 R2 버킷·KV 네임스페이스·큐가 없어졌다면 Cloudflare가 롤백을 막는 경우도 있다. 연결 리소스 및 바인딩 제한

복구 계획에는 다음을 나눠 적는다.

  1. 대상: 마지막으로 정상 동작한 커밋, Worker 버전 ID 또는 Pages 배포 ID, 빌드에 필요한 설정과 잠금 파일을 기록한다.
  1. 자격: Worker면 최신 100개 범위와 리소스 제약을, Pages면 성공한 프로덕션 배포 여부와 보존 상태를 확인한다.
  1. 재배포: 대상이 사라졌을 경우 같은 코드와 설정을 새 버전으로 재현할 수 있는지 별도로 검증한다.
  1. 데이터: 새 스키마에서도 구 코드가 동작하는지 검토하고, 데이터 복구가 필요하면 별도의 백업·복구 절차를 둔다.

여기서 순위·일수는 공식 규칙을 적용한 가상 사례다. 삭제 처리의 정확한 시각은 공지에 명시되지 않았다. 실제 계정에서 배포 상태를 조회하거나 롤백을 실행하지 않았으며, 배포 기록은 장기 백업을 대체하지 않는다.

추천 글