Isomo rigufi · Kinyarwanda

Uko wasohora urubuga rwawe uhereye kuri GitHub

Shyira urupapuro watanzwe ku karubanda ukoresheje ububiko bwa GitHub bw'umwitozo, ugenzure ko impinduka ikurikiyeho igera ku rubuga rusange.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka gushyira urubuga kuri interineti no kuruvugurura mu buryo bwizewe. Dosiye z'urubuga ziteguye ziratanzwe; ushobora gukoresha GitHub Desktop n'umufasha wo kwandika kode utanditse amabwiriza ya Git.

Mbere yo gutangira

Konti zawe za GitHub na Netlify, na GitHub Desktop cyangwa uburyo bungana na bwo. Koresha ububiko bwa kode n’umushinga wo kwakira urubuga byihariye byo kwitoza. Urupapuro P1 watanzwe rurakora n’iyo utarize isomo ry’urubuga rwawe. Ibisubizo by’icyitegererezo si amagerageza yakorewe kuri konti yawe. Simbuza ibyo byabonetse n’ibyo wiboneye cyangwa uvuge intambwe ikiguhagaritse.

Igihe kigereranyijwe: 21–33 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Igereranya ry'igihe ntiririmo kwinjiza GitHub Desktop, kugera kuri konti n'imirongo y'abategereje build. Ikoreshwa rya hosting riterwa na konti yawe.

Ibyo uziga

  • Huza ububiko bw'umwitozo na serivisi yakira imbuga.
  • Shyira impinduka igaragara ku karubanda ugenzure ibivuyemo ku rubuga rusange.
  • Menya icyiciro cyananiranye igihe urupapuro rusange rutaravuguruka.

Dosiye z'imyitozo

Intambwe 1

Tegura urupapuro ushobora kumenya

Koresha urubuga rwa P1 rwiteguye aho kubanza guteranya urubuga.

Fungura dosiye z’umwitozo, ubike index.html, style.css, netlify.toml na .gitignore mu bubiko bumwe bw’umushinga. Fungura index.html kuri mudasobwa yawe urebe urupapuro rwa P1, hanyuma usabe umufasha wo kwandika kode gushyira izo dosiye mu mizi y’ububiko bwihariye bwo kugerageza.

Urupapuro rugomba kwerekana Portfolio version P1. Hitamo ububiko bwa kode n’umushinga wo kwakira urubuga byo kwitoza, wemeze ko atari urundi rubuga nyarwo ruri gukoreshwa.

Urugero rufatika

Koresha ububiko bumwe bw’umwitozo burimo index.html, style.css, netlify.toml na .gitignore. Ikimenyetso Portfolio version P1 ku rupapuro rwa mbere kizagufasha kumenya iyo verisiyo ya mbere nyuma.

Koresha urubuga rwa P1 na dosiye zo kurushyira ku karubanda watanzwe. Mfasha kuzishyira ku mizi y'ububiko butandukanye bw'umwitozo nkoresheje GitHub Desktop, dusuzume impinduka turebe ko nta dosiye z'ibanga zirimo, duhuze ububiko n'umushinga wanjye wa Netlify w'umwitozo. Banza umbaze mbere yo gushyira ku karubanda. Sobanura uko nemeza P1 ku rupapuro rusange, hanyuma umfashe gushyira impinduka nto ya P2 ku karubanda ntuhindure urubuga rusanzwe rukora.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Shyira urubuga rwawe ku murongo uhereye kuri GitHub

Gusohora bikoporora kuri host kopi ya dosiye zawe yanditswe ku gihe runaka (verisiyo) kugira ngo abandi bantu bashobore kuzisaba.

Urupapuro rwawe rwo kuri mudasobwa, ububiko bwa GitHub na deploy ya hosting ni ahantu hatatu hatandukanye. Kubika dosiye kuri mudasobwa ntibihita bivugurura urupapuro rwa rusange. Commit ibika verisiyo, ni ukuvuga uko dosiye zari zimeze ku gihe runaka; host ihujwe ishobora gusohora iyo verisiyo.

Kuri iri somo koresha umushinga mushya wo kwitoza. Menya ko ububiko burimo urupapuro rw'ibanze nyarwo na stylesheet, aho kuba ububiko bubikubiyemo bufite n'izindi dosiye zidafitanye isano.

Kugira ngo ugenzure verisiyo ukoresheje ikimenyetso kigaragara, ongeraho igika «Portfolio version P1» mbere ya commit ya mbere. Mu mukoro usoza gihindure P2 hamwe n'impinduka yawe ifatika y'ibirimo. Icyo kimenyetso kigufasha kugereranya dosiye kuri mudasobwa, commit ya kure n'urupapuro rwasohowe udakeka kopi ifunguye.

Urugero rusobanuye

Alex yongera imvugo igaragara «Portfolio version P1» ku rupapuro. Iyo mvugo na commit ID yayo bituma dutandukanya deploy yagenze neza na mushakisha ikigaragaza verisiyo ya kera.

Extra implementation exercise

Wabitse P1 kuri mudasobwa, ariko urupapuro rucumbikiwe ruracyavuga P0. Ni izihe ntambwe ebyiri zo gusohora zishobora kuba zitarakorwa?

Erekana igisubizo gisobanuye

Banza urebe ububiko bwa kode, hanyuma inyandiko ya deploy ya host. Kongera gupakira urupapuro muri mushakisha ntibishobora gusohora impinduka itigeze igera kuri host.

  • Hasuzumwa niba impinduka yarakorewe commit kandi ikoherezwa na push.
  • Hasuzumwa niba deploy yagenze neza yarakoresheje iyo commit.

Intambwe 2

Suzuma impinduka uzohereze kuri GitHub

Genzura urutonde rwa dosiye mbere yo kuzijyana ku karubanda.

Muri GitHub Desktop, suzuma dosiye zahindutse uri kumwe n'umufasha wawe. Kora commit ya dosiye z'urubuga ugamije hanyuma ukore push y'ishami ry'umwitozo umaze kwitegura. Ntushyire dosiye z'igenamiterere ry'ibanga n'amabanga ya konti mu bubiko.

Fungura ububiko kuri GitHub wemeze ko urupapuro rw'ibanze ugamije ruri ku mizi yabwo. Niba dosiye y'ibanga igaragara mu mpinduka, yikuremo mbere yo kohereza ikintu icyo ari cyo cyose.

Urugero rufatika

Gereranya urutonde rwa dosiye zahindutse mbere yo kuzohereza. index.html na style.css ni iz’urupapuro rusange; dosiye y’ibanga .env si iyo gushyiramo. Nyuma yo kohereza genzura dosiye zo ku bubiko bwa kure aho kwibwira ko kubika kuri mudasobwa byageze kuri GitHub.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Shyira dosiye zikwiye mu bubiko bwa kode

Kora commit y'itsinda rito rya dosiye za rusange z'urubuga, hanyuma usuzume iryo tsinda mbere ya push.

Inzira y'urugero: kora ububiko bwo kwitoza kuri GitHub, hanyuma ukoreshe File → Clone repository muri GitHub Desktop kugira ngo ubukoporore mu bubiko bushya kuri mudasobwa. Banza wongereho .gitignore yatanzwe mu bubiko bwakoporowe. Hanyuma ukopororemo gusa dosiye zawe za rusange z'urubuga, ugumisha index.html ku mizi, kandi usuzume impinduka mbere yo kuzishyira muri staging/gukora commit.

Muri GitHub Desktop, suzuma urutonde rwa Changes na diff, wandike incamake ya commit, ukore commit ku ishami wagambiriye, hanyuma uhitemo Push origin. Niba ahubwo handitse Publish branch, sohora iryo shami kuri remote. Urugero rw'amategeko ruri hasi ni ubundi buryo bwo gukoresha clone isanzwe yatangijwe. Itegeko rya Git ignore ntirikuraho ibanga ryari ryaramaze gukorerwa commit. Niba ushyize hanze urufunguzo nyarwo ku bw'impanuka, ruteshe agaciro kandi ukosore ububiko bwa kode; gusiba dosiye iriho gusa ntibihagije.

Urugero rusobanuye

Urutonde rw'amategeko rushyira muri staging dosiye z'urubuga zavuzwe aho gushyiramo buri dosiye yo kuri mudasobwa. Hanyuma rwerekana impinduka zashyizwe muri staging kugira ngo ugenzure ibyo commit irimo.

git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"

Extra implementation exercise

Diff yawe iri muri staging irimo .env ifite urufunguzo rwa serivisi. Ni iki ukwiye gukora mbere ya push?

Erekana igisubizo gisobanuye

Kura dosiye mu zatoranyijwe gushyirwa muri commit ikurikira (staging), uyirinde kujya muri Git ibika amateka ya verisiyo za dosiye kandi wongere usuzume diff. Niba urufunguzo rwarageze kuri remote cyangwa ku bandi, ruteshe agaciro aho kwibwira ko itegeko rya ignore rwarugize ibanga.

Mbere ya push, ongera usuzume diff iri muri staging. Niba ubu bubiko bwari busanzwe bufite commits, suzuma amateka cyangwa remote bisanzwe urebe ibyangombwa byo kwinjira udakoporoye agaciro kabyo muri raporo. Simbuza urufunguzo nyarwo rwose rwashyizwe hanze; kongeraho .gitignore ntibishobora gusiba ibyari byaramaze gutangazwa.

  • Dosiye y'ibanga ikurwa mu mpinduka ziri muri staging.
  • Hasuzumwa niba ibyangombwa byo kwinjira byaramaze gushyirwa hanze kandi bigasimbuzwa niba bikenewe.

Intambwe 3

Huza ububiko na serivisi yakira urubuga

Reka serivisi yakira urubuga itangaze ububiko burimo urupapuro rw'ibanze.

Kora cyangwa uhitemo umushinga wawe utandukanye wa Netlify w'umwitozo, uwuhuze n'ububiko n'ishami bigamijwe. Kuri uru rubuga rusanzwe watanzwe, koresha igenamiterere ryo kurutangaza rwatanzwe; nta kubaka ukoresheje framework bikenewe.

Tegereza serivisi yakira urubuga itangaze ko kurushyiraho byagenze neza. Fungura URL rusange yarwo mu idirishya ry'ibanga ushake P1; ikimenyetso cyo gutsinda ku kibaho cy'igenzura gusa nticyemeza ko ari urupapuro rukwiye.

Urugero rufatika

Urupapuro rwo kuri mudasobwa: P1. GitHub: P1. Serivisi yakira urubuga ivuga ko rwatangajwe, ariko URL rusange yerekana 404. Igikurikira ni ukureba niba serivisi itangaza ububiko burimo index.html koko.

Netlify: gukora deploy

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Huza host kandi uhitemo ububiko bwo gusohora

Host ikeneye kumenya ububiko bwa kode ikoresha n'ububiko burimo dosiye za rusange.

Muri konti yawe ya Netlify kora umushinga mushya uhereye ku bubiko bwo kwitoza kandi uhitemo ishami rya production ryagenewe. Emera gusa uburenganzira ku bubiko ukeneye. Kuri HTML isanzwe, siga build command irimo ubusa kandi usohore imizi y'ububiko bwa kode.

netlify.toml yatanzwe igaragaza iyo mizi mu buryo bweruye. Umushinga wa framework wakoresha ahubwo dosiye framework yubaka; ntukoporore iri genamiterere mu wundi mushinga utagenzuye imiterere yawo.

Suzuma igiti cy'ububiko mbere yo kugena host: imizi y'ububiko bwa kode → index.html na style.css. Kuri iyi nzira ya HTML isanzwe, publish='.' no kutagira build command birajyana. Ububiko bwa kode y'umwimerere bwa framework ntibuhita buba ububiko bwayo bwo gusohora; amabwiriza yayo yo kubaka ni yo agena aho dosiye zivamo zijya.

Urugero rusobanuye

Niba imizi yawe irimo index.html, gusohora «.» bitanga iyo dosiye nk'urupapuro rw'ibanze. Gusohora ububiko butarimo urupapuro rw'ibanze rwubatswe bishobora gutanga deploy ifite 404 ku mizi yayo.

[build]
  publish = "."

Netlify: gukora deploy

Extra implementation exercise

Deploy irangiye neza, ariko urupapuro rwayo rw'ibanze ni 404. Ni iyihe dosiye n'igenamiterere ugomba kugereranya?

Erekana igisubizo gisobanuye

Emeza ko ububiko bwo gusohora bwatoranyijwe burimo index.html. Kohereza byagenze neza ntibyemeza ko ububiko bukwiye ari bwo bwoherejwe.

  • Haboneka index.html mu bubiko bwa kode cyangwa mu dosiye nyazo zavuye muri build.
  • Aho iri hagereranywa n'ububiko bwo gusohora.

Intambwe 4

Kurikirana urupapuro rusange rutaravuguruka

Gereranya ububiko bwa kode, ibyanditswe na serivisi yakira urubuga n'ibigaragara muri mushakisha.

Hindura gato ibirimo ushyire ikimenyetso P2 ku rupapuro ufatanyije n'umufasha. Bika, ukore commit na push, hanyuma usuzume ishyirwa kuri serivisi rijyanye na byo. Gumana inyandiko ya P1 yo kugereranya.

Genzura verisiyo iri kuri GitHub, iyo serivisi yakira urubuga yashyizeho n'ibigaragara kuri URL rusange yasabwe. Kuvugurura mushakisha ntibishobora kohereza impinduka itarakorewe push.

Urugero rufatika

GitHub P2 → serivisi yakira urubuga P1 → urupapuro rusange P1 byerekana ikibazo mu cyiciro cyo gutangaza. GitHub P2 → serivisi P2 → urupapuro rusange P1 bisaba kugenzura URL yasabwe n’igisubizo cyatanzwe. Urupapuro rusa n’urushaje rushobora guterwa n’impamvu zitandukanye.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Huza urupapuro ruri ku murongo na commit yarwo

Genzura verisiyo yasohowe n'imikoreshereze y'usura, aho kureba gusa ikimenyetso kibisi cya deploy.

Fungura URL ya rusange yatanzwe na host mu idirishya ry'ibanga rya mushakisha. Emeza ko urupapuro rw'ibanze na stylesheet bifunguka nta session yawe ya nyir'urubuga. Kanda amahuza akujyana mu bindi bice by'urubuga kandi ugenzure ikimenyetso cya P1.

Gereranya commit host yanditse na commit nshya wagambiriye yo mu bubiko bwa kode. Urupapuro rushaje rushobora guturuka kuri deploy ya kera, ishami ritateguwe cyangwa cache. Koresha ibyo wabonye uhitemo igenzura rikurikiraho.

Urugero rusobanuye

Inyandiko y'ingirakamaro irimo commit, URL ya deploy n'ikimenyetso kigaragara. Niba deploy yerekana commit ya P1 ariko urupapuro rukarimo P0, suzuma URL yasabwe n'igisubizo mbere yo guhindura igenamiterere rya build iryo ari ryo ryose.

Extra implementation exercise

Ububiko bwa kode burimo P2, ariko inyandiko ya deploy yerekana commit ya P1. Iki ni ikibazo cyo kongera gupakira urupapuro muri mushakisha ahanini?

Erekana igisubizo gisobanuye

Oya. Suzuma impamvu host itasohoye commit ya P2. Banza wemeze ko verisiyo wagambiriye yasohowe koko mbere yo gusuzuma cache ya mushakisha.

  • Hagaragazwa ko P2 itarasohorwa.
  • Hasuzumwa ishami ryatoranyijwe n'igisubizo cya build iheruka.

Intambwe 5

Tangaza P2 ku karubanda uyigenzure

Soza ufite ivugurura nyaryo ku karubanda ushobora kumenya.

Shyira impinduka ya P2 ku karubanda unyuze mu nzira imwe y'umwitozo. Fungura aderesi ya nyuma utinjiye muri konti ugerageze ihuza cyangwa ibirimo byahindutse. Gumana ibiranga impinduka n'ishyirwa kuri serivisi bya P1 na P2 byatanzwe n'ibikoresho.

Genzura ikimenyetso n'igice cyahindutse koko, ntushingire gusa ku kimenyetso kibisi cy'ishyirwa kuri serivisi. Vuga intambwe yose utashoboye kurangiza.

Urugero rufatika

Inyandiko nziza ya P2 ihuza ibintu bitatu: impinduka ijyanye na yo mu bubiko bwa kode, inyandiko ya serivisi n’interuro nshya igaragara. Ikimenyetso kibisi cya serivisi kidaherekejwe n’ibikenewe ku rupapuro rusange gisiga intambwe ya nyuma itagenzuwe.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Umukoro wawe: sohora verisiyo ya kabiri

Erekana ko inzira yo gusohora yongera gukora nyuma ya release ya mbere yagenze neza.

Kora impinduka imwe igaragara ifite igisobanuro, nko kongeramo ibisobanuro by'umushinga. Yikorere commit na push unyuze mu bubiko bwawe. Tegereza deploy ihuye na yo, hanyuma ugenzure urupapuro rwayo rwa rusange.

Bika inyandiko za verisiyo zombi. Uzakoresha isano hagati ya commits na deploy nyuma wiga iyerekanwa rya preview na rollback.

Urugero rusobanuye

Inyandiko yawe ya mbere/nyuma igomba kuvuga icyahindutse kandi ikaranga commits zombi. URL ya rusange yonyine ntigaragaza verisiyo umuntu yabonye.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Extra implementation exercise

Sohora P2 kandi utange ibimenyetso ko host itanga commit yagambiriwe.

  1. Hindura ikintu kimwe kigaragara, uvugurure ikimenyetso uve kuri P1 ujye kuri P2 kandi usuzume diff.
  2. Kora commit na push; shaka deploy ihuye na byo.
  3. Gerageza URL ya rusange kandi wandike ikimenyetso gishya.
Erekana igisubizo gisobanuye

Mbere ya commit ya mbere, shyira 'Portfolio version P1' mu gika kigaragara. Bika urupapuro, usuzume diff ya Changes muri GitHub Desktop, ukorere commit gusa index.html/style.css/netlify.toml/.gitignore kandi ukore push ku ishami wagambiriye. Mu iyerekanwa rya dosiye rya GitHub emeza ko izo dosiye enye ziri ku mizi y'ububiko.

Andika commit ID nka P1. Muri Netlify hitamo ububiko/ishami bimwe, usige build command irimo ubusa kandi ukoreshe publish='.'. Huza commit ya deploy yagenze neza na P1, hanyuma ufungure URL yayo ya rusange utarinjiye kandi usome ikimenyetso. Hindura ikimenyetso kibe P2, usubiremo commit/push/deploy kandi ubike inyandiko zombi.

Isuzuma ry'ingirakamaro ni: repository=P2, deploy=P1, public marker=P1 → suzuma imimerere ya branch/build/deploy. Urundi rugero ni deploy=P2, public marker=P1 → banza usuzume hostname/igisubizo byasabwe na cache. Ntusohore ibanga kugira ngo ugerageze niba Git ishobora kurihisha; suzuma diff iri muri staging n'amateka asanzwe yose mbere ya push.

  • Ibirimo bya rusange bihuye n'impinduka ya P2 na commit yanditswe.
  • Urupapuro rw'ibanze, CSS n'amahuza yo kugenda ku rubuga bikora nyir'urubuga atinjiye.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo