
Somo fupi · Kiswahili
Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
Fanya mazoezi ya kurejesha toleo linalojulikana kufanya kazi kwenye tovuti ya kutupwa, kisha hakiki kitendo cha mgeni kinafanya kazi tena kweli.
Somo hili ni la nani?
Kwa watu wanaotaka njia tulivu ya kurejesha uchapishaji ulioharibika. Unaweza kutumia vidhibiti vya matoleo vya mtoa huduma na msaidizi wa programu; hati za uchapishaji ni za hiari.
Kabla ya kuanza
Unahitaji mradi mpya wa kupangisha unaoweza kufutwa na kurasa zinazofanya kazi/zilizovunjika zilizotolewa. Kwanza utachapisha R1 inayofanya kazi, kisha R2 iliyovunjika kwa makusudi kwenye tovuti hiyo pekee. Msaidizi aongoze hatua; usitumie huduma halisi yenye watumiaji kwa mazoezi haya.
Muda unaokadiriwa: 19–31 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Vidhibiti vya hosting hutofautiana. Kurudisha msimbo tuli kwenye toleo la awali hakutengui mabadiliko ya hifadhidata, barua zilizotumwa, malipo au kufichuliwa kwa siri.
Utakachojifunza
- Chagua toleo lililothibitishwa kufanya kazi.
- Lirejeshe kupitia zana za upangishaji.
- Kagua jukumu la mgeni na uzuie kurudiwa mara moja.
Hatua 1
Chagua toleo linalojulikana kufanya kazi
Toleo la awali lina manufaa tu ikiwa lilifanya jukumu lililokusudiwa.
Msaidizi achapishe working/public kama R1 kwenye tovuti mpya ya kufutika. Fungua URL ya umma, soma R1 na ubonyeze “Find contact information”. Hifadhi kitambulisho cha uchapishaji/toleo ambacho kiungo chake kinafikia Contact.
Kwenye tovuti hiyo hiyo pekee, chapisha broken/public kama R2. Rudia tendo: R2 inalenga sehemu isiyopo. Weka kitambulisho chake pembeni ya R1 iliyojulikana kufanya kazi. Sasa kuna kosa halisi la zoezi na toleo maalumu la kurudisha.
Mfano halisi
Kiungo cha R1 kinalenga #contact iliyopo. R2 kinalenga #contact-missing. Umri wa toleo si unaofanya R1 ifae; kazi ya Contact inafaulu huko.
Tumia mradi wangu mpya wa zoezi wa kufutika tu. Chapisha working/public kama R1 na nisaidie kukagua mawasiliano na kuhifadhi kitambulisho cha deploy. Nikithibitisha lengwa, chapisha broken/public kama R2 humo tu na urudie kosa la mawasiliano. Kisha nisaidie kurudisha artefakti R1 ileile kwa mwenyeji, kurudia tendo na kuzuia chanzo kibovu R2 kuchapishwa mara moja tena. Usiguse tovuti nyingine, data halisi au huduma ya uzalishaji.Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Tengua deployment iliyoharibika bila kubahatisha
Rejesha toleo lililokamilisha kweli kazi ya mgeni iliyoathiriwa.
Kurejesha huanza na tatizo la mtumiaji, si hamu isiyo wazi ya kurudi tarehe ya zamani. Warsha huharibu kiungo cha sehemu ya mawasiliano katika R2 huku R1 ikiwa na lengo sahihi.
Hosting inaweza kukuruhusu kuchapisha upya deployment ya awali iliyojengwa tayari kwa haraka. Hiyo hurejesha faili zake za msimbo, lakini tawi la Git linaweza bado kuwa na chanzo kibovu. Tenganisha kurejesha huduma mara moja na kurekebisha tatizo kudumu.
Mfano uliotatuliwa
Ukurasa wa R2 unaweza kupakia kwa hali 200 huku kitendo cha mawasiliano kikishindwa. Ukaguzi wa afya unaofungua ukurasa mkuu pekee utakosa hitilafu hiyo.
Extra implementation exercise
Ni ushahidi upi unaofanya R1 kuwa chaguo linalofaa la kurudi nyuma?
Onyesha mfano wa suluhisho
Ni deployment inayojulikana kuwa kazi yake ya mawasiliano inafanya kazi, ikiwa na faili/toleo lililotambuliwa. “Ya zamani” pekee haithibitishi kuwa toleo linafaa.
- Anakagua kazi maalumu iliyoshindwa katika R1.
- Anatambua toleo halisi lililochapishwa.
Kosa linalofanywa mara nyingi
Kuchagua deployment ya zamani bila mpango kwa sababu wakati wake unafaa.
Hatua 2
Rejesha kwa mtoa huduma wa mazoezi
Tumia kidhibiti cha tovuti ya kutupwa iliyokusudiwa.
Hakiki jina la mradi na alama R2 iliyovunjika na msaidizi. Kwenye historia ya uchapishaji chagua artefakti R1 na kitendo cha kurudisha/kuchapisha tena kinachosaidiwa. Tendo linabadilisha tovuti, si historia ya chanzo kwenye hazina.
Mwenyeji akimaliza, fungua URL halisi ya umma tena. Kagua R1 na urudie “Find contact information”; alama ya mafanikio haielezi kama kivinjari kiko kwenye tovuti sahihi.
Mfano halisi
Mwenyeji akisema R1 lakini anwani bado ina R2, linganisha mradi, URL na artefakti kabla ya kutangaza kurudi kumekamilika.
Netlify: kusimamia deployment na kurudisha matoleo
Jaribu mwenyewe
Mtoa huduma alirejesha toleo lipi, na anwani ya umma ilionyesha nini baadaye?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Matokeo ya mfano: Nilichagua R1 iliyohifadhiwa kwenye mradi; URL ya umma sasa ina Version R1 na “Find contact information” inafika Contact. URL ikibaki R2, kurudisha bado hakujatatuliwa hata mwenyeji akiwa na alama ya mafanikio.
- Anataja artefakti R1 iliyochaguliwa na kuthibitisha mradi wa kufutika unaolengwa.
- Anakagua alama R1 ya umma na tendo lililokuwa likishindwa baada ya kurudisha.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Fanya mazoezi ya rollback katika mradi unaoweza kuondolewa
Tumia historia ya deployment kuchapisha faili za toleo linalojulikana kufanya kazi.
Fuata START-HERE.txt kwenye hosting yako ya mazoezi pekee. Rekodi R1, chapisha hitilafu ya makusudi R2 na uonyeshe kazi ya mawasiliano iliyoharibika. Kisha pata R1 kwenye historia na utumie kitendo cha hosting cha kuchapisha/kurudisha toleo.
Kagua URL ya umma inayopatikana na alama ya toleo baada ya kitendo kukamilika. Violesura na ruhusa za hosting hutofautiana; soma mwongozo wa sasa badala ya kutegemea eneo la zamani la kitufe.
Mfano uliotatuliwa
Ukurasa wa umma lazima sasa uonyeshe R1 na kiungo cha mawasiliano kifike sehemu halisi. Kitendo cha dashibodi pekee si ukaguzi kamili wa kurejesha huduma.
Netlify: kusimamia deployment na kurudisha matoleo
Extra implementation exercise
Dashibodi inasema deployment ya awali imechapishwa. Ukague nini kinachofuata?
Onyesha mfano wa suluhisho
Hakikisha faili/toleo la umma na urudie kitendo cha mawasiliano. Rekodi matokeo badala ya kudhani kufaulu kwa kitendo cha usimamizi kunathibitisha huduma imerudi kwa mtumiaji.
- Anafungua URL/toleo halisi la umma.
- Anarudia kazi iliyokuwa ikishindwa.
Kosa linalofanywa mara nyingi
Kufunga tukio mara tu kitufe cha rollback kinapofaulu.
Hatua 3
Zuia kushindwa kulekule kurudi
Urejeshaji na kurekebisha uchapishaji unaofuata ni kazi tofauti.
Rudia Contact kwenye R1 iliyorudishwa. Kisha msaidizi akague hazina: kiungo R2 kibovu kinaweza bado kuwepo ingawa mwenyeji anatoa artefakti ya zamani inayofanya kazi.
Msaidizi arekebishe lengwa baya kwenye hazina na mkague badiliko kabla ya kuchapisha baadaye. Dhibiti uchapishaji wa moja kwa moja wa chanzo ambacho bado kibovu kwa njia inayopatikana kwa mwenyeji; usidhani kurudisha artefakti kunaandika Git upya.
Mfano halisi
Suluhisho la kudumu linafanya kiungo kilingane tena na Contact iliyopo. Ni badiliko tofauti la chanzo na kuchapisha tena artefakti R1 iliyojengwa tayari.
Jaribu mwenyewe
Nini kilifanya jukumu la mgeni lifanye kazi tena, na nini kinazuia toleo lililovunjika kurudi?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Kuchapisha tena R1 kulirudisha kazi ya Contact. Kuzuia kurudia, ningemwomba msaidizi abadili #contact-missing iwe #contact, nikague diff hiyo ndogo na mwonekano unaofuata kabla ya kuruhusu kuchapisha tena. Rollback ya mwenyeji pekee haitengenezi chanzo hicho.
- Anatenganisha kurudisha kwa mwenyeji mara moja na kurekebisha chanzo kibovu kwenye hazina.
- Anataja jinsi uchapishaji unaofuata utakavyoepuka kurudisha kosa la Contact la R2.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Rekebisha chanzo na utathmini athari zilizobaki
Zuia build inayofuata ya kiotomatiki isirudishe hitilafu ileile.
Tawi linalotumika kuchapisha tovuti ya umma (production branch) linaweza bado kuwa na msimbo wa R2. Lirekebishe kwa badiliko la chanzo lililohakikiwa na udhibiti uchapishaji wa kiotomatiki wakati wa kurejesha kama hosting inavyoruhusu. Vinginevyo deployment inayofuata inaweza kurudisha hitilafu.
Rollback ya msimbo hairejeshi rekodi zilizofutwa wala kutengua ujumbe au makato ya pesa. Badiliko la schema ya hifadhidata pia linaweza kufanya msimbo wa zamani usilingane. Chunguza athari hizo kando kabla ya kurudisha toleo katika programu halisi yenye data inayobadilika.
Fikiria R2 inaondoa safu wima (column) ya hifadhidata ambayo R1 bado inasoma. Kuchapisha msimbo wa zamani wa R1 hakuundi tena safu hiyo wima, hivyo rollback bado inaweza kushindwa. Kagua kwanza ulinganifu wa hali na schema. Katika zoezi hili tuli, marekebisho ni madogo: badilisha href='#contact-missing' kurudi href='#contact', hakiki tofauti na uhakikishe tawi lililorekebishwa kabla ya uchapishaji ujao wa kiotomatiki.
Mfano wa hifadhidata unaeleza mpaka wa rollback katika programu yenye hali inayohifadhiwa; warsha yenyewe hubadilisha faili tuli pekee na haiombi vitendo vya hifadhidata. Ukijifunza peke yako, fuata mwongozo katika dirisha jipya la kivinjari na uusome kama maelekezo ya mtu ambaye hakuandika badiliko.
Mfano uliotatuliwa
Kurejesha ukurasa wa fomu wa zamani hakuwezi kurudisha barua iliyokwisha kufikishwa na toleo jipya. Taarifa za ufikiaji zikivuja, rollback pekee haizibatilishi pia.
Extra implementation exercise
Rollback inarejesha ukurasa lakini commit mbovu inabaki kwenye tawi la uzalishaji. Ni hatari ipi inabaki?
Onyesha mfano wa suluhisho
Build ya baadaye inaweza kuchapisha hitilafu tena. Rekebisha au tengua badiliko la chanzo kupitia mchakato wa kawaida wa uhakiki, na uhakikishe toleo jipya kabla ya kuruhusu deployment bila uangalizi.
- Anatarajia kuchapishwa tena kiotomatiki kwa chanzo kibovu.
- Anapanga marekebisho na uthibitishaji wa chanzo.
Kosa linalofanywa mara nyingi
Kudhani rollback ya deployment pia huandika upya historia ya Git na hali ya huduma za nje.
Hatua 4
Andika makabidhiano ya urejeshaji
Rahisisha kuelewa tukio linalofuata.
Kamilisha recovery-record.txt kwa kosa la R2, kitambulisho R1, kurudisha kwa mwenyeji na ukaguzi mpya wa Contact ya umma. Ongeza suluhisho la hazina au hatua kamili iliyobaki.
Zoezi hili linarudisha msimbo tuli wa tovuti. Halirudishi mabadiliko ya hifadhidata, barua zilizotumwa, gharama au siri zilizovuja; kila moja ingehitaji hatua yake katika tukio halisi.
Mfano halisi
Hadithi fupi ya kurudisha ni: lengwa R2 halikuwepo → R1 inayojulikana kufanya kazi ikachapishwa tena → Contact ya umma ikafanya kazi → chanzo kikarekebishwa na kukaguliwa kabla ya toleo lingine.
Jaribu mwenyewe
Vifaa vya kuanzia
Faili na maudhui ya majaribio yametolewa. Uthibitishaji halisi bado unahitaji akaunti, barua au kikoa chako kama masharti yanavyoeleza. Unaweza kuchunguza ndani ya kompyuta; andika hatua za mtandaoni ambazo hujafanya kama hazijajaribiwa.
Toa rekodi ya urejeshaji na ukaguzi halisi wa jukumu lililorejeshwa.
Unachopaswa kuandaa Rekodi ya urejeshaji yenye toleo lililorejeshwa, matokeo halisi ya jukumu na hatua ya kuzuia.
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: R2 ilionekana kawaida lakini Contact haikuwa na lengwa. Nilirudisha artefakti R1 iliyorekodiwa na kazi ya umma ikafaulu. Lengwa la hazina bado lilihitaji suluhisho na ukaguzi kabla ya kuchapisha. Kurudisha hifadhidata, barua au malipo hakukuwa sehemu ya zoezi hili tuli.
- Anaunganisha R2 iliyoshindwa, artefakti R1 iliyorudishwa na jaribio halisi la tendo la umma.
- Anajumuisha kuzuia kurudia na kutofautisha kurudisha msimbo dhidi ya data au athari za nje.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Kazi yako: andika na uthibitishe mwongozo mfupi wa kurejesha
Fanya urejeshaji unaofuata uweze kufanywa na mtu ambaye hakuandika badiliko.
Jaza rekodi ya kurejesha kwa vitambulisho halisi vya deployment/chanzo, kazi iliyoshindwa, kitendo cha rollback na ukaguzi unaoonekana kwa mtumiaji. Jumuisha marekebisho ya chanzo na hali yoyote iliyo nje ya wigo wa rollback.
Mwombe mtu mwingine afuate hatua zilizoandikwa kwenye tovuti ya mazoezi au uzipitie katika kivinjari kipya. Ondoa makisio kama “bofya ile ya zamani” yanayoeleweka kwako tu.
Mfano uliotatuliwa
Mwongozo wenye manufaa unasema toleo la kuchagua na namna ya kujua huduma imerudi. Orodha ya mibofyo ya dashibodi bila jaribio la kazi si imara.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Extra implementation exercise
Tengeneza rekodi ya kurejesha inayorudisha kazi ya jaribio na kuzuia kurudia mara moja.
Onyesha mfano wa suluhisho
Kwenye tovuti ya mazoezi, onyesha hitilafu ya mawasiliano ya R2 na urekodi ID/commit ya deployment. Katika historia, pata rekodi ya R1 inayojulikana kufanya kazi, kagua faili/toleo lake na uchague kitendo cha mtoa huduma cha kuchapisha/rollback kwa rekodi hiyo.
Fungua URL halisi ya umma, soma R1 na urudie kitendo cha mawasiliano. Kisha rekebisha chanzo kibovu kwa kurejesha href='#contact'; hakiki na uweke badiliko kwenye commit kabla ya kuruhusu uchapishaji ujao wa kiotomatiki.
Tenganisha kurejesha msimbo na kurejesha data. Ikiwa toleo jipya liliondoa safu wima (column) inayohitajika na msimbo wa zamani, kuchapisha HTML/JS ya zamani hakuirudishi. Rekodi ya marejeo ya tukio hutaja kazi iliyorejeshwa, marekebisho ya chanzo na hali iliyo nje ya wigo wa rollback.
- Toleo lililorejeshwa linafaulu kazi ileile iliyoshindwa.
- Marekebisho ya chanzo na athari zilizo nje ya msimbo zimeshughulikiwa wazi.
Kosa linalofanywa mara nyingi
Kuandika maagizo ya kurejesha baada tu ya kusahau deployment ipi ilitatua tatizo.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuwaruhusu watumiaji kupakia picha
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
- Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kupokea malipo kwenye tovuti yako
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma