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 серпня.
83 lines
3.9 KiB
Text
83 lines
3.9 KiB
Text
# syntax=docker/dockerfile:1.7
|
||
#
|
||
# Образ серверної частини NetPulse: HTTP API з вшитим інтерфейсом,
|
||
# gRPC-колектор і допоміжні команди.
|
||
#
|
||
# Один образ на чотири бінарники, а не чотири образи: вони збираються з
|
||
# одного модуля, ділять половину коду й завжди їдуть однією версією.
|
||
# Розкласти їх по різних образах означало б чотири рази качати ту саму
|
||
# базу й отримати можливість розʼїхатись версіями там, де це найдорожче
|
||
# коштує — між API та колектором, що ходять в одну схему БД.
|
||
#
|
||
# Контекст збірки — корінь репозиторію: модулі server і agent посилаються
|
||
# на ../gen/go через replace, і вужчий контекст їх не збере.
|
||
|
||
# --- інтерфейс -------------------------------------------------------
|
||
FROM node:22-alpine AS web
|
||
WORKDIR /src/web
|
||
|
||
# Спершу маніфести, потім код: правка компонента не має інвалідувати
|
||
# шар із npm ci, а він найдовший у цій стадії.
|
||
COPY web/package.json web/package-lock.json ./
|
||
RUN npm ci
|
||
|
||
COPY web/ ./
|
||
RUN npm run build
|
||
|
||
# --- бінарники -------------------------------------------------------
|
||
FROM golang:1.25-alpine AS build
|
||
WORKDIR /src
|
||
|
||
RUN apk add --no-cache git
|
||
|
||
COPY gen/go/go.mod gen/go/go.sum gen/go/
|
||
COPY server/go.mod server/go.sum server/
|
||
WORKDIR /src/server
|
||
RUN --mount=type=cache,target=/go/pkg/mod go mod download
|
||
|
||
WORKDIR /src
|
||
COPY gen/ gen/
|
||
COPY server/ server/
|
||
|
||
# Інтерфейс лягає в дерево ДО збірки: httpapi віддає його через
|
||
# //go:embed, а embed читає файли на етапі компіляції.
|
||
COPY --from=web /src/web/dist/ server/webui/dist/
|
||
|
||
ARG VERSION=dev
|
||
ARG COMMIT=none
|
||
|
||
WORKDIR /src/server
|
||
RUN --mount=type=cache,target=/go/pkg/mod \
|
||
--mount=type=cache,target=/root/.cache/go-build \
|
||
CGO_ENABLED=0 go build -trimpath \
|
||
-ldflags "-s -w -X main.version=${VERSION} -X main.commit=${COMMIT}" \
|
||
-o /out/ ./cmd/...
|
||
|
||
# --- образ -----------------------------------------------------------
|
||
FROM alpine:3.20
|
||
|
||
# ca-certificates — для вебхуків і SMTP через TLS; tzdata — бо розклади
|
||
# бекапів і тиша сповіщень задаються в часовому поясі тенанта. wget не
|
||
# ставимо: healthcheck обходиться тим, що вже є в busybox.
|
||
RUN apk add --no-cache ca-certificates tzdata \
|
||
&& adduser -D -u 10001 netpulse \n && mkdir -p /var/lib/netpulse \n && chown -R netpulse:netpulse /var/lib/netpulse
|
||
|
||
# Каталог сховища версій створюється В ОБРАЗІ й одразу під тим
|
||
# користувачем, від якого працює процес.
|
||
#
|
||
# Інакше іменований том, змонтований сюди вперше, успадковує права
|
||
# каталогу з образу — а він був root:root. Процес під uid 10001 не
|
||
# міг створити в ньому навіть підкаталог, і кожен коміт конфігу в
|
||
# git тихо не відбувався: у сховищі лишався контентний хеш замість
|
||
# SHA коміту, а репозиторій не існував узагалі.
|
||
#
|
||
# Помітили аж тоді, коли вперше знадобилось дзеркалення на
|
||
# зовнішній Git: виявилось, що дзеркалити нема чого.
|
||
|
||
COPY --from=build /out/ /usr/local/bin/
|
||
|
||
USER netpulse
|
||
WORKDIR /home/netpulse
|
||
|
||
EXPOSE 8080 9443
|
||
ENTRYPOINT ["netpulse-api"]
|