Vaš prvi build

Ta vodnik ustvari, preveri, zgradi in pregleda en custom image. Preverjen recept je preverjanje konfiguracije, ne dokaz, da je bil ISO zgrajen ali da je vsako zahtevano obnašanje prestalo VM test.

Preden začnete

• Prijavite se, da pogovor in build ostane povezan z vašim računom.
• Začnite z enim operacijskim sistemom in majhnim naborom paketov ali storitev.
• Določite, kateri dokaz bi dokazal, da je zahteva izpolnjena. Prisotnost paketa, stanje storitve, port, ki posluša, in obnašanje GUI so različne assertion.

Pri prvem zagonu se v klepetu izogibajte poverilnicam in URL-jem zasebnih repozitorijev. Skrivnosti dodajte pozneje prek podprtega workflow za credentials, ne z vgrajevanjem v image.

1. Opisite izid in preverjanja

Primer:

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.

Izrecne izključitve pomagajo ločiti namerno minimalen image od zahteve, ki jo je planner preprosto spregledal.

2. Preglejte predogled recepta

Preverite vsaj:

• base_image se ujema z zahtevano distribucijo in izdajo;
• zahtevani paketi so pod os.packages ali jih zagotavlja izrecna feature;
• uporabniki, skupine, storitve, omrežje, installer in izbire namizja se ujemajo z zahtevo;
• scenarios vsebujejo preverjanja, ki jih res potrebujete;
• ni bil dodan nezahtevan paket, desktop, installer, credential ali zunanji repozitorij.

Spremembe zahtevajte v istem pogovoru. Nadaljnje zahteve se uporabijo na aktivni recept. Ko uporabite Validate Recipe, backend ohrani prejšnjo bistveno zahtevo v klepetu in blokira recept, če še manjkajo izrecne zahteve; generirani kontrolni stavek ne sme izbrisati namena pogovora.

Validacija lahko še vedno spregleda nedostopen paket, izpad upstreama, napako builda, specifično za distro, ali obnašanje brez testa. Predogled berite kot predlagano pogodbo.

3. Build zaženite enkrat

Na preverjenem predogledu izberite Start Build. Uspešen klik ustvari build ID. Ob poročanju težave ga obdržite; je zanesljivejši od samega odstotka ali posnetka zaslona.

Panel builda lahko prikaže stanja queued, planning, configured, building, finalizing, completed, failed ali cancelled. Build v vrsti morda čaka na kapaciteto workerjev ali obnovo po zagonu. Prikazan odstotek je projekcija napredka, ne rok; nekateri koraki pakiranja in datotečnega sistema trajajo veliko dlje od drugih.

Build lahko spremljate v živem panelu builda, tudi če zapustite prvotni pogled klepeta. Osvežitev bi se morala znova povezati prek trajnega stanja builda in event streama. Ne klikajte Start Build večkrat, razen če UI sporoči, da build ID ni bil ustvarjen ali da je prejšnji build dosegel terminalno stanje.

4. Ločite dokončanje image od dokončanja testov

Image je lahko končan, preden izbrana VM verifikacija doseže terminalno stanje. Preberite oboje:

• build status: ali je bil sestavljen in finaliziran trajen artefakt;
• test status: not_run, running, passed, failed ali error;
• certification status, kadar je prisoten: rezultat konfigurirane evidence policy, ne univerzalne varnostne ali strojne certifikacije.

Odprite podrobnosti testov. Potrdite, da je vsaka zahtevana assertion tekla proti pričakovanemu gostu, in preglejte napake ali preskočena preverjanja. Uspešen boot test ne dokazuje, da se aplikacija odpre; zapis paketa ne dokazuje, da je storitev zdrava.

5. Preglejte in prenesite artefakt

Pred prenosom primerjajte končni recept in dokaz paketov/testov z zahtevo. Zabeležite build ID, ime datoteke artefakta, velikost in checksum, če sta prikazana.

Dejanje prenosa builda uporabite šele po dokončani finalizaciji artefakta. Paket za prenos lahko vsebuje ISO in povezan dokaz. Če prenos vrne Failed to create download package, not found ali drugo JSON napako:

1. potrdite, da ste prijavljeni kot lastnik builda;
2. znova odprite točen ta build, ne starejše kartice pogovora;
3. preverite, da je finalizacija artefakta končana in da je ISO na seznamu;
4. poskusite enkrat znova;
5. sporočite build ID, časovni žig, prikazana stanja build/test/finalizacije in natančno besedilo napake.

Ne gradite znova le zaradi napake lastništva ali pakiranja; lahko zavržete uporabno diagnostično stanje in porabite še en slot builda.

6. Preizkusite ISO v predvidenem kontekstu

Zagon v VM OpenFactory preveri le konfigurirano virtualno okolje. Za namestljiv desktop dodatno preizkusite pot installerja na enkratnem disku. Za fizično namestitev ločeno preizkusite način firmware, shrambo, grafiko, omrežje, suspend, vhodne naprave, posodobitve in obnovo na reprezentativni strojni opremi.

Pogosti koraki obnovitve

Naslednji koraki

• Razumevanje receptov
• Shema recepta
• Lastne assertion
• VNC konzola