Din første build
Denne gjennomgangen oppretter, validerer, bygger og inspiserer ett tilpasset image. En validert oppskrift er en konfigurasjonssjekk, ikke bevis på at ISO-en er bygget eller at all etterspurt oppførsel besto et VM-test.
Før du starter
- Logg inn slik at samtalen og builden forblir knyttet til kontoen din.
- Start med ett operativsystem og et lite sett pakker eller tjenester.
- Bestem hvilket bevis som viser at forespørselen ble oppfylt. Pakketilstedeværelse, tjenestetilstand, en lyttende port og GUI-atferd er ulike assertions.
Ved første kjøring: unngå credentials og private repository-URL-er i chatten. Legg til secrets senere via den støttede credential-workflowen i stedet for å bake dem inn i et image.
1. Angi resultatet og kontrollene
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.Eksplisitte unntak hjelper deg å skille et bevisst minimalt image fra en forespørsel planleggeren rett og slett overså.
2. Gjennomgå oppskrift-forhåndsvisningen
Sjekk minst:
base_imagematcher etterspurt distribusjon og release;- etterspurte pakker står under
os.packageseller leveres av en eksplisitt feature; - brukere, grupper, tjenester, nettverk, installer og skrivebordsvalg matcher forespørselen;
scenariosinneholder kontrollene du faktisk trenger;- det er ikke lagt til uønsket pakke, skrivebord, installer, credential eller eksternt repository.
Be om endringer i samme samtale. Oppfølgingsforespørsler brukes på den aktive oppskriften. Når Validate Recipe brukes, bevarer backend den foregående substansielle chatforespørselen og blokkerer oppskriften hvis eksplisitte krav fortsatt mangler; den genererte kontrollsetningen får ikke slette samtalens hensikt.
Validering kan fortsatt overse en utilgjengelig pakke, et upstream-brudd, en distro-spesifikk buildfeil eller oppførsel uten test. Les forhåndsvisningen som en foreslått kontrakt.
3. Start builden én gang
Velg Start Build på den validerte forhåndsvisningen. Et vellykket klikk oppretter en build-ID. Behold den ID-en når du rapporterer et problem; den er mer pålitelig enn bare en prosent eller et skjermbilde.
Buildpanelet kan vise tilstander som queued, planning, configured, building, finalizing, completed, failed eller cancelled. En build i kø kan vente på worker-kapasitet eller oppstartsgjenoppretting. Vist prosent er en fremdriftsprojeksjon, ikke en frist; noen pakke- og filsystemtrinn tar mye lenger tid enn andre.
Du kan fortsette å følge builden i live buildpanelet selv om du forlater den opprinnelige chatvisningen. Omlasting bør koble til igjen via persistert buildtilstand og event stream. Ikke klikk Start Build gjentatte ganger med mindre UI rapporterer at ingen build-ID ble opprettet, eller at forrige build nådde terminal state.
4. Skill image-fullføring fra test-fullføring
Et image kan være ferdig før valgt VM-verifikasjon når terminal state. Les begge:
- build status: om en varig artefakt ble satt sammen og finalisert;
- test status:
not_run,running,passed,failedellererror; - certification status, når den finnes: resultatet av den konfigurerte evidence-policyen, ikke en universell sikkerhets- eller hardware-sertifisering.
Åpne testdetaljene. Bekreft at hver etterspurt assertion kjørte mot forventet guest, og gå gjennom feil eller hoppede kontroller. Et bestått boot-test beviser ikke at en applikasjon åpner; en pakkepost beviser ikke at tjenesten er sunn.
5. Inspiser og last ned artefakten
Før nedlasting: sammenlign endelig oppskrift og pakke-/testbevis med forespørselen. Noter build-ID, artefaktfilnavn, størrelse og checksum når de vises.
Bruk buildens nedlastingshandling først når artefaktfinalisering er fullført.
Nedlastingspakken kan inneholde ISO-en og relatert bevis. Hvis nedlasting returnerer
Failed to create download package, not found eller en annen JSON-feil:
- bekreft at du er innlogget som build-eier;
- åpne nøyaktig den builden igjen, ikke et eldre samtalekort;
- verifiser at artefaktfinalisering er fullført og at ISO er listet;
- prøv én gang til;
- rapporter build-ID, tidsstempel, viste build-/test-/finaliseringstilstander og nøyaktig feiltekst.
Ikke bygg på nytt bare for å omgå en ownership- eller pakkefeil; det kan kaste nyttig diagnostisk tilstand og bruke enda en build-plass.
6. Test ISO-en i tiltenkt kontekst
Boot i OpenFactorys VM verifiserer bare det konfigurerte virtuelle miljøet. For et installerbart skrivebord, test også installersporet på en engangsdisk. Ved fysisk utrulling, test separat firmware-modus, lagring, grafikk, nettverk, suspend, inndataenheter, oppdateringer og recovery på representativ hardware.
Vanlige gjenopprettingsveier
| Symptom | Handling |
|---|---|
| Oppskrift validerer, men utelater forespørsel | Ikke bygg; angi det manglende kravet eksplisitt og valider på nytt |
| Build står i kø | Behold build-ID og sjekk kø-/recovery-status; unngå dupliserte starter |
| Fremdrift virker uendret | Inspiser gjeldende stage og nylig loggaktivitet før du erklærer den fast |
| Build feiler | Les den første kausale feilen, ikke bare slutt-oppsummeringen; revider eller prøv igjen først når årsaken er klar |
| Tester feiler | Skill produktfeil, assertion-feil, guest-boot-problem og infrastrukturfeil |
| Nedlasting mangler eller nektes | Bekreft eiersession, finaliseringstilstand og nøyaktig build-ID før ombygging |