Skip to Content
Getting StartedDin første build

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_image matcher etterspurt distribusjon og release;
  • etterspurte pakker står under os.packages eller leveres av en eksplisitt feature;
  • brukere, grupper, tjenester, nettverk, installer og skrivebordsvalg matcher forespørselen;
  • scenarios inneholder 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, failed eller error;
  • 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:

  1. bekreft at du er innlogget som build-eier;
  2. åpne nøyaktig den builden igjen, ikke et eldre samtalekort;
  3. verifiser at artefaktfinalisering er fullført og at ISO er listet;
  4. prøv én gang til;
  5. 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

SymptomHandling
Oppskrift validerer, men utelater forespørselIkke 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 uendretInspiser gjeldende stage og nylig loggaktivitet før du erklærer den fast
Build feilerLes den første kausale feilen, ikke bare slutt-oppsummeringen; revider eller prøv igjen først når årsaken er klar
Tester feilerSkill produktfeil, assertion-feil, guest-boot-problem og infrastrukturfeil
Nedlasting mangler eller nektesBekreft eiersession, finaliseringstilstand og nøyaktig build-ID før ombygging

Neste steg