byrsapty
ed8fc831bf
Один коміт, а не десяток тематичних, свідомо: теми переплетені в
спільних файлах (store.go, docker-compose.yml, deploy/README.md), і
розділити їх можна було б лише індексуванням шматків. Коміти, які не
збираються, гірші за один великий — тим паче що це рівно той стан, який
перевірявся разом.
ЩО ПРАЦЮЄ НА СТЕНДІ Й ПЕРЕВІРЕНО ТАМ
0058 подієві алерти: syslog, ncm, compliance спрацьовують у мить
події; правило з нереалізованим джерелом більше не зберігається
мовчки
0059 snmp.walk і прототипи шаблонів — таблиці з динамічним індексом
описуються шаблоном, а не Go
0060 відкат конфігу: план як різниця, маскування паролів із підписом
плану, обов'язковий контрольний збір, verifying при обриві
0061 кнопки Telegram: довге опитування, авторизація не з callback_data
0062 аудит і архів хостів; тест на AST, що падає на ключі без назви
0063 RLS: три ролі, окремий пул для фонових тактів
0064 строки зберігання даних і сторінка сховища
0065 приймач SNMP-трапів; перевірено справжніми пакетами по дроту,
переклад v1→v2 за RFC 3584 дає правильний OID
0066 ескалації сповіщень
0067 алерт про вичерпання диска
0068 поля заливки конфігу переїхали в каталог профілів
Плюс: 137 тестів вебу з нуля (їх не було взагалі), одинадцять справжніх
вад, знайдених ними й виправлених, і виправлення двох інтеграційних
тестів grpcapi, які мовчки пропускались півтора року.
ЩО ЩЕ НЕ ЗАПУСКАЛОСЬ
netpulse установник: одна команда замість 18 змінних і
593 рядків інструкції
RLS з першого запуску нова інсталяція під політиками одразу;
RLS-EXISTING-INSTALL.md лишається тільки для
старих інсталяцій
.forgejo + CI раннер не зареєстрований
Ці три перевірені компіляцією й міркуванням, але не виконанням.
ГОЛОВНИЙ ВИСНОВОК ДВОХ СЕСІЙ
Зелена перевірка доводить рівно те, що вона перевіряє. Тест ізоляції RLS
був правильний і зелений — і пропустив зламаний вхід, бо перевіряв «чи
не видно чужого», коли зламалось «чи видно своє». Інтеграційні тести
grpcapi були зелені, бо не виконувались. Схема, довідник і протокол
описували те, чого в коді не існувало, і виглядало це як готове.
Тому в кожному завданні цих сесій стояла вимога назвати НЕПОКРИТЕ, а
чотири задачі закінчились не можливістю, а відмовою: правило з
нереалізованим джерелом не зберігається, профіль без команд заливки
каже про це замість мовчазної кнопки, міграція RLS валить сама себе на
таблиці без політики, тест словника аудиту падає на ключі без назви.
Подробиці — HISTORY.md, розділи за 26 і 27 серпня.
123 lines
8.6 KiB
Text
123 lines
8.6 KiB
Text
# NetPulse — файл відповідей.
|
||
#
|
||
# Тут лежить рівно те, чого установник не може вирішити за вас: п'ять
|
||
# значень. Решта — секрети, які людині не можна давати вводити руками
|
||
# (секрет, який пропонують придумати, виявляється admin123), і
|
||
# налаштування, у яких є одне правильне значення або значення, що
|
||
# рахується з машини.
|
||
#
|
||
# Файл НЕ обов'язковий. `./netpulse install` без нього ставить робочу
|
||
# систему на самопідписаному сертифікаті, без прийому трапів ззовні, з
|
||
# помірними строками зберігання й поясом хоста. Кожен рядок нижче
|
||
# каже, що буде, якщо його не чіпати.
|
||
#
|
||
# cp netpulse.conf.example netpulse.conf
|
||
# ./netpulse install
|
||
#
|
||
# Синтаксис: КЛЮЧ=значення, без лапок, без пробілів навколо «=».
|
||
|
||
|
||
# ---------------------------------------------------------------------
|
||
# DOMAIN — доменне ім'я, на яке дивиться A-запис цього сервера.
|
||
# ---------------------------------------------------------------------
|
||
#
|
||
# Це рішення людини, бо ані сервер, ані установник не знають, що написано
|
||
# в чужій зоні DNS. Перевірити «чи веде домен сюди» до першого запуску
|
||
# теж не можна: запис міг з'явитись хвилину тому й ще не розійтися.
|
||
#
|
||
# ПОРОЖНЬО: адресою системи стає IP цієї машини, а сертифікат —
|
||
# самопідписаний. Працює одразу, але браузер щоразу лається, і зонди
|
||
# доводиться запускати з -insecure. Let's Encrypt тут ні до чого: він не
|
||
# видає сертифікатів на IP-адреси взагалі, тому «залишити порожнім і
|
||
# сподіватись на справжній сертифікат» неможливо за побудовою.
|
||
#
|
||
# Домен можна вписати пізніше: змінити рядок і повторити
|
||
# `./netpulse install` — переустановлення нічого не ламає.
|
||
DOMAIN=
|
||
|
||
# ---------------------------------------------------------------------
|
||
# ADMIN_EMAIL — пошта для Let's Encrypt.
|
||
# ---------------------------------------------------------------------
|
||
#
|
||
# На неї приходить лист, коли продовження сертифіката ламається. Це
|
||
# єдиний канал, яким про це дізнаються ДО того, як сайт перестане
|
||
# відкриватись, — тому адреса має бути та, яку читають, а не та, що
|
||
# гарно виглядає.
|
||
#
|
||
# ПОРОЖНЬО при заданому DOMAIN: сертифікат усе одно береться, але
|
||
# попередження про проблеми з продовженням нікуди не піде.
|
||
#
|
||
# Без DOMAIN не потрібна зовсім: сертифікат самопідписаний, продовжувати
|
||
# нічого й нікому скаржитись.
|
||
ADMIN_EMAIL=
|
||
|
||
# ---------------------------------------------------------------------
|
||
# TRAPS_FROM — від кого приймати SNMP-трапи (порт 162/udp).
|
||
# ---------------------------------------------------------------------
|
||
#
|
||
# Це рішення, а не налаштування: 162/udp не має автентифікації взагалі.
|
||
# Хто знає адресу — той шле, і система це запише. На машині з публічним
|
||
# інтерфейсом «слухати всюди» означає віддати чужим людям право
|
||
# наповнювати вашу базу подіями.
|
||
#
|
||
# ПОРОЖНЬО: трапи слухаються лише на 127.0.0.1. Ззовні не приймається
|
||
# нічого. Решта моніторингу (ICMP, SNMP-опитування, збір конфігів) від
|
||
# цього не залежить — зонди самі ходять до заліза.
|
||
#
|
||
# АДРЕСА цієї машини (наприклад 10.0.0.5): порт піднімається лише на
|
||
# цьому інтерфейсі. Найдешевший спосіб пустити трапи з внутрішньої
|
||
# мережі й не пустити з інтернету — якщо інтерфейси різні.
|
||
#
|
||
# ПІДМЕРЕЖА (наприклад 10.0.0.0/24) або чужа адреса: порт піднімається
|
||
# на всіх інтерфейсах, а джерело обмежується правилом у ланцюжку
|
||
# DOCKER-USER. Потребує iptables на хості; якщо його немає, установник
|
||
# ЗУПИНИТЬСЯ, а не відкриє порт усім мовчки. Правило не переживає
|
||
# перезавантаження саме собою — установник скаже, що з цим робити.
|
||
#
|
||
# any: слухати всюди, приймати від будь-кого. Установник це зробить і
|
||
# гучно скаже, що саме ви щойно дозволили.
|
||
TRAPS_FROM=
|
||
|
||
# ---------------------------------------------------------------------
|
||
# RETENTION — скільки тримати дані.
|
||
# ---------------------------------------------------------------------
|
||
#
|
||
# Рішення організації, а не властивість збірки: «ми маємо бачити
|
||
# півроку» — це вимога до вас, а не до продукту. Установник не має права
|
||
# вгадати її, бо помилка в один бік коштує диска, а в другий — історії,
|
||
# заради якої систему й ставили.
|
||
#
|
||
# Строк — рівня інсталяції, не кабінету: TimescaleDB видаляє дані цілими
|
||
# чанками, а чанк ріжеться за часом і про кабінет не знає нічого
|
||
# (пояснення — у міграції 0064). Розкладку профілю по видах даних видно
|
||
# на сторінці «Сховище» й там же правиться поштучно.
|
||
#
|
||
# economy — метрики 7 діб, годинні агрегати півроку, syslog тиждень.
|
||
# Для диска на 50 ГБ і кількох сотень хостів.
|
||
# normal — метрики 35 діб, годинні агрегати два роки, аудит рік.
|
||
# Те, що люди мають на увазі під «як зазвичай».
|
||
# archive — метрики 90 діб, годинні агрегати п'ять років, аудит п'ять
|
||
# років. Коли історію вимагає регламент. Диск рахуйте
|
||
# заздалегідь: це в кілька разів більше за normal.
|
||
#
|
||
# ПОРОЖНЬО: normal.
|
||
#
|
||
# Профіль накладається лише на ПЕРШІЙ установці. Повторний запуск
|
||
# `install` не чіпає строки: до того часу їх уже могли поправити руками,
|
||
# і мовчки повернути наш профіль означало б знищити дані за чужим
|
||
# рішенням.
|
||
RETENTION=normal
|
||
|
||
# ---------------------------------------------------------------------
|
||
# TZ — часовий пояс.
|
||
# ---------------------------------------------------------------------
|
||
#
|
||
# У ньому рахуються розклади бекапів конфігів, вікна тиші для сповіщень
|
||
# і підписи часу на графіках. Пояс хоста тут не завжди правильна
|
||
# відповідь: сервер у чужому дата-центрі цілком може стояти в UTC, а
|
||
# «о третій ночі» для вимкнення сповіщень означає третю ночі там, де
|
||
# сидять чергові.
|
||
#
|
||
# ПОРОЖНЬО: береться пояс хоста, а якщо визначити не вдалось —
|
||
# Europe/Kyiv.
|
||
TZ=Europe/Kyiv
|