docs(operations): waiting 기간에 소유 캐시가 쌓이는 것과 정리 시점을 적는다

문제
캐시를 지우는 곳은 activate 하나다(현재 + 마커가 가장 높은 직전 1개).
템플릿은 requestActivation()을 부르지 않으므로 활성화는 그 scope의
탭이 모두 닫혀야 일어난다. 그 사이 release마다 새 후보가 waiting
워커를 밀어내지만 밀려난 캐시는 남는다(리뷰 실험 L2: A 활성 + 탭
유지에서 B, C를 받으면 소유 캐시 3개, 활성화 뒤 2개). 운영 문서는
"현재 + 직전 1개"만 말해 waiting 기간의 캐시 수가 보이지 않는다.

고른 방법
- 리뷰 5.1 판단대로 (a) 문서만 고친다. SW runbook 8절에 쌓이는 규칙,
  예, 크기 상한, 쿼터에 닿았을 때의 결과, 줄이는 방법
  (requestActivation 화면)과 install이 지우지 않는 이유를 적는다.
  release-cache-rollback.md SW 1단계에 한 문장과 링크를 둔다.
- 버린 대안: (b) install 성공 뒤 "무마커 + 이번 후보 아님 + 활성 캐시
  아님"을 지우기. install하는 워커는 활성 캐시 이름을 모르고, 마커
  쓰기에 실패한 활성 캐시는 후보와 구별되지 않는다. (c) 이번 후보를 뺀
  무마커 캐시를 모두 지우기. 그 활성 캐시를 지워 직전 캐시 보존 성질을
  깬다.

위험·한계
- 쌓이는 동작 자체는 그대로다. 사전 캐시가 1 MiB를 넘고 release가 잦아
  지면 (b)를 다시 본다(리뷰 재검토 조건).
- 브라우저 종료로 활성화되는지는 확인하지 않았다.

검증
- 문서와 코드(service-worker-lifecycle.ts onActivate,
  service-worker-static-assets.ts QUOTA_EXCEEDED, service-worker.ts
  assetSetBytes)를 대조했다.

Refs: docs/reviews/2026-11-03-maturity-review/06-adapters-service-worker-push.md 06-04
This commit is contained in:
DongHyeonka
2026-11-04 20:27:30 +09:00
parent 7144653109
commit b4ae4c1ed3
2 changed files with 18 additions and 1 deletions
@@ -592,6 +592,19 @@ Service Worker를 별도 선택한 조합에서만 추가. 워커의 fetch 가
부르는 화면이 없으므로 기본 경로는 뒤쪽이다. 따라서 결함 있는 워커가 waiting에
있으면 탭을 모두 닫았다 다시 연 사용자부터 그 워커를 쓴다. 기다리지 말고 다음
release로 교체하거나 `REMOVE_REGISTRATION` release를 배포한다.
- 활성화를 기다리는 동안 소유 캐시는 release 수만큼 쌓인다. 캐시를 지우는 곳은
activate 하나이고, 현재 캐시와 마커가 가장 높은 직전 캐시 1개만 남긴다
(`service-worker-lifecycle.ts` `onActivate`). 새 release가 waiting 워커를
밀어내도 밀려난 워커의 후보 캐시는 지우지 않는다. 예: 탭 하나를 연 채 A 활성
상태에서 B, C를 받으면 소유 캐시는 A·B·C 3개다. 탭을 모두 닫아 C가 활성화되면
C·A 2개로 줄어든다(리뷰 1103/06-04 실험 L2, chromium·webkit). 캐시 하나는
사전 캐시 크기(상한 5 MiB, `src/contracts/service-worker.ts`)다. origin 쿼터에
닿으면 다음 install이 `QUOTA_EXCEEDED`로 실패하고, 저장소가 부족하면 브라우저가
origin 저장소 전체(IndexedDB·OPFS 포함)를 지울 수 있다. 사용자가 탭을 오래
열어 두고 release가 잦은 제품은 `requestActivation()`을 부르는 화면을 붙여
waiting 기간을 줄인다. install이 밀려난 캐시를 지우지 않는 이유: install하는
워커는 활성 워커의 캐시 이름을 모르고, 마커 쓰기에 실패한 활성 캐시는 마커가
없어 후보와 구별되지 않는다.
- 제거는 `ACTIVE → REMOVE_REGISTRATION → PURGE_OWNED_RESOURCES → null` 순서로
release를 나눈다(`src/contracts/service-worker.ts`
`InstalledServiceWorkerSelection`). 소유 캐시는 `PURGE_OWNED_RESOURCES` release의
+5 -1
View File
@@ -181,7 +181,11 @@ same build as the HTML and assets it caches.
name is the asset-set digest, so if N's cache is still there as the
retained previous cache, the install reuses it and never deletes it on
failure (`service-worker-static-assets.ts` `installStaticAssets`). Tabs still on N+1 keep worker N+1, so N+1's assets
stay reachable for the rolling window above.
stay reachable for the rolling window above. Only activation deletes owned
caches (current plus the highest-marked previous one). While a worker
waits, every release that replaces the waiting worker leaves its cache
behind, so a scope holds one precache per release until its tabs close
(review 1103/06-04; `docs/operations/browser-file-storage-recovery.md` §8).
2. **Turn the worker off without a rebuild.** Set
`CAPABILITY_OVERRIDES.SERVICE_WORKER: "DISABLED"` in the runtime config. The
next boot unregisters the owned registration and registers nothing; owned