Vaš prvi build
Ovaj vodič stvara, validira, gradi i pregledava jedan prilagođeni image. Validirani recept je provjera konfiguracije, ne dokaz da je ISO izgrađen ili da je svako traženo ponašanje prošlo VM test.
Prije nego što krenete
- Prijavite se kako bi razgovor i build ostali povezani s vašim računom.
- Krenite s jednim operacijskim sustavom i malim skupom paketa ili usluga.
- Odlučite koji bi dokaz dokazao da je zahtjev ispunjen. Prisutnost paketa, stanje usluge, port koji sluša i ponašanje GUI različite su assertion.
Pri prvom pokretanju izbjegavajte vjerodajnice i URL-ove privatnih repozitorija u chatu. Tajne dodajte kasnije podržanim workflowom za credentials, a ne ugradnjom u image.
1. Navedite ishod i provjere
Primjer:
Build a Debian 13 server image with OpenSSH and curl.
Create a password-locked deploy user in the sudo group.
Verify that the image boots, the deploy user exists, the ssh service is
enabled, and curl is installed. Do not add Docker or a desktop.Izričita isključenja pomažu razlikovati namjerno minimalan image od zahtjeva koji je planner jednostavno propustio.
2. Pregledajte pretpregled recepta
Provjerite barem:
base_imageodgovara traženoj distribuciji i izdanju;- traženi paketi su pod
os.packagesili ih osigurava izričita feature; - korisnici, grupe, usluge, mreža, installer i izbori radne površine odgovaraju zahtjevu;
scenariossadrže provjere koje stvarno trebate;- nije uveden ne traženi paket, desktop, installer, credential ili vanjski repozitorij.
Tražite promjene u istom razgovoru. Naknadni zahtjevi primjenjuju se na aktivni recept. Kad se koristi Validate Recipe, backend čuva prethodni bitan zahtjev u chatu i blokira recept ako još nedostaju izričiti zahtjevi; generirana kontrolna rečenica ne smije izbrisati namjeru razgovora.
Validacija i dalje može propustiti nedostupan paket, prekid upstreama, neuspjeh builda specifičan za distro ili ponašanje bez testa. Pretpregled čitajte kao predloženi ugovor.
3. Pokrenite build jednom
Na validiranom pretpregledu odaberite Start Build. Uspješan klik stvara build ID. Kod prijave problema zadržite taj ID; pouzdaniji je od postotka ili snimke zaslona.
Panel builda može prikazati stanja queued, planning, configured, building, finalizing, completed, failed ili cancelled. Build u redu može čekati kapacitet workera ili oporavak nakon pokretanja. Prikazani postotak projekcija je napretka, ne rok; neki koraci pakiranja i datotečnog sustava traju puno duže od drugih.
Build možete pratiti u live panelu builda čak i ako napustite izvorni prikaz chata. Ponovno učitavanje bi se trebalo ponovno spojiti preko trajnog stanja builda i event streama. Ne klikajte Start Build više puta osim ako UI ne javi da build ID nije stvoren ili da je prethodni build dosegao terminalno stanje.
4. Odvojite dovršetak image od dovršetka testova
Image može biti gotov prije nego odabrana VM verifikacija dosegne terminalno stanje. Pročitajte oboje:
- build status: je li sastavljen i finaliziran trajni artefakt;
- test status:
not_run,running,passed,failedilierror; - certification status, kad je prisutan: rezultat konfigurirane evidence policy, ne univerzalne sigurnosne ili hardverske certifikacije.
Otvorite detalje testova. Potvrdite da je svaka tražena assertion pokrenuta protiv očekivanog gosta i pregledajte neuspjehe ili preskočene provjere. Uspješan boot test ne dokazuje da se aplikacija otvara; zapis paketa ne dokazuje da je usluga zdrava.
5. Pregledajte i preuzmite artefakt
Prije preuzimanja usporedite konačni recept i dokaz paketa/testova sa zahtjevom. Zabilježite build ID, naziv datoteke artefakta, veličinu i checksum kad su prikazani.
Akciju preuzimanja builda koristite tek nakon dovršene finalizacije artefakta. Paket
za preuzimanje može sadržavati ISO i povezani dokaz. Ako preuzimanje vrati
Failed to create download package, not found ili drugu JSON grešku:
- potvrdite da ste prijavljeni kao vlasnik builda;
- ponovno otvorite točno taj build, a ne stariju karticu razgovora;
- provjerite da je finalizacija artefakta dovršena i da je ISO na popisu;
- pokušajte jednom ponovno;
- prijavite build ID, vremensku oznaku, prikazana stanja build/test/finalizacije i točan tekst greške.
Ne gradite ponovno samo zbog greške vlasništva ili pakiranja; to može odbaciti korisno dijagnostičko stanje i potrošiti još jedan slot builda.
6. Testirajte ISO u predviđenom kontekstu
Pokretanje u VM OpenFactory provjerava samo konfigurirano virtualno okruženje. Za instalabilni desktop dodatno testirajte put installer na jednokratnom disku. Za fizičko razmještanje zasebno testirajte način firmwarea, pohranu, grafiku, mrežu, suspend, ulazne uređaje, ažuriranja i oporavak na reprezentativnom hardveru.
Uobičajeni putovi oporavka
| Simptom | Radnja |
|---|---|
| Recept se validira, ali izostavi zahtjev | Ne gradite; izričito navedite nedostajući zahtjev i ponovno validirajte |
| Build je u redu | Zadržite build ID i provjerite stanje reda/oporavka; izbjegavajte duplikate pokretanja |
| Napredak se čini nepromijenjenim | Pregledajte trenutnu fazu i nedavnu aktivnost u logu prije nego zaključite da je zapeo |
| Build ne uspije | Pročitajte prvu uzročnu grešku, ne samo konačni sažetak; revidirajte ili ponovite tek nakon razumijevanja uzroka |
| Testovi ne uspiju | Razlikujte grešku produkta, grešku assertion, problem boota gosta i grešku infrastrukture |
| Preuzimanje nedostaje ili je zabranjeno | Potvrdite sesiju vlasnika, stanje finalizacije i točan build ID prije novog builda |