From b4ae4c1ed3f618b67b5f660ccb1511dacc860f55 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Wed, 4 Nov 2026 20:27:30 +0900 Subject: [PATCH] =?UTF-8?q?docs(operations):=20waiting=20=EA=B8=B0?= =?UTF-8?q?=EA=B0=84=EC=97=90=20=EC=86=8C=EC=9C=A0=20=EC=BA=90=EC=8B=9C?= =?UTF-8?q?=EA=B0=80=20=EC=8C=93=EC=9D=B4=EB=8A=94=20=EA=B2=83=EA=B3=BC=20?= =?UTF-8?q?=EC=A0=95=EB=A6=AC=20=EC=8B=9C=EC=A0=90=EC=9D=84=20=EC=A0=81?= =?UTF-8?q?=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 캐시를 지우는 곳은 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 --- docs/operations/browser-file-storage-recovery.md | 13 +++++++++++++ docs/operations/release-cache-rollback.md | 6 +++++- 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/operations/browser-file-storage-recovery.md b/docs/operations/browser-file-storage-recovery.md index 28243706..afe09ffb 100644 --- a/docs/operations/browser-file-storage-recovery.md +++ b/docs/operations/browser-file-storage-recovery.md @@ -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의 diff --git a/docs/operations/release-cache-rollback.md b/docs/operations/release-cache-rollback.md index d3661342..1f374cd2 100644 --- a/docs/operations/release-cache-rollback.md +++ b/docs/operations/release-cache-rollback.md @@ -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