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:
@@ -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의
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user