docs: диагноз разового DNS-сбоя pull (gaierror -5) — единичная ошибка, работает

History/infra/2026-08-24-pull-dns-transient.md

@@ -0,0 +1,28 @@
+# Разовый DNS-сбой pull: «Pull failed: [Errno -5] No address associated with hostname» (2026-08-24)
+
+_infra. Вопрос пользователя «ЭТО ЧТО ????» при загрузке папки CNC (220 файлов, отобрано 8)._
+
+## Симптом
+Фронт: «Ошибка передачи ссылок: Pull failed: [Errno -5] No address associated with hostname»
+при нажатии «Обфусцировать».
+
+## Диагностика (факты)
+- ВМ-буфер: `https://contracts.kube5s.ru/drhider-upload/` (nginx dav), host → 5.172.178.213.
+- DNS снаружи (8.8.8.8) и на ВМ: `contracts.kube5s.ru` → 5.172.178.213 — ок; буфер отвечает 403.
+- Под drhider: ns `20a75175-a58c-49cb-b8fa-e86367b1a8dc`, pod `pythonk8s-85d8f4dcc8-vjjts`
+  (создан ~18:36 МСК, редеплой 18:31-18:33). `getent`/`socket` из пода → 5.172.178.213 — ок.
+- Логи пода: ЕДИНСТВЕННАЯ ошибка `upload_refs: pull error sid=66ce16c1cda9` в **15:42:43 UTC (18:42 МСК)**:
+  `connect_tcp.started host='contracts.kube5s.ru'` → `gaierror(-5)`.
+- До неё (15:41:41 UTC / 18:41 МСК) сессия пользователя `3ec718dafa5b` с теми же 8 файлами
+  (info.txt, out1.txt, fatD.pdf, fatihaDownEdited.pdf, fatihaUPEdited.pdf, fatU.pdf, FT0.pdf, sha0.pdf)
+  УСПЕШНО обработана (worker done, 29.8с, tokens 2138).
+- CoreDNS: 2 пода, 0 рестартов, 44d — стабильны.
+- Живой тест сейчас: папка 2 txt → «✅ Обработано 2 файлов: 6.6с» — pull работает.
+
+## Вывод
+**Разовый DNS-сбой** CoreDNS/upstream на `contracts.kube5s.ru` в узкий момент 18:42 МСК
+(одна ошибка за весь лог). К выбору папки отношения нет; повторный запуск работает.
+
+## Рекомендация (опция)
+Добавить ретраи pull в `upload_refs` (2-3 повтора с паузой при `ConnectError`/DNS-ошибке) —
+v0.0.70. Решение за пользователем.