Váš první build

Tento postup vytvoří, ověří, sestaví a zkontroluje jeden vlastní image. Ověřený recept je kontrola konfigurace, ne důkaz, že ISO bylo sestaveno nebo že každé požadované chování prošlo testem ve VM.

Než začnete

• Přihlaste se, aby konverzace a build zůstaly vázané na váš účet.
• Začněte s jedním operačním systémem a malou sadou balíčků nebo služeb.
• Rozhodněte, jaký důkaz splnění požadavku potřebujete. Přítomnost balíčku, stav služby, naslouchající port a chování GUI jsou různé assertion.

U prvního běhu se vyhněte přihlašovacím údajům a URL soukromých repozitářů v chatu. Tajemství přidejte později podporovaným workflow pro credentials, ne vložením do image.

1. Popište výsledek a kontroly

Pří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étní vyloučení pomohou odlišit záměrně minimální image od požadavku, který planner prostě přehlédl.

2. Prohlédněte náhled receptu

Zkontrolujte alespoň:

• base_image odpovídá požadované distribuci a vydání;
• požadované balíčky jsou pod os.packages nebo je dodává explicitní feature;
• uživatelé, skupiny, služby, síť, installer a volby desktopu odpovídají požadavku;
• scenarios obsahují kontroly, které skutečně potřebujete;
• nebyl přidán nepožadovaný balíček, desktop, installer, credential ani externí repozitář.

Změny žádejte ve stejné konverzaci. Následné požadavky se aplikují na aktivní recept. Při použití Validate Recipe backend zachová předchozí podstatný chat a recept zablokuje, pokud stále chybí explicitní požadavky; generovaná kontrolní věta nesmí vymazat záměr konverzace.

Validace může stále přehlédnout nedostupný balíček, výpadek upstreamu, selhání buildu specifické pro distro nebo chování bez testu. Náhled čtěte jako navrhovanou smlouvu.

3. Spusťte build jednou

Na ověřeném náhledu zvolte Start Build. Úspěšné kliknutí vytvoří build ID. Při hlášení problému si ho uschovejte; je spolehlivější než samotné procento nebo screenshot.

Panel buildu může zobrazovat stavy queued, planning, configured, building, finalizing, completed, failed nebo cancelled. Build ve frontě může čekat na kapacitu workerů nebo obnovu po startu. Zobrazené procento je projekce postupu, ne termín; některé kroky balení a souborového systému trvají mnohem déle než jiné.

Build můžete sledovat v živém panelu buildu i když opustíte původní chat. Obnovení stránky by se mělo znovu připojit přes trvalý stav buildu a event stream. Neklikejte opakovaně na Start Build, pokud UI nehlásí, že build ID nevzniklo nebo že předchozí build nedosáhl terminálního stavu.

4. Oddělte dokončení image od dokončení testů

Image může být hotové dřív, než vybraná VM verifikace dosáhne terminálního stavu. Sledujte obojí:

• build status: zda byl sestaven a finalizován trvalý artefakt;
• test status: not_run, running, passed, failed nebo error;
• certification status, pokud je k dispozici: výsledek nakonfigurované evidence policy, ne univerzální bezpečnostní nebo hardwarová certifikace.

Otevřete detail testů. Ověřte, že každá požadovaná assertion proběhla proti očekávanému hostu, a projděte selhání nebo přeskočené kontroly. Úspěšný boot test neprokazuje, že se aplikace otevře; záznam o balíčku neprokazuje, že je služba v pořádku.

5. Zkontrolujte a stáhněte artefakt

Před stažením porovnejte finální recept a důkaz z balíčků/testů s požadavkem. Zaznamenejte build ID, název souboru artefaktu, velikost a checksum, pokud jsou zobrazeny.

Akci stažení buildu použijte až po dokončení finalizace artefaktu. Balíček ke stažení může obsahovat ISO a související důkaz. Pokud stažení vrátí Failed to create download package, not found nebo jinou JSON chybu:

1. ověřte, že jste přihlášeni jako vlastník buildu;
2. znovu otevřete přesně tento build, ne starší kartu konverzace;
3. ověřte, že finalizace artefaktu je hotová a ISO je v seznamu;
4. zkuste jednou znovu;
5. nahlaste build ID, časové razítko, zobrazené stavy build/test/finalizace a přesný text chyby.

Nepřestavujte jen kvůli chybě vlastnictví nebo balení; můžete tím ztratit užitečný diagnostický stav a spotřebovat další slot buildu.

6. Otestujte ISO v zamýšleném kontextu

Boot ve VM OpenFactory ověřuje jen nakonfigurované virtuální prostředí. U instalovatelného desktopu navíc otestujte cestu installeru na jednorázovém disku. U fyzického nasazení samostatně otestujte režim firmware, úložiště, grafiku, síť, suspend, vstupní zařízení, aktualizace a obnovu na reprezentativním hardwaru.

Běžné postupy obnovy

Další kroky

• Porozumění receptům
• Schéma receptu
• Vlastní assertion
• VNC konzole