From 4d3bb2113b3384280e4941c938a7c9d9bfb63929 Mon Sep 17 00:00:00 2001
From: vitya <vitya.kuznetsov@gmail.com>
Date: Thu, 13 Aug 2026 12:06:11 +0300
Subject: [PATCH] =?UTF-8?q?meta(wiki):=20runbook=20=E2=80=94=20offline-cac?=
 =?UTF-8?q?he=20fixed=20by=205c583f8=20(supportedArchitectures),=20yarn=20?=
 =?UTF-8?q?install=20replenished=20cache?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .wiki/concepts/stostayer-web-deploy-runbook.md | 2 +-
 .wiki/log.md                                   | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.wiki/concepts/stostayer-web-deploy-runbook.md b/.wiki/concepts/stostayer-web-deploy-runbook.md
index fe12312..5e61e94 100644
--- a/.wiki/concepts/stostayer-web-deploy-runbook.md
+++ b/.wiki/concepts/stostayer-web-deploy-runbook.md
@@ -38,7 +38,7 @@ docker build -f packages/web/Dockerfile -t docker.stostayer.ru/stostayer-web:<ta
 - **`.dockerignore` обязателен** (его нет в репо) — иначе `node_modules`/`.git` улетают в build-контекст. Создать временный: `node_modules **/node_modules .git apps docs build *.zip` и т.п. (на явные `COPY` не влияет).
 - **Локальная `npmAuthToken: "${VERDACCIO_TOKEN}"` в `.yarnrc.yml`** (рабочая модификация, не в коммите) **ломает build**: yarn внутри образа падает `Usage Error: Environment variable not found (VERDACCIO_TOKEN)`. Убрать эту строку из build-копии (потом вернуть).
 - **Offline против `.yarn/cache`:** добавить `enableNetwork: false` в `.yarnrc.yml` — depы пекутся из cache, verdaccio-токен в образе не нужен. (Cache содержит third-party зипы; их версии ESM-миграция не меняла, так что cache от master-tip обычно покрывает и более старые коммиты.)
-- **⚠️ Offline НЕ всегда проходит (2026-08-13, 0.3.23):** в `.yarn/cache` с Windows-хоста НЕТ linux-бинарей `@esbuild/linux-x64` и `@rollup/rollup-linux-x64-gnu` → yarn с `enableNetwork:false` падает, а с сетью — `YN0041 Invalid authentication (as an anonymous user)` (verdaccio требует токен). Рабочий обход: временно вернуть `npmAuthToken: "${VERDACCIO_TOKEN}"` в build-копию `.yarnrc.yml` + временно добавить в `packages/web/Dockerfile` `ARG VERDACCIO_TOKEN` / `ENV VERDACCIO_TOKEN=$VERDACCIO_TOKEN` перед `RUN yarn install`, собрать `docker build --build-arg VERDACCIO_TOKEN="$VERDACCIO_TOKEN"`, после build — `git checkout -- .yarnrc.yml packages/web/Dockerfile`. Альтернатива на будущее: докинуть 2 linux-зипа в `.yarn/cache`.
+- **✅ Offline-кэш ПОЧИНЕН (2026-08-13, коммит `5c583f8`):** в `.yarnrc.yml` добавлен `supportedArchitectures: {cpu:[x64], os:[linux,win32,darwin], libc:[glibc,musl]}` — раньше без `libc` yarn пропускал fetch `@rollup/rollup-linux-x64-gnu` (условие libc=glibc). `.yarn/cache` gitignored → один раз на build-машине прогнать сетевой `yarn install` (с `VERDACCIO_TOKEN`) — yarn дольёт `@esbuild/linux-x64`/`@rollup/rollup-linux-x64-gnu` в локальный кэш, дальше offline (`enableNetwork:false`) работает. Сделано 2026-08-13 на этой машине (зипы в кэше).
 
 ### 2. Push в registry
 
diff --git a/.wiki/log.md b/.wiki/log.md
index 3121ce2..79c0ec6 100644
--- a/.wiki/log.md
+++ b/.wiki/log.md
@@ -1,3 +1,4 @@
+## [2026-08-13] ingest | UPDATE concepts/stostayer-web-deploy-runbook.md — offline-гоча ПОЧИНЕНА их коммитом `5c583f8` (supportedArchitectures libc glibc/musl): сетевой yarn install на build-машине долил linux-зипы в кэш, будущие offline-сборки чисты. Runbook переписан с рецептом. Ack-обмен с stostayer.new (их инбокс `.agents/inbox/`).
 ## [2026-08-13] ingest | UPDATE concepts/stostayer-web-deploy-runbook.md — деплой stostayer-web:0.3.23 на прод www.stostayer.ru (запрос их прогера, письмо inbox). Нюансы зафиксированы: (1) offline-build НЕ проходит — в `.yarn/cache` нет linux-бинарей `@esbuild/linux-x64`/`@rollup/rollup-linux-x64-gnu` → обход через временный `ARG/ENV VERDACCIO_TOKEN` + `--build-arg` (после — revert); (2) Portainer API с хоста — `base=http://<IP>:9000` (порт обязателен); (3) прод-тег в таблице актуализирован 0.3.18→0.3.23; (4) блок деплоя 0.3.23. Task [stostayer-web-deploy-0-3-23] 🟢.
 ## [2026-08-12] implement | UPDATE entities/kreknin-synology.md — автосинк LE-серта: acme-nginx-sync.sh (cron 15 мин) ротирует серт git.kreknin.site из traefik acme.json в nginx DSM автоматически.
 ## [2026-08-12] implement | UPDATE entities/kreknin-synology.md — LE-серт git.kreknin.site (из traefik acme.json) подложен в nginx DSM reverse proxy. Из LAN: валидный LE + Gitea, без DSM-пароля (root SSH).