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_imagevastab soovitud jaotusele ja väljalasele;- soovitud paketid on
os.packagesall või tulevad selge funktsiooni kaudu; - kasutajad, grupid, teenused, võrk, installer ja töölaua valikud vastavad taotlusele;
scenariossisaldavad 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,failedvõierror; - 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:
- kinnitage, et olete sisse logitud buildi omanikuna;
- avage täpselt see build, mitte vanem vestluse kaart;
- kontrollige, et artefakti finaliseerimine on lõppenud ja ISO on loetletud;
- proovige üks kord uuesti;
- 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ümptom | Toiming |
|---|---|
| Retsept valideerub, kuid jätab taotluse vahele | Ärge buildige; sõnastage puuduv nõue selgelt ja valideerige uuesti |
| Build on järjekorras | Hoidke build ID-d ja kontrollige järjekorra või taastumise olekut; vältige topeltkäivitusi |
| Edenemine tundub muutumatu | Enne järeldamist, et on kinni, vaadake praegune etapp ja hiljutine logitegevus üle |
| Build ebaõnnestub | Lugege esimest põhjuslikku viga, mitte ainult lõplikku kokkuvõtet; muutke või proovige uuesti alles pärast põhjuse mõistmist |
| Testid ebaõnnestuvad | Eraldage toote defekt, kontrolli defekt, külalise käivitusprobleem ja infrastruktuuri viga |
| Allalaadimine puudub või on keelatud | Enne uuesti ehitamist kinnitage omaniku seanss, finaliseerimise olek ja täpne build ID |