Isomo rigufi · Kinyarwanda

Uko wakohereza emails zikora ku buryo bwikora ziva ku rubuga rwawe

Koresha umushinga wa email watanzwe uri kumwe n'umufasha, wohereze iyemezwa rigengwa nawe ugenzure ko rigeze mu gasanduku kawe.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka ko igikorwa ku rubuga gituma email yoherezwa. Kode ya seriveri iratanzwe kandi umufasha wo kwandika kode ashobora kuyishyiraho; ntukeneye kwandika seriveri ya email.

Mbere yo gutangira

Konti yawe ya Resend, uwohereza wemejwe n’agasanduku k’igerageza. Koresha umushinga wuzuye wa Netlify-function wihariye n’umufasha wo kwandika kode mu gutegura. Kuboneka kwa serivisi n’amategeko y’ikoreshwa birakurikizwa. Ibisubizo by’icyitegererezo si amagerageza yakorewe kuri konti yawe. Simbuza ibyo byabonetse n’ibyo wiboneye cyangwa uvuge intambwe ikiguhagaritse.

Igihe kigereranyijwe: 21–38 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. Kwemeza uwohereza n'igihe cyo gutegereza ko ubutumwa bugera ku wo bugenewe biriyongera. Amafaranga n'imipaka bya serivisi biterwa na konti.

Ibyo uziga

  • Shyiraho umwohereza n'uwakira ugenzura.
  • Tangiza email nyayo y'igerageza usuzume itangwa ryayo.
  • Tunganya ubusabe bwanze utigize ko ubutumwa bwageze.

Dosiye z'imyitozo

Intambwe 1

Hitamo igikorwa kimwe cya email

Tangira ku iyemezwa ryagenwe kandi ugenzura.

Fungura umushinga watanzwe uri kumwe n'umufasha uhitemo igikorwa kigomba kohereza iyemezwa ry'igerageza. Koresha gusa agasanduku ka nyir'urubuga kashyizweho; umushyitsi ntakwiriye guhitamo abohererezwa uko abonye.

Tandukanya kwakirwa k'ubusabe na serivisi no kugera k'ubutumwa mu gasanduku.

Urugero rufatika

Igikorwa watanzwe cyohereza Workshop confirmation idahindagurika ku wakira wagenwe kuri seriveri. Umushyitsi yandika izina, si aderesi yihitiyemo. Ikiranga ubutumwa kigarurwa gifasha kubukurikirana ariko nticyemeza ko bwageze.

Fungura uyu mwitozo wa email wuzuye. Kurikiza run-locally.txt usobanure amakuru y'ibanga y'umwohereza, uwakira, urufunguzo rwa serivisi na kode y'umwitozo. Ntubishyire muri dosiye rusange. Mfasha gukoresha umushinga no kohereza gusa mu gasanduku kanjye k'igerageza kashyizweho. Suzuma kwemera kwa serivisi n'itangwa nyaryo mu gasanduku ukwabyo, harimo n'igerageza ryanzwe.

Resend: kohereza email

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)

Ohereza email nyuma y'igikorwa cyo ku rubuga

Server function ihindura ubusabe bwemewe igahamagara serivisi y'ubutumwa.

Mushakisha igomba gusaba igikorwa runaka, ntibike amakuru yawe y'uburenganzira bwo hejuru bwo kohereza email. Muri uyu mwitozo, yohereza izina kuri server function, na yo ikohereza icyemezo cy'inyandiko isanzwe muri inbox yawe yateganyijwe.

Resend ni yo ikoreshwa mu cyitegererezo. Indi serivisi y'ubutumwa bw'ibikorwa ishobora gukora uwo murimo, ariko uburyo bwayo bwo kwemeza uburenganzira, kwemeza uwohereza na events zo kugera ku wo bugenewe biratandukanye. Agasanduku k'ubutumwa gakoreshwa n'umuntu ni serivisi itandukanye.

Urugero rusobanuye

Igisubizo cya “accepted” (byemewe) kivuga ko utanga serivisi yemeye ubusabe bwo kohereza. Si gihamya ko inbox yakiriye ubutumwa. Turagenzura uwo mupaka ukwawo.

Resend: kohereza email

Extra implementation exercise

Serivisi yasubije message ID, ariko nturagenzura inbox. Ni iki ushobora kuvuga utabeshya?

Erekana igisubizo gisobanuye

Utanga serivisi yemeye ubusabe bufite icyo kiranga. Kugera ku wo bugenewe ntikuremezwa kugeza usuzumye ibimenyetso by'uko bwagezeyo na inbox y'igerageza.

  • Avuga ko byemewe, ntavuga ko kugera muri inbox byemejwe.
  • Agumana ikiranga ubutumwa kugira ngo agenzure ko bwageze ku wo bugenewe.

Intambwe 2

Shyiraho utangize umushinga witeguye

Reka umufasha akore ibihuza bya seriveri.

Kurikiza run-locally.txt uri kumwe n'umufasha. Injiza indangagaciro z'ibanga za konti ukoresheje server-env.example.txt, hanyuma utangize umushinga wuzuye ufungure URL nyayo yawo yo kuri mudasobwa.

Gumana urufunguzo rwa serivisi n'uwakira wagenwe kuri seriveri. Kode y'umwitozo yo mu ifishi itandukanye n'urufunguzo rwa serivisi; kureba dosiye ntibikoresha serivisi ya email.

Urugero rufatika

Indangagaciro za seriveri zihitamo uwohereza, uwakira n’uburenganzira kuri serivisi. Kode y’umwitozo itandukanye yemera iri gerageza rya nyir’urubuga gusa. Umwanya uhishwe muri mushakisha cyangwa gufungura dosiye gusa ntibikora iryo genamiterere ry’ibanga rya seriveri.

Node.js: imimerere y'uburyo busohotse bushyigikiwe

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)

Tunganya uwohereza umwe w'umwitozo ufite imipaka

Gumana amakuru y'uburenganzira bw'uwohereza n'uwakira igerageza hanze y'ububiko rusange.

Ibyo kugenzura kuri mudasobwa yawe: emeza ko Node na npm byashyizweho, shyiraho cyangwa ugenzure Netlify CLI, hanyuma ukurikize run-locally.txt mbere yo kohereza fomu. Kubanza gufungura static page bifasha kureba imiterere, ariko ntibishobora kugerageza server function yayo.

Soma netlify/functions/mini-mail.mjs. Tunganya environment variables zayo z'ubutumwa na LAB_TOKEN itoroshye gukeka (nibura inyuguti 24) mu mushinga wawe wo kwakira urubuga. MAIL_FROM igomba kuba yemewe n'utanga serivisi; TEST_RECIPIENT ni inbox yawe y'igerageza. Ntushyire API key muri public/app.js.

Umukoresha yinjiza kode itandukanye y'uburenganzira bw'uyu mwitozo ugenzurwa; ntishyirwa muri paji kandi si key yawe ya Resend. Function yirengagiza ku bushake aho kohereza hatanzwe n'usaba. Igenzura umwanya muto w'izina kandi igakora ubutumwa bw'inyandiko isanzwe. Mbere yo gushyira ku mugaragaro, ongeramo imipaka irambye y'ubusabe kandi usuzume quotas; uyu mwitozo wa nyirawo gusa si sisitemu yuzuye yo kurwanya ikoreshwa nabi.

Aho kohereza hagengwa na seriveri ku bushake. Ubusabe bwahinduwe muri mushakisha bushobora kongeramo to='somewhere-else', ariko function ikora payload yayo bwite ya serivisi kandi igakoresha TEST_RECIPIENT. Ibi birinda ko usaba muri uyu mwitozo ahindura iyi mikorere uburyo bwo kohereza kuri aderesi izo ari zo zose; gufungurira rubanda byakenera na none uburyo burambye bwo kurwanya ikoreshwa nabi.

Ku ruhererekane rwuzuye rwo kuri mudasobwa yawe, fungura run-locally.txt: tegura igenamiterere ry'ibanga rya seriveri muri dosiye .env iri mu bubiko shingiro bw'umushinga, hanze ya public/ kandi idakurikiranwa na Git; huza gusa umushinga wo kwitoza kandi utangize proxy ya Netlify functions. server-env.example.txt itondeka amazina ya variables idafite amabanga nyayo. Gufungura HTML gusa ntibishobora gukoresha seriveri.

Urugero rusobanuye

Igitero gihindura ubusabe bwa mushakisha ntigishobora kuyobya email y'uyu mwitozo kuko uwakira ava muri environment ya seriveri. Guhisha aderesi muri JavaScript ntibyatanga ubwo burinzi.

const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.

Node.js: imimerere y'uburyo busohotse bushyigikiwe

Extra implementation exercise

Ese gushyira key mu mwanya wa fomu uhishe byatuma iguma ari ibanga?

Erekana igisubizo gisobanuye

Oya. Imyanya ya fomu ihishe na yo yohererezwa mushakisha. Gumana amakuru y'uburenganzira muri environment ya seriveri kandi abe ari ho uhamagarira serivisi.

  • Amenya ko agaciro kohererezwa mushakisha gashobora gusuzumwa.
  • Ajyana ikoreshwa risaba uburenganzira bwo hejuru muri environment ya seriveri.

Intambwe 3

Ohereza igerageza rimwe ryoroshye kumenya

Koresha urupapuro rugenzura ibintu ugumane ibimenyetso bihujwe.

Tangiza iyemezwa uri ku rupapuro nyarwo ruri gukora. Bika ikiranga igerageza usuzume igikorwa gihuye na ryo muri serivisi na kopi yo mu gasanduku.

Niba ubusabe bwanze, reka kunanirwa kugaragare kandi ubike ibisobanuro bihagije byo kongera kugerageza. Ntukemure serivisi itaboneka uhimba ubutumwa bwo gutsinda.

Urugero rufatika

Ku izina ry’impimbano Alex, imeri y’ibanze ivuga “Hello Alex. Your practice request was received.” Gereranya ubutumwa bwakiriwe koko n’igerageza bijyanye aho gukoresha imeri ishaje.

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)

Kurikirana ubusabe n'igisubizo byatanzwe

Buto yohereza JSON; seriveri ikayigenzura, hanyuma igasubiza uko byagenze mu buryo bw'ukuri.

Tangaza umushinga utandukanye cyangwa uwukoreshe ukoresheje ibikoresho bya host byo gukoresha functions kuri mudasobwa yawe. Gufungura index.html nka dosiye yo kuri mudasobwa ntibikoresha backend. Ohereza izina ry'impimbano kandi usuzume igisubizo cyo ku muyoboro.

Seriveri isubiza 400 ku makuru yinjijwe mu buryo butari bwo, 503 ku miterere ibura, 502 iyo guhamagara serivisi byanze na 202 iyo serivisi yemeye ubutumwa. Mushakisha yerekana kunanirwa itavuze ko email yageze ku wo yagenewe.

Urugero rusobanuye

UI y'umwitozo ivuga “Accepted by the mail provider. Check your test inbox.” (Serivisi y'ubutumwa yemeye. Genzura inbox yawe y'igerageza.) Ibyo bihuye n'ibyo seriveri izi muri icyo gihe.

Extra implementation exercise

Endpoint isubije 503. Ese ugomba kubanza guhindura ibara rya buto cyangwa kugenzura environment ya seriveri?

Erekana igisubizo gisobanuye

Genzura environment variables zatunganyijwe n'imiterere y'uwohereza. Uko UI isa ntibishobora gutanga amakuru y'uburenganzira ya seriveri abura.

  • Abanza kugenzura imiterere ya seriveri ibura.
  • Ntafata ubusabe bwanze nka email yarangiye koherezwa.

Intambwe 4

Shakisha ikibazo cy'ubutumwa bwabuze

Reba uko itangwa rihagaze mbere yo kohereza kenshi.

Koresha delivery-record.txt uhuze ikiranga igerageza n'uko rihagaze muri serivisi, aho rigana n'igenzura ry'agasanduku n'ubutumwa butifuzwa. Saba umufasha ubufasha ku cyiciro cyananiranye.

Ubutumwa bugarutse cyangwa aderesi yanze bisaba gusuzumwa. Kongera kohereza kimwe utabanje kumenya impamvu bishobora kongera urusaku bidakemuye itangwa.

Urugero rufatika

Byakiriwe → byagarutse → nta kopi mu gasanduku byerekeza ku gusuzuma itangwa. Kode y’umwitozo yanze → nta gikorwa cya serivisi byerekeza ku gutegura uburenganzira. Ibi byabonetse bigena amagenzura akurikira atandukanye.

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)

Genzura kugera ku wo bigenewe no kunanirwa

Huza gukanda rimwe, ikiranga cyatanzwe na serivisi n'ubutumwa bwakiriwe koko.

Shaka ubutumwa bwemewe mu bikorwa bya serivisi yawe kandi usuzume uko kugera ku wo bugenewe guhagaze. Hanyuma genzura inbox y'igerageza yateganyijwe, harimo na spam. Andika kwemera k'ubusabe n'ibyo wabonye kuri kopi yakiriwe ukwabyo.

Gerageza izina ridafite ibirimo binyuze muri fomu isanzwe na JSON yanditswe nabi binyuze mu busabe bwo mu bikoresho by'abatekinisiye. Mu miterere itandukanye ishobora gusibwa nyuma, emeza ko kubura amakuru y'uburenganzira byanga mu buryo busobanutse. Ntuzigere usangiza abandi bodies z'ibisubizo bya serivisi zishobora kuba zirimo amakuru ya konti.

Urugero rusobanuye

Event yo kugera ku wo bigenewe n'ubutumwa bwakiriwe bihuye ni ibimenyetso bikomeye kurusha buto y'icyatsi. Kwemera kwa serivisi nta kopi yakiriwe bisaba gukomeza gusuzuma ikibazo cyo kugeza ubutumwa.

Extra implementation exercise

Serivisi yerekana ko ubutumwa bwagarutse butageze ku wo bwagenewe (bounce) ku kiranga cy'igerageza. Ese guhita wongera kohereza ubwo butumwa ni yo ntambwe ikwiye kurusha izindi?

Erekana igisubizo gisobanuye

Banza usuzume kunanirwa kwatangajwe n'imiterere y'uwakira. Ongera ugerageze gusa umaze kumenya icyahindutse; kongera kohereza kimwe ntibikosora aho kohereza hatari ho.

  • Asuzuma impamvu ya bounce n'aho ubutumwa bwagenewe.
  • Yirinda gusubiramo ubusabe nta mpinduka mu isuzuma ry'ikibazo.

Intambwe 5

Ongeramo ingingo y'ubutumwa ifasha

Sobanura uko bigomba gukora usabe umufasha kubishyira mu bikorwa.

Saba umufasha kongeramo amahitamo abiri y’ingingo: Project na Question, afite indangagaciro project na question. Agaciro kahiswemo kajye mu butumwa bwo kwemeza, uwakira udahinduka na rufunguzo rw’ibanga bya seriveri bigumeho. Saba umufasha kugerageza agaciro katemewe other atakongeye mu byemewe.

Ohereza igerageza rimwe ugenzura kuri buri hitamo ryemewe urebe inyandiko yakiriwe koko. Ingingo itemewe na kode y’umwitozo itari yo bigomba kwangwa nta kohereza kwa serivisi; genzura ayo magerageza yo kwanga ukwabyo.

Urugero rufatika

Uyu murimo ufite amahitamo abiri yemewe: Project na Question, bibikwa nka project na question. Agaciro kahiswemo kagomba kugera mu imeri. Other ni agaciro ko kugerageza kutemewe nkana, si ihitamo rya gatatu ryo kongeramo.

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: ongeramo amakuru afite akamaro mu cyemezo

Shyiramo topic ngufi y'ubusabe utemeye abohererezwa abo ari bo bose cyangwa HTML.

Ongeramo umwanya wa topic ufite agaciro kabiri kemewe. Genzura urutonde rw'ibyemewe kuri seriveri kandi ushyire agaciro katoranyijwe mu cyemezo cy'inyandiko isanzwe. Uw'ubutumwa bugenewe agume kugenwa muri environment.

Ohereza igerageza rihuye na buri gaciro n'irifite agaciro kamwe katemewe. Andika ikiranga cya serivisi n'ibimenyetso nyabyo byo kugera ku wo bigenewe.

Banza uhindure dosiye zawe watangiranye na zo. Hanyuma ugereranye topic select, JSON y'ubusabe n'urutonde rw'ibyemewe rwa seriveri umurongo ku murongo na dosiye z'icyitegererezo. Ububiko bwa reference ni ubundi buryo bwuzuye bwo kugenzura umurimo wawe, si ubundi bubiko bwo guhita ukoporora muri public/ utabusuzumye.

Urugero rusobanuye

Kwemera gusa “project” na “question” biroroshye gusuzuma kurusha gukoporora ibikubiye mu busabe ibyo ari byo byose muri buri mwanya wa email.

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

Ongera icyemezo ushyiremo topic yabanje kugenzurwa kandi werekane ubusabe bwagenze neza n'ubwanzwe.

Erekana igisubizo gisobanuye

Kongeramo topic bikoresha agaciro kabiri kemewe gusa, 'project' na 'question'. Ongeramo select muri fomu, shyiramo topic muri JSON kandi ugenzure urwo rutonde rw'ibyemewe kuri seriveri mbere yo guhamagara serivisi y'ubutumwa. Frontend na function by'icyitegererezo byerekana impinduka zose.

Gumana TEST_RECIPIENT igenzurwa na seriveri n'ubwo ubusabe bwahinduwe butanga indi aderesi. Topic yemewe na kode nyayo y'umwitozo bishobora kugera aho serivisi yemera ubusabe; topic itemewe igomba gusubiza 400 nta guhamagara serivisi. Kwemera ntibivuga ko inbox yakiriye.

Ohereza buri topic yemewe ukoresheje konti yawe y'igerageza, uhuze ikiranga cyayo cya serivisi n'ubutumwa bwakiriwe koko kandi wandike uko biri mu kuri niba bwaragarutse butagezeyo cyangwa bugitegerejwe. Code y'icyitegererezo ni inyongera y'umwitozo ugenzurwa, si uburyo rusange bwo kwakira no kongera kohereza ubutumwa.

  • Seriveri yanga topics zitemewe kandi igumana uwakira wagenwe.
  • Topics zombi zemewe zigaragara mu butumwa bwakiriwe buhuye na zo.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo