Váš prvý build

Tento postup vytvorí, overí, zostaví a skontroluje jeden vlastný image. Overený recept je kontrola konfigurácie, nie dôkaz, že ISO bolo zostavené alebo že každé požadované správanie prešlo testom vo VM.

Pred začiatkom

• Prihláste sa, aby konverzácia a build zostali viazané na váš účet.
• Začnite s jedným operačným systémom a malou sadou balíkov alebo služieb.
• Rozhodnite, aký dôkaz splnenia požiadavky potrebujete. Prítomnosť balíka, stav služby, počúvajúci port a správanie GUI sú rôzne assertion.

Pri prvom behu sa vyhnite prihlasovacím údajom a URL súkromných repozitárov v chate. Tajomstvá pridajte neskôr podporovaným workflow pre credentials, nie vložením do image.

1. Opíšte výsledok a kontroly

Príklad:

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.

Konkrétne vylúčenia pomôžu odlíšiť zámerne minimálny image od požiadavky, ktorú planner jednoducho prehliadol.

2. Prezrite náhľad receptu

Skontrolujte aspoň:

• base_image zodpovedá požadovanej distribúcii a vydaniu;
• požadované balíky sú pod os.packages alebo ich dodáva explicitná feature;
• používatelia, skupiny, služby, sieť, installer a voľby desktopu zodpovedajú požiadavke;
• scenarios obsahujú kontroly, ktoré skutočne potrebujete;
• nebol pridaný nepožadovaný balík, desktop, installer, credential ani externý repozitár.

Zmeny žiadajte v tej istej konverzácii. Následné požiadavky sa aplikujú na aktívny recept. Pri použití Validate Recipe backend zachová predchádzajúcu podstatnú chat požiadavku a recept zablokuje, ak stále chýbajú explicitné požiadavky; generovaná kontrolná veta nesmie vymazať zámer konverzácie.

Validácia môže stále prehliadnuť nedostupný balík, výpadok upstreamu, zlyhanie buildu špecifické pre distro alebo správanie bez testu. Náhľad čítajte ako navrhovanú zmluvu.

3. Spustite build raz

Na overenom náhľade zvoľte Start Build. Úspešné kliknutie vytvorí build ID. Pri hlásení problému si ho uschovajte; je spoľahlivejší než samotné percento alebo screenshot.

Panel buildu môže zobrazovať stavy queued, planning, configured, building, finalizing, completed, failed alebo cancelled. Build vo fronte môže čakať na kapacitu workerov alebo obnovu po štarte. Zobrazené percento je projekcia postupu, nie termín; niektoré kroky balenia a súborového systému trvajú oveľa dlhšie než iné.

Build môžete sledovať v živom paneli buildu aj keď opustíte pôvodný chat. Obnovenie stránky by sa malo znova pripojiť cez trvalý stav buildu a event stream. Neklikajte opakovane na Start Build, pokiaľ UI nehlási, že build ID nevzniklo alebo že predchádzajúci build nedosiahol terminálny stav.

4. Oddelte dokončenie image od dokončenia testov

Image môže byť hotové skôr, než vybraná VM verifikácia dosiahne terminálny stav. Sledujte oboje:

• build status: či bol zostavený a finalizovaný trvalý artefakt;
• test status: not_run, running, passed, failed alebo error;
• certification status, ak je k dispozícii: výsledok nakonfigurovanej evidence policy, nie univerzálna bezpečnostná alebo hardvérová certifikácia.

Otvorte detail testov. Overte, že každá požadovaná assertion prebehla proti očakávanému hostu, a prejdite zlyhania alebo preskočené kontroly. Úspešný boot test nepreukazuje, že sa aplikácia otvorí; záznam o balíku nepreukazuje, že je služba v poriadku.

5. Skontrolujte a stiahnite artefakt

Pred stiahnutím porovnajte finálny recept a dôkaz z balíkov/testov s požiadavkou. Zaznamenajte build ID, názov súboru artefaktu, veľkosť a checksum, ak sú zobrazené.

Akciu stiahnutia buildu použite až po dokončení finalizácie artefaktu. Balík na stiahnutie môže obsahovať ISO a súvisiaci dôkaz. Ak stiahnutie vráti Failed to create download package, not found alebo inú JSON chybu:

1. overte, že ste prihlásení ako vlastník buildu;
2. znova otvorte presne tento build, nie staršiu kartu konverzácie;
3. overte, že finalizácia artefaktu je hotová a ISO je v zozname;
4. skúste raz znova;
5. nahláste build ID, časové razítko, zobrazené stavy build/test/finalizácia a presný text chyby.

Neprestavujte len kvôli chybe vlastníctva alebo balenia; môžete tým stratiť užitočný diagnostický stav a spotrebovať ďalší slot buildu.

6. Otestujte ISO v zamýšľanom kontexte

Boot vo VM OpenFactory overuje len nakonfigurované virtuálne prostredie. Pri inštalovateľnom desktope navyše otestujte cestu installeru na jednorazovom disku. Pri fyzickom nasadení samostatne otestujte režim firmware, úložisko, grafiku, sieť, suspend, vstupné zariadenia, aktualizácie a obnovu na reprezentatívnom hardvéri.

Bežné postupy obnovy

Ďalšie kroky

• Pochopenie receptov
• Schéma receptu
• Vlastné assertion
• VNC konzola