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.

Anza somo shirikishiSoma maelezo ya somo

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.

Faili za mazoezi

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

Start hereFaili za mazoezi

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.

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

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.

Endelea kujifunza

Angalia masomo mengine