OpenFactory dokumentacija
OpenFactory siūlo naršyklėje vykdomą Linux vertinimą, pasirinktinių atvaizdų receptus ir build’us, artefaktų peržiūrą, VM testavimą ir susijusius diegimo darbo srautus. Tikslūs paskyros ar savarankiškai hostinamos konsolės funkcijos priklauso nuo išleidimo versijos, plano, feature flag’ų ir prijungtos infrastruktūros.
Pradėkite nuo užduoties
| Tikslas | Dokumentacijos kelias |
|---|---|
| Sukurti ir patikrinti pasirinktinį atvaizdą | Pirmasis build’as |
| Suprasti normalizuotą recepto JSON | Recepto schema |
| Konfigūruoti build funkcijas | Operacinių sistemų kūrimas |
| Paleisti ir peržiūrėti VM | VM valdymas |
| Apibrėžti įrodymus po build’o | Testavimas |
| Prijungti MCP klientą | MCP integracija |
| Įvertinti vietinę KVM konsolę | Savarankiškai hostinama VM konsolė |
| Suprasti bendradarbiavimo apimtį | Vaidmenys ir leidimų apimtis |
Įrodymų modelis
OpenFactory atskleidžia kelias būsenas, kurias nederėtų sutraukti į vieną „sėkmės“ etiketę:
- Recepto validacija tikrina atpažintą konfigūracijos formą ir aiškiai nurodytų užklausų aprėptį.
- Build’o užbaigimas reiškia, kad atvaizdo artefaktas pasiekė finalizavimo kelią.
- Testo užbaigimas fiksuoja pasirinktų svečio assertion’ų rezultatą.
- Sertifikavimo ar policy būsena, jei yra, taikoma tik pavadintam įrodymų sutarčiai.
- Fizinė ar gamybinė kvalifikacija lieka atskira veikla, nebent buvo testuota tiksliai ta pati aparatūra, topologija, gedimo režimai ir release.
Naudokite siauriausią palaikomą teiginį. Paketas recepte nėra įrodymas, kad jis įdiegtas; įdiegtas paketas nėra įrodymas, kad tarnyba sveika; VM boot’as nėra įrodymas, kad diegiklis ar fizinis įrenginys veikia.
Hostinimo ir savarankiško hostinimo ribos
Hostinama paslauga apima atvaizdų kūrimo ir pokalbių darbo srautus. Repozitorijoje esančias savarankiškai hostinamos Compose diegimas yra privilegijuota, vieno hosto KVM konsolė vertinimui. Joje išjungti hostinami build’ai, pokalbiai, planavimas ir policy dokumentų darbo srautai; pati savaime ji nenustato gamybinio ar air-gap režimo.
Privačiam gamybiniam diegimui naudokite release specifinę architektūrą, tapatybę, persistenciją, backup’us, atnaujinimus ir palaikymo dokumentaciją, suderintą su OpenFactory. Nenaudokite marketingo galimybių sąrašo ar vertinimo Compose failo vietoje to runbook’o.
Kaip skaityti šią dokumentaciją
- Komandose, kur įmanoma, nurodytas darbo kontekstas ir tikėtinas rezultatas.
- Saugumo, atitikties, prieinamumo ir suderinamumo teiginiai turi aiškias įrodymų ribas.
- Jei UI ir statinis puslapis nesutampa, išsaugokite build ar run ID ir patikrinkite dabartinę API/būseną prieš kartodami destruktyvų veiksmą.
- Pasenusią dokumentaciją praneškite su puslapio URL, produkto release ar commit, laiko žyma ir stebėtu rezultatu.
Tęskite su Pradžia.