
Isomo rigufi · Kinyarwanda
Uko wareba impinduka z'urubuga mbere yo kuzisohora
Tegura impinduka nto y'urubuga uri kumwe n'umufasha, usuzume aderesi yayo itandukanye yo kureba, ugumane urubuga nyarwo rudahindutse kugeza byemejwe.
Ibi bigenewe nde?
Abatangaza bavuye mu bubiko bwa kode bashaka gusuzuma impinduka mbere yo kuzirekura. Umufasha wo kwandika kode n'ibikoresho by'ububiko na serivisi yakira urubuga bishobora gukora ibijyanye n'amashami.
Mbere yo gutangira
Ububiko bwawe butandukanye bwa GitHub buhujwe n'umushinga wa Netlify w'umwitozo, bufite kureba pull-request bifunguye. Kubaka mu gicu bikoresha inguzanyo za konti. Umwitozo utanga dosiye za mbere n'iz'impinduka; koresha urubuga rwo kujugunywa aho guhindura urubuga nyarwo.
Igihe kigereranyijwe: 20–32 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. Gutegereza cloud build no gutegura konti byiyongeraho. Preview za rusange ntizigomba kugira amakuru y'ibanga yo kugerageza cyangwa amabanga ya production.
Ibyo uziga
- Kora verisiyo itandukanye yo gusuzuma.
- Gereranya urupapuro rwo kureba n'urubuga rw'ubu ukoresheje igikorwa kimwe.
- Huza iyemezwa na verisiyo nyayo yasuzumwe.
Intambwe 1
Menya verisiyo zombi
Isuzuma rikenera aho guhera n'impinduka iteganyijwe.
Koresha urupapuro rw’ibanze watanzwe gushyiraho P1 ku mushinga wawe wihariye wo kwakira umwitozo. Gereranya n’umufasha n’urupapuro rw’impinduka watanzwe: P1 ivuga “Find contact information”, naho P2 ikavuga “Contact me”. Byombi bigomba kugera ku gice kimwe cya Contact.
Gumana aderesi ya P1 yatangajwe ubu nk’urugero rw’ibanze. P2 iteganywa ni iyo ku ishami ryo gusuzuma ritarahujwe n’ireberero ryaryo ryihariye; andika ibimenyetso bya verisiyo bigaragara kugira ngo umenye urupapuro uri kugerageza.
Urugero rufatika
Iyi ni impinduka nto y’amagambo, si sisitemu nshya yo kuvugana. Ikirango giteganywa kirushaho gusobanuka ariko aho kuvugana bisanzwe bigomba gukomeza gukora.
Koresha impinduka y'urubuga rw'umwitozo watanzwe. Mfasha gukora ishami ritandukanye ryo gusuzuma na pull request ifite urupapuro rwo kureba rwa Netlify, ugumane verisiyo y'umwitozo yatangajwe ubu idahindutse. Erekana URL zombi ugaragaze verisiyo iri gusuzumwa. Ntuhuze amashami cyangwa ngo utangaze ku rubuga nyarwo ntabyemeje. Mfasha kugerageza igikorwa cyahindutse no kwandika ibibazo bitarakemuka.Dosiye z'iyi ntambwe
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Reba impinduka mbere yo kuzisohora
Ha uburyo busabwa URL yabwo yo gusuzuma mu gihe production ikomeza gukora.
Preview ikwemerera kugerageza igisubizo nyacyo cyubatswe cy'ishami mbere yo kurihuza n'inkomoko y'urubuga ruri ku mugaragaro (production). Dosiye yo kuri mudasobwa isa neza ishobora gukomeza kugira inzira za dosiye zikorwa na build cyangwa igenamiterere rya serivisi ikoresha bitari byo.
Iyi myitozo ikoresha impinduka nto ku bushake: P1 ivuga «Find contact information», bisaba gushaka amakuru yo kuvugana; P2 ivuga «Contact me», bisaba kunyandikira. Uzamenya uburyo bwombi kandi ugenzure igikorwa kimwe cyo kukwandikira mbere yo guhitamo guhuza.
Urugero rusobanuye
Mu gihe pull request itarahuzwa, preview igomba kwerekana P2 naho urubuga rwa rusange rusanzwe rugakomeza kwerekana P1. Niba byombi byahindutse, suzuma ishami risohora kuri production.
Extra implementation exercise
Kuki inyandiko y'isuzuma ryawe ikwiye kugira uburyo bwa preview n'ubwa production byombi?
Erekana igisubizo gisobanuye
Byemeza ko preview irimo impinduka yasabwe mu gihe urubuga rwa rusange rugumana uburyo bwemewe. Preview ikora yonyine ntiyemeza iryo tandukaniro.
- Hemezwa uburyo buri gusuzumwa ubwo ari bwo.
- Hemezwa ko production itahinduwe ku bw'impanuka.
Ikosa rikunze gukorwa
Gusuzuma URL ya production wibwira ko ari preview y'ishami.
Intambwe 2
Kora urupapuro rwo gusuzuma
Reka umufasha akuyobore mu ntambwe z'ububiko bwa kode.
Koresha ububiko bwa kode bwihariye bw’umwitozo ufungure kurebera pull requests muri konti yawe yo kwakira urubuga. Saba umufasha gukora ishami ryo gusuzuma rifite impinduka P2 watanzwe, aryohereze afungure pull request itarahujwe. Izi build zikorwa na serivisi zishobora gukoresha credits za konti.
Fungura ireberero ryavuyemo usome ikimenyetso P2 kigaragara. Bika URL yaryo hamwe na commit nyirizina yasuzumwe ivuye mu bubiko cyangwa serivisi. Indi commit kuri iryo shami ni indi verisiyo igomba gusuzumwa.
Urugero rufatika
Ishami ryitwa improve-contact-label rishobora kugira commit zitandukanye mu gihe. Kwemera ireberero rya mbere ntibihita byemeza commit ikurikira.
Netlify: Deploy Previews zo gusuzuma mbere yo gusohora
Gerageza ubwawe
Ni uruhe rupapuro rwo kureba wafunguye, kandi rurimo iyihe verisiyo?
Ganira ku gisubizo cyawe n’umufasha w’isomo
Erekana igisubizo gisobanuye
Inyandiko y’icyitegererezo igaragaza URL y’ireberero yatanzwe na serivisi, ikimenyetso P2 na commit nyirizina yakoporowe muri pull request. Nakwemeza ko “Contact me” ihari. Nimbona P1 cyangwa ntashobore kubona build y’ireberero, iryo reberero ntiriratsinda iri genzura.
- Ahuza URL nyayo y’ireberero n’ikimenyetso P2 cyaryo na verisiyo nyirizina ya kode.
- Ntafata izina ry’ishami ryonyine nka verisiyo yasuzumwe.
Dosiye z'iyi ntambwe
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Fungura isuzuma ry'ishami rifite impinduka ishobora kongera gukorwa
Huza pull request na revision yihariye y'inkomoko.
Kurikiza commands.txt gusa imbere mu bubiko bwawe bwo kwitoza ushobora gukuraho. Kora commit y'impinduka ya P2 ku ishami kandi ufungure pull request utayihuje. Deploy Preview ya Netlify igomba guhuza URL yubatswe n'iyo pull request/revision.
Soma ibisobanuro bya deploy aho gukeka ko byagenze neza ushingiye kuri mushakisha. Andika commit kandi ugenzure ububiko bwo gusohora. Niba nta preview ihari, suzuma igenamiterere rya preview y'umushinga na build logs; ntubisimbuze gusohora ishami kuri production.
Mbere y'amategeko y'ishami, fungura URL ya rusange ya P1 isanzwe, ukande umurongo wayo wo kukwandikira kandi wandike commit ya P1 ikora muri review-record.csv. Niba nta deploy ya P1 ikora ihari, banza urangize iyo ntangiriro. Ku mukoro, uzuza imirongo yombi: aho wagerageje, URL, commit, uburyo bugaragara, igisubizo cy'igikorwa cyo kukwandikira n'ingaruka itateganyijwe iyo ari yo yose.
Niba ishami rya production rihindutse mu gihe ukora, suzuma imimerere y'impinduka/ibihurirana ya pull request mbere yo gukomeza. Zana imimerere y'ishami iriho kandi ukemure ibihurirana ubigambiriye ku ishami ryawe; saba ubufasha niba utizeye aho gusimbuza akazi kadakureba. Nyuma yo kubikemura, ongera usuzume revision nshya ya preview.
Niba URL ya preview ibuze, reba ko Deploy Previews zifunguye kuri pull requests z'ububiko, ishami ritarakuwe mu asohorwa, build log itsinda kandi netlify.toml yerekeza ku bubiko bwa public bwagenewe. Mu mateka ya Deploys ya serivisi, fungura deploy ya production iriho kugira ngo ubone commit yayo nyayo y'inkomoko.
Urugero rusobanuye
Igenzura rya commit ribisi na preview isomeka bigomba kwerekeza kuri revision imwe. Guhindura ishami nyuma bikora revision nshya ikeneye isuzuma ryayo.
Netlify: Deploy Previews zo gusuzuma mbere yo gusohora
Extra implementation exercise
Wasuzumye commit A, hanyuma ukora push ya commit B ku ishami rimwe. B iremerwa n'icyemezo cya kera?
Erekana igisubizo gisobanuye
Oya. Izina ry'ishami ryagumye ari rimwe ariko ibirimo byahindutse. Suzuma preview yubatswe na B kandi usuzume itandukaniro.
- Isuzuma rihuzwa na revision yihariye.
- Preview yahindutse yongera kugeragezwa mbere yo kuzamurwa kuri production.
Ikosa rikunze gukorwa
Gufata URL y'ishami nk'ikiranga uburyo budashobora guhinduka.
Intambwe 3
Subiramo igikorwa cy'umushyitsi mu mutekano
Izina rya domain ritandukanye ntirituma serivisi nyazo zidashobora kugira ingaruka mbi.
Fungura P1 yatangajwe n’ireberero P2 utinjiye muri konti kandi ku bugari buto. Kuri buri imwe koresha igikorwa cyo kuvugana wemeze ko Contact igikorerwa. Kuri uru rugero rwa dosiye zisanzwe, hagarara ku gice cyo kuvugana; ntukohereze imeri kuri aderesi y’icyitegererezo.
Nukoresha ubu buryo nyuma ku mafishi, ubwishyu cyangwa amakuru abitswe, banza urebe igenamiterere rya serivisi z’ireberero. Hostname nshya y’ireberero ishobora guhamagara serivisi nyayo; koresha konti n’amakuru byihariye byo kugerageza kuri ibyo bikorwa.
Urugero rufatika
Mu rugero watanzwe, P1 na P2 byombi bigera kuri Contact; P2 ihindura gusa amagambo agaragara y’ihuza n’ikimenyetso cya verisiyo. Nta verisiyo ikeneye kohereza imeri cyangwa kwandika mu bubiko bw’amakuru.
Netlify: environment variables na deploy contexts · Netlify: environment variables za deploy-context
Gerageza ubwawe
Igikorwa kimwe cyakoze iki muri buri verisiyo, kandi ni izihe mbibi za serivisi z'igerageza wemeje?
Ganira ku gisubizo cyawe n’umufasha w’isomo
Erekana igisubizo gisobanuye
Igereranya ry’icyitegererezo: “Find contact information” ya P1 na “Contact me” ya P2 byombi bigera kuri Contact ku bugari buto kandi ntinjiye muri konti. Impinduka yatanzwe ntifite kohereza imeri, kwishyura cyangwa ububiko bw’amakuru; sinakoresheje aderesi ya imeri y’icyitegererezo.
- Akora igikorwa kimwe cyo kuvugana muri verisiyo zombi akagereranya ibyavuyemo.
- Agenzura gukoresha ku bugari buto no kutinjira muri konti, agatandukanya iki gikorwa cya dosiye zisanzwe n’ingaruka nyazo ku zindi serivisi.
Dosiye z'iyi ntambwe
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Tandukanya amakuru n'ingaruka bya preview
URL itandukanye ntihita itandukanya backend yayo.
Urugero rwacu rwa dosiye zihoraho rw'umurongo wo kukwandikira ntirufite ingaruka kuri backend. Muri porogaramu nyayo, suzuma variables za preview-context ukwazo: ububiko bw'amakuru, uwakira imeli, uburyo bw'ubwishyu n'ibyangombwa bishobora gukomeza kwerekeza kuri production.
Koresha amakuru yo kugerageza ushobora gukuraho na sandbox za serivisi aho bikenewe. Preview irinzwe ku kuyireba kwa buri wese ishobora gukomeza gukora function ya seriveri ifite ibyangombwa byose wagenye.
Urugero, niba function yawe isoma SUPABASE_URL, gumisha iryo zina rya variable ariko ugene agaciro karyo muri Deploy Preview context kajye ku mushinga w'ububiko bw'amakuru wo kwitoza ushobora gukuraho. Ntuhimbe izina rishya rya variable kode itigeze isoma. Suzuma kandi buri banga/uwakira/uburyo bw'ubwishyu muri iyo context; gukoporora agaciro ka production bivanaho gutandukanya.
Muri dashboard y'umushinga wa Netlify, fungura igenamiterere rya environment variables, ni ukuvuga agaciro kagena serivisi n'uburyo porogaramu ikoramo. Hindura agaciro ka variable ko muri Deploy Preview context kutagendeye ku gaciro kayo ka Production. Bika gusa agaciro ka serivisi yo kugerageza kuri iyo context, utangize preview build nshya kandi ugenzure revision ivuyemo; guhindura agaciro muri dashboard ntibyemeza ko function yasohowe mbere yakakiriye. Reba ubuyobozi bwemewe bwa context buri hasi.
Urugero rusobanuye
Fomu yo kukwandikira ya preview ihujwe na serivisi ya production y'imeli ishobora kohereza ubutumwa nyabwo. Amagambo «preview» muri URL yayo ntahagarika uwo muhamagaro.
Netlify: environment variables na deploy contexts · Netlify: environment variables za deploy-context
Extra implementation exercise
Hostname yihariye ya preview irahagije kwemeza ko ubwishyu bwo kugerageza budashobora gukura amafaranga nyayo?
Erekana igisubizo gisobanuye
Oya. Tegura preview ifite ibyangombwa byo kugerageza na serivisi zitandukanye, hanyuma ugenzure imikorere yabyo nyayo. Gutandukanya hostname byonyine ntibihagije.
- Hasuzumwa ibyangombwa/uburyo bw'ubwishyu n'aho amakuru ajya.
- Gutandukanya URL za frontend ntibyitiranywa no gutandukanya backend.
Ikosa rikunze gukorwa
Gukoporora buri environment variable ya production muri previews utitaye ku ngaruka zayo.
Intambwe 4
Fata icyemezo cyo gusuzuma verisiyo yihariye
Iyemezwa rikurikira igisubizo wasuzumye koko.
Uzuza review-record.csv urimo URL, verisiyo yasuzumwe, ibyo wiboneye n'ibibazo bisigaye. Saba ugukosora gufite imbibi usuzume urupapuro rwo kureba rwavuyemo nanone.
Gumana urubuga rw'ubu rudahindutse kugeza hafashwe icyemezo gisobanutse cyo kurekura verisiyo. Niba verisiyo ihindutse nyuma yo gusuzuma, garagaza ibikeneye kongera kugeragezwa.
Urugero rufatika
Isuzuma rifite akamaro rirasobanuka: “Ikirango gishya cya P2 kigera ku gice kimwe kuri 390px na desktop; iy’ibanze yatangajwe iguma P1.” Rivuga verisiyo yageragejwe kandi ntirihuza pull request.
Gerageza ubwawe
Ibikoresho byo gutangiriraho
Dosiye n’amakuru yo kugerageza byaratanzwe. Kugenzura serivisi nyayo bisaba konti, imeli cyangwa domene yawe nk’uko ibisabwa bibivuga. Ushobora gusuzuma kuri mudasobwa; intambwe yo kuri serivisi utakoze uyandike ko itarageragejwe.
Tanga igereranya ry'urupapuro rwo kureba n'urw'ubu hamwe n'iyemezwa ryawe cyangwa ikibazo gisigaye.
Ibyo ugomba gukora URL zo kureba n'iz'urupapuro rw'ubu n'inyandiko nyayo y'igereranya rya verisiyo yasuzumwe.
Ganira ku gisubizo cyawe n’umufasha w’isomo
Erekana igisubizo gisobanuye
Icyemezo cy’icyitegererezo: “Contact me” ya P2 irasobanutse kandi igera ku gice kimwe na P1 kuri 390px no kuri desktop. Nemeye iyo verisiyo nyirizina y’ireberero yanditswe kugira ngo ifatirwe icyemezo cyo gutangaza nyuma; umwitozo usiga pull request itarahujwe na P1 ikiri yatangajwe. Commit yose nshya ikeneye kongera kurebwa.
- Ahuza igereranya n’icyemezo cyo gusuzuma na verisiyo nyirizina y’ireberero.
- Asiga P1 yatangajwe uko iri akandika ikibazo cyose gisaba kongera gusuzuma ireberero rishya.
Dosiye z'iyi ntambwe
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Umukoro wawe: tanga impinduka ishobora gusuzumwa
Gira isuzuma rito kandi urishyigikire n'ibisubizo bigaragara.
Kora irindi hinduka rimwe ry'izina cyangwa imiterere ku ishami. Suzuma gufungura mu buryo butaziguye, ubugari bwa telefoni n'igikorwa cyo kukwandikira kuri preview yayo. Gereranya n'uburyo bwa production.
Tanga ibisobanuro bigufi by'impinduka hamwe na URL ya preview, revision y'inkomoko n'ibyo wabonye. Huza gusa nyuma y'uko usuzuma wagenewe yemeje uburyo nyabwo; uyu mwitozo ntusaba kuzamura kuri production.
Ku igenzura ry'ubugari buto, koresha ibikoresho by'abakora imbuga bya mushakisha kuri viewport ya 390px hanyuma ku bugari bwa mudasobwa. Andika ubugari nyabwo n'igisubizo cy'igikorwa cyo kukwandikira muri review-record.csv; uyu mukoro usiga ishami ritarahuzwa.
Urugero rusobanuye
«Nahinduye izina ryo kukwandikira; umurongo uracyagera kuri #contact kuri 390px no ku bugari bwa mudasobwa» birafasha kurusha «birasa neza kurushaho».
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
Kora preview y'ishami n'inyandiko y'igereranya yuzuye udahinduye production.
Erekana igisubizo gisobanuye
Emeza ko P1 isanzwe ikora kuri URL ya rusange yo kwitoza kandi wandike commit yayo. Ku ishami ryo gusuzuma hindura ikimenyetso kigaragara kibe P2 n'izina ryo kukwandikira ribe 'Contact me', ukore commit/push y'iryo shami muri konti yawe kandi ufungure pull request utayihuje.
Andika imirongo yombi muri review-record.csv: URL/commit/P1/igikorwa cyo kukwandikira gikora bya production; URL/commit nshya/P2/igikorwa cyo kukwandikira gikora bya preview. Fungura zombi utarinjiye kandi ku bugari buto. Igenamiterere rya backend ya preview rigomba kwerekeza kuri serivisi zitandukanye zo kugerageza niba ifite ingaruka zo hanze. Subiramo ayo magenzura kuri 390px no ku bugari bwa mudasobwa; koresha imirongo ya CSV itandukanye kandi wandike buri bugari nyabwo.
Nyuma y'indi commit ku ishami, ongera ugenzure iyo revision nshya ya preview. Ibisobanuro bya request by'urugero byerekana amakuru usuzuma akeneye; gumisha ishami ritarahuzwa kandi ntuzamure production nk'igice cy'uyu mukoro.
- Production iguma kuri revision yayo yemewe mu gihe cyo gusuzuma.
- Revision nyayo ya preview itsinda igikorwa cy'usura cyavuzwe.
Ikosa rikunze gukorwa
Guhuza mbere ukita igisubizo kiri ku murongo preview.
Iri somo ryagufashije?
Kanda ko urikunze, cyangwa urisangize uwo ryafasha.
Komeza kwiga
- Uko wakora urubuga rwawe rwa mbere
- Uko wasohora urubuga rwawe uhereye kuri GitHub
- Uko wahuza domeni yawe n'urubuga rwawe
- Uko wategura imeli kuri domeni yawe
- Uko watuma urubuga rwawe rukoreshwa kuri telefoni
- Uko watuma amafoto y'urubuga afunguka vuba
- Uko wakwakira ibitekerezo byo ku rubuga muri inbox yawe
- Uko wakongeramo kwiyandikisha kwakira email ku rubuga rwawe
- Uko wakohereza emails zikora ku buryo bwikora ziva ku rubuga rwawe
- Uko wabika ibyoherejwe binyuze muri fomu muri database
- Uko wakwemerera abantu kwinjira muri konti ku rubuga rwawe
- Uko wagumisha urupapuro ari ibanga
- Uko wakwemerera abakoresha guhindura amakuru y'umwirondoro wabo
- Uko wakwemerera abakoresha kohereza amashusho
- Uko wakumira imfunguzo za API muri frontend yawe
- Uko wakwerekana amakuru ava muri API yo hanze ku rubuga rwawe
- Uko wakongeramo AI chatbot ku rubuga rwawe
- Uko watuma chatbot isubiza ishingiye ku birimo byawe
- Uko wakongeramo blog ku rubuga rwawe
- Uko wakongeramo ishakisha ku rubuga rwawe
- Uko wakongeramo urundi rurimi ku rubuga rwawe
- Uko wafasha Google kubona urubuga rwawe
- Uko wakosora iyerekanwa ry'urubuga rwawe igihe usangiza umurongo
- Uko wapima gusurwa n'ibikorwa by'ingirakamaro ku rubuga rwawe
- Uko wakwemerera abarusura gufata gahunda yo guhura nawe
- Uko wakwakira ubwishyu ku rubuga rwawe
- Uko wasubira inyuma nyuma yo gusohora urubuga rwangiritse
- Uko wakora kopi y’ingoboka kandi ugasubizaho amakuru y’urubuga rwawe
- Uko wabona kandi ugakosora amakosa ku rubuga rwawe ruri ku murongo