Din första build

Den här genomgången skapar, validerar, bygger och granskar en anpassad image. Ett validerat recept är en konfigurationskontroll, inte bevis på att ISO:n har byggts eller att varje begärt beteende klarade ett VM-test.

Innan du börjar

• Logga in så att konversationen och builden förblir kopplade till ditt konto.
• Börja med ett operativsystem och en liten uppsättning paket eller tjänster.
• Bestäm vilket bevis som visar att begäran uppfylldes. Paketnärvaro, tjänststatus, en lyssnande port och GUI-beteende är olika assertions.

Vid första körningen, undvik credentials och privata repository-URL:er i chatten. Lägg till secrets senare via det stödda credential-flödet i stället för att baka in dem i en image.

1. Ange resultatet och kontrollerna

Exempel:

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.

Tydliga undantag hjälper dig skilja en avsiktligt minimal image från en begäran som planeraren helt enkelt missade.

2. Granska receptförhandsvisningen

Kontrollera minst:

• base_image matchar begärd distribution och release;
• begärda paket finns under os.packages eller levereras av en explicit feature;
• användare, grupper, tjänster, nätverk, installer och skrivbordsval matchar begäran;
• scenarios innehåller kontrollerna du faktiskt behöver;
• inget oönskat paket, skrivbord, installer, credential eller externt repository har lagts till.

Be om ändringar i samma konversation. Uppföljningsbegäranden tillämpas på det aktiva receptet. När Validate Recipe används bevarar backend den föregående innehållsrika chattbegäran och blockerar receptet om explicita krav fortfarande saknas; den genererade kontrollmeningen får inte radera konversationens avsikt.

Validering kan fortfarande missa ett otillgängligt paket, ett upstream-avbrott, ett distro-specifikt buildfel eller beteende utan test. Läs förhandsvisningen som ett föreslaget avtal.

3. Starta builden en gång

Välj Start Build på den validerade förhandsvisningen. Ett lyckat klick skapar ett build-ID. Behåll det ID:t när du rapporterar problem; det är mer tillförlitligt än bara en procentsats eller en skärmbild.

Buildpanelen kan visa tillstånd som queued, planning, configured, building, finalizing, completed, failed eller cancelled. En build i kö kan vänta på worker-kapacitet eller återstart efter start. En visad procentsats är en framstegsprojektion, inte en deadline; vissa paketerings- och filsystemsteg tar mycket längre tid än andra.

Du kan fortsätta följa builden i dess live buildpanel även om du lämnar den ursprungliga chattvyn. Omladdning ska återansluta via sparad buildstatus och event stream. Klicka inte Start Build upprepade gånger om inte UI rapporterar att inget build-ID skapades eller att föregående build nådde terminal state.

4. Skilj image-slutförande från test-slutförande

En image kan vara klar innan vald VM-verifiering når terminal state. Läs båda:

• build status: om en beständig artefakt samlades och finaliserades;
• test status: not_run, running, passed, failed eller error;
• certification status, när den finns: resultatet av den konfigurerade evidence-policyn, inte en universell säkerhets- eller hårdvarucertifiering.

Öppna testdetaljerna. Bekräfta att varje begärd assertion kördes mot förväntad guest och granska fel eller hoppade kontroller. Ett godkänt boottest bevisar inte att en applikation öppnas; en paketpost bevisar inte att tjänsten är frisk.

5. Granska och ladda ner artefakten

Innan nedladdning, jämför slutreceptet och paket-/testbevis med begäran. Notera build-ID, artefaktens filnamn, storlek och checksum när de visas.

Använd buildens nedladdningsåtgärd först när artefaktfinalisering är klar. Nedladdningspaketet kan innehålla ISO:n och relaterat bevis. Om nedladdning returnerar Failed to create download package, not found eller ett annat JSON-fel:

1. bekräfta att du är inloggad som buildens ägare;
2. öppna exakt samma build igen, inte ett äldre konversationskort;
3. verifiera att artefaktfinalisering är klar och att ISO listas;
4. försök en gång till;
5. rapportera build-ID, tidsstämpel, visade build-/test-/finaliseringsstatusar och exakt feltext.

Bygg inte om bara för att kringgå ett ownership- eller paketeringsfel; det kan kasta användbart diagnostiskt tillstånd och förbruka en till build-plats.

6. Testa ISO:n i avsett sammanhang

Boot i OpenFactorys VM verifierar bara den konfigurerade virtuella miljön. För ett installerbart skrivbord, testa också installersökvägen på en engångsdisk. För fysisk drift, testa separat firmware-läge, lagring, grafik, nätverk, suspend, inmatningsenheter, uppdateringar och recovery på representativ hårdvara.

Vanliga återställningsvägar

Nästa steg

• Förstå recept
• Receptschema
• Anpassade assertions
• VNC-konsol