Komponenter

Inventeringsskannern

Sveper maskinerna ett valv beskriver och regenererar registren som säger vad som kör var.

Sveper maskinerna ett valv beskriver och regenererar registren som säger vad som kör var.

Det här är den enda komponenten som korsar mellan de två kartorna. Dess indata är infrastruktur — riktiga maskiner, riktiga tjänster, vad som faktiskt lyssnar — och dess utdata är en fil i valvet.

Allt annat här läser ett valv och skriver ett valv, eller läser ett externt system och skriver ett valvarkiv. Den här läser världen och skriver ett register.

Registren är genererade, vilket får en följd

Att handredigera ett förlorar ändringen vid nästa svep. Det låter som en olägenhet och är i själva verket poängen: ett register som går att handredigera är ett register som säger emot verkligheten i samma stund som någon har bråttom.

Är något i ett genererat register fel ligger fixen uppströms — i maskinlistan skannern läser, som är den deklarerade sanningskällan för vilka maskiner som alls finns.

Varför ett valv behöver det här

För att den dokumentation som blir inaktuell snabbast är den om infrastruktur, och den blir det tyst. En runbook som namnger en värd, en port och en sökväg är korrekt tills någon flyttar tjänsten, och ingenting i dokumentet ändras när de gör det.

Ett genererat register är fel i högst ett svep.

Den här delen är inte publicerad

Ett lokalt skript i ett privat repo. Mönstret är det som går att ta med: deklarera maskinerna för hand, generera allt som härleds ur dem, och gör de genererade filerna uppenbart genererade så ingen redigerar en av misstag.

Deklarerat i kontraktet Inte publicerad

Sort
local script, run on demand
Roll
Sweeps the machines a vault describes and regenerates the index files that say what runs where
Läser
  • its own machine list — the source of truth for which machines exist
Skriver
  • _INDEX-*.md — the generated machine and mapping registers
Beror på
inget
Dokumentationen hör hemma i
komponentens eget repo

Att veta. The one component that bridges the two maps: its INPUT is infrastructure and its OUTPUT is a vault file. Generated — hand-editing a register loses it on the next sweep

Citerat ur kontraktet, som är engelskt. Ett citat i original kan inte drifta från sin källa; en översättning här hade blivit en andra kopia att hålla sann.

Ur ecosystem.yaml, kontrakt 41 · core-skills 1.89.4 · läst vid bygge 2026-10-08