Interne protocollen · 0.1.0
Grenzen van interne diensten
Protocollen van scanner, updater en Advisor-connector zijn afzonderlijk van de control-API beschreven.
De API-referentie is in het Engels.
Deze protocollen verbinden componenten binnen de werkbank. Het zijn implementatie-interfaces, geen ondersteunde integratie-endpoints voor derden. Gebruik de control-API met ondersteunde clientbevoegdheid voor applicatieworkflows.
Geef elke dienst een nauwe verantwoordelijkheid
Coördinator
- Jobworker
Beheert de duurzame controloperatie en exacte dienstbindingen.
Afzonderlijke protocollen
- Scannerprotocol
Begrensde runs, gepagineerde bevindingen en expliciete resultaatbevestiging.
- Updaterprotocol
Voorbereiding en verzoening van beoordeelde componenten zonder projectbrontoegang.
- Advisor-connectorprotocol
Providerwerk gebonden aan exacte machtigingen, bestemmingen en annuleringsstatus.
Verbindingen
Jobworker naar Scannerprotocol
Verzamel en bewaar het exacte runresultaat voordat opruiming wordt bevestigd.
Jobworker naar Updaterprotocol
Volg operatie-identiteit en verzoekdigest door voorbereiding en herstel.
Jobworker naar Advisor-connectorprotocol
Geef uitsluitend de providerbevoegdheid uit die het bedoelde Advisor-verzoek vereist.
| Dienst | Aanroeper en resources | Protocolverantwoordelijkheid |
|---|---|---|
| Scanner | Worker; geautoriseerde bron, momentopnamen en gevalideerde cache alleen-lezen | Runtoelating, toestand, begrensde bevindingen, exacte resultaatbevestiging en annulering. |
| Scannergegevensupdater | Control-API/worker; beschrijfbare cache en beoordeeld downloadverkeer | Duurzame voorbereidingsoperaties en publicatie van volledige cachegeneraties zonder projectbrontoegang. |
| Advisor-connector | Worker; eigen providerautorisatie en goedgekeurde netwerkroutes | Nauw toegestane providertests, generatie, waarneming en annulering. |
De kern publiceert alleen haar loopback-ingangsrelay. Dit zijn geen publieke website-endpoints. Intern scannernetwerk, updateruitgang en Advisor-uitgang zijn gescheiden in Compose. Mount- en netwerkdeclaraties moeten in uitgerolde images en containers worden geverifieerd voordat ze als waargenomen isolatie gelden.
Runtimescanner
De worker start een stabiele run met POST /runs, volgt zijn toestand en leest het resultaat via begrensde bevindingenpagina’s. Runidentiteit en verzoekdigest verhinderen vervanging door een andere opdracht onder een bestaande run. Het verzegelde manifest voegt resultaatdigest, aantallen, streamidentiteit, overzicht en artefactdeclaraties toe.
Paginacursors binden exacte run, verzoek, resultaat en vervolgpositie. De worker valideert de hele stream vóór databasepublicatie. POST /runs/{run_id}/result/ack geeft het exacte tijdelijke resultaat vrij na duurzame opslag. Annulering en opruiming via DELETE /runs/{run_id} moeten de passende verzoek-/resultaatbinding behouden; het zijn geen willekeurige bestandsverwijderopdrachten.
Runregister en herstelspool zijn proceslokaal en tijdbegrensd. Een scannerherstart bewaart de spool niet als duurzaam bewijs. Ook het health-antwoord bewijst geen gereedheid van gekozen binaries, regels en databases. Lees scannerroutes, runbesturing en commit vóór ACK.
Updater zonder brontoegang
De updater ontvangt duurzame operaties gebonden aan operatie-UUID en verzoekdigest. De executor herstelt operatiestatus en beheert begrensd actief en wachtend werk. Handlers bepalen beoordeelde componenten, plaatsen kandidaatdata privé, valideren en verzegelen die en publiceren een volledige generatie. Ze accepteren geen willekeurige repositorypaden, download-URL’s of shellopdrachten als vervanging voor de beoordeelde catalogus.
De private HTTP-grens vereist een toegestane Host en weigert forwarded-host-/protocolheaders. Dit is een extra verzoekgrens, geen reden om de updater publiek te maken. De updater heeft geen projectbronmount; de scanner gebruikt zijn gevalideerde cache alleen-lezen.
Activering en annulering hebben verschillende uitkomsten. Zodra publicatie de beschermde commitfase ingaat, mag annulering haar niet onderbreken of de selectie terugrollen. Rollback is een aparte gevalideerde operatie en vereist nog compatibele verse eerdere gegevens. Zie updateropstart en verzoekgrens, operatieroutes en voorbereidingsarchitectuur.
Advisor-connector
Zowel lokale als externe Advisor-acties lopen via de connector. De worker reserveert of laat een begrensde operatie toe, presenteert de vereiste uitvoeringsmachtiging en vraagt generatie. De connector controleert geautoriseerde providerroute en model en valideert het antwoord. Hij heeft eigen autorisatiemateriaal en geen gemounte projectbron; de worker levert het toegelaten bevindingpakket.
Externe generatie vereist de apart bevestigde route voor één bevinding. Bevestiging bindt providerconfiguratie, autorisatie, transport, bestemming, modelidentiteit, bevindingrevisie en prompthash. Automatische en scanbrede providerselectie blijft uitsluitend lokaal. Extern transport ondersteunt de beoordeelde directe of SSH-Ollama-routes, niet willekeurige modelproviders.
Operatietoelating, waarneming en annulering hebben expliciete endpoints. Annulering kan verder werk stoppen maar haalt al verzonden inhoud niet terug. De worker valideert advies opnieuw en verwerpt het als de bevinding tijdens generatie veranderde. Het wijzigt niet automatisch levenscyclus of gatebeleid.
Zie connectoroperaties en generatiehandlers, workerintegratie en openbaarmakingsbinding.
Lees protocol en implementatie samen
De interne referentie beschrijft declaraties op haar expliciet benoemde API-momentopname. Sommige handlers lezen en valideren verzoek-JSON rechtstreeks; een automatisch gegenereerd breed schema beschrijft daarom niet elke toegestane sleutel, operatiebinding of autorisatievoorwaarde. Lees handler en aanroeper samen bij protocolwijziging.
Schemadeclaraties bewijzen geen opstart, bereikbaarheid, providerautorisatie, herstelgedrag of integratieondersteuning. Protocolwijzigingen vereisen gecoördineerde client-/dienstvalidatie en tests van weigeringen en herstelpaden. Publieke integraties mogen niet afhangen van stabiliteit van deze interne endpoints.