Din første build

Denne gennemgang opretter, validerer, bygger og gennemgår ét tilpasset image. En valideret opskrift er en konfigurationskontrol, ikke bevis for at ISO’en er bygget eller at al ønsket adfærd bestod et VM-test.

Før du starter

• Log ind, så samtalen og builden forbliver knyttet til din konto.
• Start med ét operativsystem og et lille sæt pakker eller tjenester.
• Beslut hvilket bevis der viser, at anmodningen blev opfyldt. Pakketilstedeværelse, tjenestetilstand, en lytteport og GUI-adfærd er forskellige assertions.

Ved første kørsel: undgå credentials og private repository-URL’er i chatten. Tilføj secrets senere via den understøttede credential-workflow i stedet for at bage dem ind i et image.

1. Angiv resultatet og kontrollerne

Eksempel:

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.

Eksplicitte udelukkelser hjælper med at skelne et bevidst minimalt image fra en anmodning, som planneren simpelthen overså.

2. Gennemgå opskrift-forhåndsvisningen

Tjek mindst:

• base_image matcher den ønskede distribution og release;
• ønskede pakker står under os.packages eller leveres af en eksplicit feature;
• brugere, grupper, tjenester, netværk, installer og skrivebordsvalg matcher anmodningen;
• scenarios indeholder de kontroller, du faktisk har brug for;
• der er ikke tilføjet uønsket pakke, skrivebord, installer, credential eller eksternt repository.

Bed om ændringer i samme samtale. Opfølgende anmodninger anvendes på den aktive opskrift. Når Validate Recipe bruges, bevarer backend den foregående substantielle chatanmodning og blokerer opskriften, hvis eksplicitte krav stadig mangler; den genererede kontrolsætning må ikke slette samtalens hensigt.

Validering kan stadig overse en utilgængelig pakke, et upstream-nedbrud, en distro-specifik buildfejl eller adfærd uden test. Læs forhåndsvisningen som en foreslået kontrakt.

3. Start builden én gang

Vælg Start Build på den validerede forhåndsvisning. Et vellykket klik opretter et build-ID. Gem det ID, når du rapporterer et problem; det er mere pålideligt end kun en procent eller et screenshot.

Buildpanelet kan vise tilstande som queued, planning, configured, building, finalizing, completed, failed eller cancelled. En build i kø kan vente på worker-kapacitet eller opstartsgendannelse. En vist procent er en fremskridtsprojektion, ikke en deadline; nogle pakke- og filsystemtrin tager meget længere tid end andre.

Du kan fortsætte med at følge builden i dens live buildpanel, selv om du forlader den oprindelige chatvisning. Genindlæsning bør genforbinde via persisteret buildtilstand og event stream. Klik ikke Start Build gentagne gange, medmindre UI rapporterer, at intet build-ID blev oprettet, eller den forrige build nåede terminal state.

4. Adskil image-afslutning fra test-afslutning

Et image kan være færdigt, før den valgte VM-verifikation når terminal state. Læs begge:

• build status: om en varig artefakt blev samlet og finaliseret;
• test status: not_run, running, passed, failed eller error;
• certification status, når den findes: resultatet af den konfigurerede evidence-politik, ikke en universel sikkerheds- eller hardwarecertificering.

Åbn testdetaljerne. Bekræft, at hver anmodede assertion kørte mod den forventede guest, og gennemgå fejl eller sprunget kontroller over. Et bestået boot-test beviser ikke, at en applikation åbner; en pakkepost beviser ikke, at tjenesten er sund.

5. Gennemgå og download artefakten

Før download: sammenlign den endelige opskrift og pakke-/testbevis med anmodningen. Notér build-ID, artefaktfilnavn, størrelse og checksum, når de vises.

Brug buildens downloadhandling først, når artefaktfinalisering er fuldført. Downloadpakken kan indeholde ISO’en og relateret bevis. Hvis download returnerer Failed to create download package, not found eller en anden JSON-fejl:

1. bekræft, at du er logget ind som build-ejer;
2. genåbn præcis den build i stedet for et ældre samtalekort;
3. verificér, at artefaktfinalisering er fuldført, og at ISO er listet;
4. prøv én gang til;
5. rapportér build-ID, tidsstempel, viste build-/test-/finaliseringstilstande og præcis fejltekst.

Byg ikke igen blot for at omgå en ownership- eller pakkefejl; det kan kassere nyttig diagnostisk tilstand og bruge endnu en build-plads.

6. Test ISO’en i den tilsigtede kontekst

Boot i OpenFactorys VM verificerer kun det konfigurerede virtuelle miljø. For et installerbart skrivebord, test også installersporet på en engangsdisk. Ved fysisk udrulning, test separat firmware-tilstand, lager, grafik, netværk, suspend, inputenheder, opdateringer og recovery på repræsentativ hardware.

Almindelige genopretningsveje

Næste skridt

• Forstå opskrifter
• Opskriftschema
• Tilpassede assertions
• VNC-konsol