Skip to Content
Getting StartedEsimene build

Esimene build

See juhend aitab luua, valideerida, käivitada ja üle vaadata ühe kohandatud pildi. Valideeritud retsept on konfiguratsiooni kontroll, mitte tõend, et ISO on ehitatud või et iga soovitud käitumine läbis VM testi.

Enne alustamist

  • Logige sisse, et vestlus ja build jääksid teie kontoga seotud.
  • Alustage ühe operatsioonisüsteemi ja väikese pakettide või teenuste komplektiga.
  • Otsustage, milline tõend kinnitaks, et taotlus on täidetud. Paketi olemasolu, teenuse olek, kuulav port ja GUI käitumine on erinevad kontrollid.

Esimesel katsel vältige vestluses mandaate ja privaatsete hoidlate URL-e. Salajased andmed lisage hiljem toetatud mandaatide töövoogu kaudu, mitte ei sisesta neid otse pildisse.

1. Sõnastage tulemus ja selle kontrollid

Näide:

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.

Selged välistused aitavad eristada tahtlikult minimaalset pilti taotlusest, mille plaanija lihtsalt märkamata jättis.

2. Vaadake retsepti eelvaadet üle

Kontrollige vähemalt:

  • base_image vastab soovitud jaotusele ja väljalasele;
  • soovitud paketid on os.packages all või tulevad selge funktsiooni kaudu;
  • kasutajad, grupid, teenused, võrk, installer ja töölaua valikud vastavad taotlusele;
  • scenarios sisaldavad teile tõesti vajalikke kontrolle;
  • pole lisatud taotlemata paketti, töölauda, installerit, mandaati ega välist hoidlat.

Muudatusi paluge samas vestluses. Järgnevad taotlused rakenduvad aktiivsele retseptile. Kui kasutate Validate Recipe, säilitab backend eelneva sisulise vestluse taotluse ja blokeerib retsepti, kui selged nõuded on endiselt puudu; genereeritud juhtlause ei tohi vestluse kavatsust kustutada.

Valideerimine võib siiski märkamata jätta kättesaamatut paketti, ülemise taseme katkestuse, jaotuse-spetsiifilise build vea või käitumise ilma testita. Lugege eelvaadet kui pakutavat lepingut.

3. Käivitage build üks kord

Valideeritud eelvaates valige Start Build. Edukas klõps loob build ID. Probleemist teatades hoidke seda ID-d; see on usaldusväärsem kui üksnes protsent või ekraanipilt.

Build paneel võib näidata olekuid nagu queued, planning, configured, building, finalizing, completed, failed või cancelled. Järjekorras build võib oodata töötaja mahutavust või käivituse taastumist. Kuvatud protsent on edenemise prognoos, mitte tähtaeg; mõned pakendamise ja failisüsteemi sammud võtavad palju kauem aega kui teised.

Buildi saate jälgida edasi otse build paneelis, isegi kui lahkute algsest vestluse vaatest. Lehe uuesti laadimisel peaks ühendus taastuma salvestatud build oleku ja sündmuste voogu kaudu. Ärge klõpsake Start Build korduvalt, välja arvatud juhul, kui UI teatab, et build ID-d ei loodud või eelmine build jõudis lõpliku olekusse.

4. Eraldage pildi valmimine testide valmimisest

Pilt võib valmida enne, kui valitud VM kontroll jõuab lõpliku olekusse. Lugege mõlemat:

  • build status: kas püsiv artefakt koostati ja finaliseeriti;
  • test status: not_run, running, passed, failed või error;
  • certification status, kui olemas: seadistatud tõenduspoliitika tulemus, mitte universaalne turva- või riistvarasertifikaat.

Avage testi detailid. Kinnitage, et iga taotletud kontroll jooksis oodatud külalise vastu, ja vaadake ebaõnnestumised või vahelejäetud kontrollid üle. Edukas käivitustest ei tõesta, et rakendus avaneb; paketi kirje ei tõesta, et teenus on terve.

5. Vaadake artefakt üle ja laadige alla

Enne allalaadimist võrrelge lõplikku retsepti ja paketi või testi tõendeid taotlusega. Salvestage build ID, artefakti failinimi, suurus ja kontrollsumma, kui need on näha.

Kasutage buildi allalaadimise toimingut alles pärast artefakti finaliseerimise lõppu. Allalaadimispaketis võivad olla ISO ja seotud tõendid. Kui allalaadimine tagastab Failed to create download package, not found või muu JSON vea:

  1. kinnitage, et olete sisse logitud buildi omanikuna;
  2. avage täpselt see build, mitte vanem vestluse kaart;
  3. kontrollige, et artefakti finaliseerimine on lõppenud ja ISO on loetletud;
  4. proovige üks kord uuesti;
  5. teatage build ID, ajatempli, kuvatud build, test ja finaliseerimise olekud ja täpne veatekst.

Ärge ehitage uuesti ainult omandiõiguse või pakendamise vea ümber; see võib hävitada kasuliku diagnostilise oleku ja tarbida veel ühe build pesa.

6. Testige ISO-d ettenähtud kontekstis

OpenFactory VM-is käivitamine kontrollib ainult seadistatud virtuaalkeskkonda. Installitava töölaua puhul testige lisaks installeri teed korduvkasutataval kettal. Fizilise juurutuse puhul testige eraldi püsivara režiimi, salvestust, graafikat, võrku, peatamist, sisendseadmeid, uuendusi ja taastumist esinduslikul riistvaral.

Levinud taastumisviisid

SümptomToiming
Retsept valideerub, kuid jätab taotluse vaheleÄrge buildige; sõnastage puuduv nõue selgelt ja valideerige uuesti
Build on järjekorrasHoidke build ID-d ja kontrollige järjekorra või taastumise olekut; vältige topeltkäivitusi
Edenemine tundub muutumatuEnne järeldamist, et on kinni, vaadake praegune etapp ja hiljutine logitegevus üle
Build ebaõnnestubLugege esimest põhjuslikku viga, mitte ainult lõplikku kokkuvõtet; muutke või proovige uuesti alles pärast põhjuse mõistmist
Testid ebaõnnestuvadEraldage toote defekt, kontrolli defekt, külalise käivitusprobleem ja infrastruktuuri viga
Allalaadimine puudub või on keelatudEnne uuesti ehitamist kinnitage omaniku seanss, finaliseerimise olek ja täpne build ID

Järgmised sammud