Ku dhis wheel-ka Python meel ka baxsan shabakadda, gudaha ku daabac

Horey ayaad u haysataa shaqo dhisid oo soo saarta wheel, iyo keyd gaar ah oo ay tahay inuu helo. Khaladku waa inaad u ogolaato shaqo labaad inay dib uga dhiso laan oo natiijada ugu yeerto isla sii-deyn. U wareeji faylka la tijaabiyay, ku magacow digest-ka, oo hayso aqoonsiga gelinta gudaha. Sharaxaadda hoose waxay raacdaa hal artefact laga bilaabo CI runner dadweyne ilaa daabace gudaha ah.

Ku dhis meesha uu isha horey u joogo

Ku socodsii dhisidda shaqada horey u haysata isha, qalabka iyo jaantuska imtixaanka. Ma jiraan wax keyd gaar ah oo u baahan in shaqadaas gaarto. Ku rakib frontend-ka dhisidda deegaanka mashruuca horey u isticmaalo, kadib soo saar labada nooc ee qaybinta haddii mashruucu labadaba soo diro.

python -m build --sdist --wheel --outdir dist
python -m twine check dist/*

Ka dhig galka wax-soo-saarka mid yar oo hal-mar ah. Waxa kaliya ee mudan in la sii qaado waa faylalka shaqada xigta daabici doonto, iyo hash-yadooda. Wax kasta oo kale, oo ay ku jiraan deegaanada mala-awaalka ah iyo kaydka, dib ayaa looga dhisi karaa nuqulka isha ee la diiwaangeliyay. Artefact khafiif ah ayaa sidoo kale sahlan in la eego, sababtoo ah fayl kasta oo ku jira waa fayl qof ku eegi karo.

Diiwaangeli waxa soo saaray: magaca xidhmada iyo nooca laga helay magacyada faylalka, nuqulka isha, iyo socodsiinta workflow ee abuuray. Xarig nooc oo keliya ma aqoonsado fayl, sababtoo ah isla noocaas laba jeer ayaa laga dhisi karaa commit-yo kala duwan. Ku qor nuqulka ag magacyada faylalka sharaxaadda artefact-ka, oo u qaado diiwaankaas qayb ka mid ah wareejinta.

U wareeji baytayaasha, ee ha u wareejin tilmaamo dib-u-dhisid

Dhisid labaad waa badeeco labaad. Calaamadaha waqtiga, ku-tiirsanaanta la xidhay iyo noocyada qalabka ayaa dhammaantood beddeli kara baytayaasha, sidaas darteed dib-u-dhisid waxay u baahan tahay caddaynteeda imtixaan iyo dib-u-eegisteeda. Taa beddelkeeda sare u qaad faylalka la eegay.

U rar faylalka qaybinta keydka artefact-ka ee bixiso madaladaada CI, oo si shaqada gudaha ah tixraac artefact-kaas gaar ah halkii aad ka siin lahayd magaca laan.

sha256sum dist/*.whl dist/*.tar.gz
# keep the digests beside the run id in the artifact description

Haddii madaladaadu taageerto asal saxeexan, weydii inay caddeyso artefact-ka, kadibna xaqiiji keydka, workflow-ga iyo nuqulka isha ee la filayo. GitHub dokumentiga caddaynta wuxuu qeexaa sheegashooyin qaabkaas ah. Saxeex sax ah waa caddayn asal, ma aha baaritaan dayac-tir ah mana aha go'aan oggolaansho.

Gudaha ku xaqiiji ka hor intaadan rarin

Shaqada gudaha waxay ku bilaabataa hubinta in faylka la helay uu yahay faylkii la ansixiyay. Isbarbar dhig digest-yada diiwaanka shaqada dhisidda, ee ha isbarbar dhiggin qiime laga dib-u-xisaabtay waxa yimid.

sha256sum -c digests.txt
python -m twine check dist/*

Kadib akhri metadata-ga. Magaca xidhmada, nooca iyo ku-tiirsanaanta la sheegay waa inay la mid noqdaan dib-u-eegista aad ansixisay. Wheel magaciisu sax u eg yahay laakiin ku-tiirsanaantiisa isbeddelay waa xidhmo kale oo isla calaamadda qaba. Haddii metadata-gu dhaqaaqay, u qaado artefact-ka mid aan la ansixin oo ogaaw dhisiddee soo saartay.

Haddii digest-yadu aanay isku mid ahayn, joogso. Ha rarin, hana ku hagaajin faylka adigoo meeshaas dib u dhisaya; taasi waxay tirtiraysaa caddaynta in wax isbeddelay jidka. Ismaandhaafku waxay la macne tahay in keydka artefact-ka, tallaabada soo dejinta ama diiwaanku khaldan yahay, oo mid kastaa sharaxaad buu mudan yahay ka hor inta aan sii-deyn la daabicin.

La macaamil jawaabta nooca labanlaaban

Keydada gaarka ah badanaa diidaan inay dib u qoraan nooc horey u jiray, oo diidmadaas waa sifo. Marka rarista ku guuldareysto sababtoo ah nooca wuu jiraa, baadh diiwaanka keydka ee noocaas oo isbarbar dhig faylalka uu hayo iyo digest-yada aad rabtay inaad daabacdo.

Nooc jira macnaheedu wuxuu noqon karaa in raris hore guuleystay oo jawaabtii lumay, ama in qof ku daabacay wax kale isla lambarkaas.

Ha tirtirin nooca, hana abuurin lambar cusub si aad uga gudubto khaladka. La go'aanso milkiilaha sii-deynta in waxa kaydsan la aqbali karo, kadib diiwaangeli natiijada. Haddii waxa ku jiraa kala duwan yahay, waxaad haysataa dhibaato nooc-bixin, ma aha dhibaato pipeline.

Aqoonsiga gelinta ku hay dhinac keliya

Kaliya daabacaha gudaha ayaa u baahan aqoonsiga keydka, iyo kaliya inta rarista socoto. Ku xaddid token-ka keydka bartilmaameedka iyo hawlgallada rarista, ku hay keydka sirta ee nidaamka gudaha, oo ka tag gebi ahaan baxsan shaqada dhisidda. Haddii shaqada dhisidda ay daabici karto, markaas qof kasta oo beddeli kara dhisidda ayaa daabici kara.

Sidoo kale xaddid workflow-yada gudaha ee kici kara daabacaha. Kiciye gacan-ku-shaqeyn leh oggolaansho loo baahan yahay waa caadi macquul ah sii-deynta; riixid laan kasta ma aha.

Sii-deynta dhammaatay waa inay ka tagto saddex wax: faylalka qaybinta, digest-yadooda oo la socda nuqulka isha, iyo diiwaan keyd oo muujinaya isla noocaas.