Az első build

Ez az útmutató létrehoz, ellenőriz, buildel és átnéz egy egyedi image-et. A validált recept konfiguráció-ellenőrzés, nem bizonyíték arra, hogy az ISO elkészült, vagy hogy minden kért viselkedés átment egy VM teszten.

Mielőtt elkezdené

Jelentkezzen be, hogy a beszélgetés és a build a fiókjához maradjon kötve.
Egy operációs rendszerrel és kevés csomaggal vagy szolgáltatással kezdjen.
Döntse el, milyen bizonyíték igazolná a kérést. Csomag jelenléte, szolgáltatás állapota, figyelő port és GUI viselkedés különböző assertion.

Első futtatáskor kerülje a hitelesítő adatokat és a privát repository URL-eket a chatben. A titkokat később adja hozzá a támogatott credential workflow-n keresztül, ne image-be sütve.

1. Fogalmazza meg az eredményt és az ellenőrzéseket

Példa:


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.

Az explicit kizárások segítenek megkülönböztetni a szándékosan minimális image-et attól a kérésről, amit a planner egyszerűen kihagyott.

2. Nézze át a recept előnézetét

Legalább ezt ellenőrizze:

a base_image megfelel a kért disztribúciónak és kiadásnak;
a kért csomagok az os.packages alatt vannak, vagy explicit feature adja őket;
a felhasználók, csoportok, szolgáltatások, hálózat, installer és asztali választások illeszkednek a kéréshez;
a scenarios tartalmazza a tényleg szükséges ellenőrzéseket;
nem került be nem kért csomag, desktop, installer, credential vagy külső repository.

Változtatásokat ugyanabban a beszélgetésben kérjen. A követő kérések az aktív receptre vonatkoznak. A Validate Recipe használatakor a backend megőrzi az előző lényegi chat kérést, és blokkolja a receptet, ha még hiányoznak explicit követelmények; a generált ellenőrző mondat nem törölheti a beszélgetés szándékát.

A validáció továbbra is kihagyhat egy nem elérhető csomagot, upstream kiesést, disztro-specifikus build hibát vagy teszt nélküli viselkedést. Az előnézetet javasolt szerződésként olvassa.

3. Indítsa el a buildet egyszer

A validált előnézeten válassza a Start Build gombot. Sikeres kattintás build ID-t hoz létre. Probléma jelzésekor tartsa meg; megbízhatóbb, mint csak a százalék vagy egy képernyőkép.

A build panel olyan állapotokat mutathat, mint queued, planning, configured, building, finalizing, completed, failed vagy cancelled. A sorban álló build várhat worker kapacitásra vagy indulás utáni helyreállításra. A megjelenő százalék előrehaladás-becslés, nem határidő; egyes csomagolási és fájlrendszer lépések sokkal tovább tartanak, mint mások.

A buildet a live build panelen követheti, még ha el is hagyja az eredeti chat nézetet. Az újratöltésnek a perzisztens build állapoton és az event streamen keresztül kell újracsatlakoznia. Ne kattintson többször a Start Build gombra, hacsak a UI nem jelzi, hogy nem jött létre build ID, vagy az előző build terminális állapotba ért.

4. Válassza szét az image és a teszt befejezését

Az image elkészülhet, mielőtt a kiválasztott VM ellenőrzés terminális állapotba ér. Mindkettőt olvassa:

build status: összeállt-e és finalizálódott-e tartós artefakt;
test status: not_run, running, passed, failed vagy error;
certification status, ha van: a beállított evidence policy eredménye, nem univerzális biztonsági vagy hardver tanúsítás.

Nyissa meg a teszt részleteit. Erősítse meg, hogy minden kért assertion a várt vendég ellen futott, és nézze át a hibákat vagy kihagyott ellenőrzéseket. A sikeres boot teszt nem bizonyítja, hogy egy alkalmazás megnyílik; egy csomag rekord nem bizonyítja, hogy a szolgáltatás egészséges.

5. Nézze át és töltse le az artefaktust

Letöltés előtt hasonlítsa össze a végleges receptet és a csomag/teszt bizonyítékot a kérelmmel. Jegyezze fel a build ID-t, az artefakt fájlnevét, méretét és checksumot, ha megjelennek.

A build letöltési műveletét csak az artefakt finalizálás befejezése után használja. A letöltési csomag tartalmazhat ISO-t és kapcsolódó bizonyítékot. Ha a letöltés ezt adja vissza: Failed to create download package, not found, vagy más JSON hiba:

erősítse meg, hogy a build tulajdonosaként van bejelentkezve;
pontosan ezt a buildet nyissa meg újra, ne egy régebbi beszélgetés kártyát;
ellenőrizze, hogy az artefakt finalizálás kész és az ISO szerepel a listán;
próbálja meg egyszer újra;
jelentse a build ID-t, időbélyeget, a megjelenített build/teszt/finalizálás állapotokat és a pontos hiba szöveget.

Ne buildeljen újra csak tulajdonjogi vagy csomagolási hiba miatt; eldobhat hasznos diagnosztikai állapotot és elfogy egy újabb build slot.

6. Tesztelje az ISO-t a tervezett környezetben

Az OpenFactory VM-ben való boot csak a beállított virtuális környezetet ellenőrzi. Telepíthető asztali rendszernél tesztelje külön az installer útvonalat eldobható lemezen. Fizikai telepítésnél külön tesztelje a firmware módot, tárolót, grafikát, hálózatot, felfüggesztést, bemeneti eszközöket, frissítéseket és helyreállítást reprezentatív hardveren.

Gyakori helyreállítási lépések

Tünet	Teendő
A recept validál, de kihagy egy kérést	Ne buildeljen; mondja ki explicit a hiányzó követelményt, és validáljon újra
A build sorban áll	Tartsa meg a build ID-t, nézze a sor/helyreállítás állapotát; kerülje a dupla indítást
A haladás változatlannak tűnik	Nézze az aktuális szakaszt és a napló friss aktivitását, mielőtt beragadtnak gondolná
A build sikertelen	Olvassa az első okozati hibát, ne csak a végső összefoglalót; javítson vagy ismételjen csak ok megértése után
A tesztek sikertelenek	Különítsen termékhibát, assertion hibát, vendég boot problémát és infrastruktúra hibát
A letöltés hiányzik vagy tiltott	Erősítse meg a tulajdonos munkamenetet, finalizálás állapotot és pontos build ID-t új build előtt