Kung nasubukan mo na ang mundo ng pagbuo ng Node.js, alam mo na ang pamamahala ng pakete ay maaaring maging isang tunay na bangungot kung walang malinaw na plano. Hindi pangkaraniwan para sa isang proyekto na gumana nang perpekto sa iyong laptop, ngunit... sumabog kapag na-deploy sa server dahil sa bahagyang kakaibang bersyon ng library o hindi magkatugmang configuration ng system.
Para maiwasan ang kaguluhang ito, mahalagang maunawaan hindi lamang kung paano mag-install ng mga pakete, kundi pati na rin kung paano upang linisin at ihiwalay ang kapaligiran ng pagpapatupad. Ang paggamit ng mga container at mahigpit na pamamahala ng bersyon ay nagbibigay-daan sa atin na matulog nang mahimbing, dahil alam nating ang mayroon tayo sa pagbuo ay eksaktong kapareho ng makakarating sa end user.
Ang puso ng mga module sa Node.js
Tinatrato ng Node.js ang bawat file bilang isang hiwalay na yunit, na tinatawag nating mga module. Sa madaling salita, ang isang module ay isang naka-encapsulate na piraso ng code na nag-e-export ng ilang partikular na function upang magamit ito ng iba. Makikita natin katutubong modyul (mga kasama na sa Node), mga lokal na module na kami mismo ang sumulat at mga third-party module na dina-download namin sa pamamagitan ng npm.
Ngayon ay nasa isang transisyon tayo sa pagitan ng dalawang sistema: Mga Module ng CommonJS at ESAng una ay ang beterano, ang gumagamit require() y module.exportsAng pangalawa ay ang modernong pamantayan ng JavaScript, batay sa import y exportKung magsisimula ka ng isang proyekto mula sa simula, ang pinakamakatwirang gawin ay ang paggamit ng mga ES Module upang samantalahin ang pag-alog ng punona nag-aalis ng mga patay na code at ginagawang mas magaan ang app.
Isang teknikal na detalye na kadalasang ikinagugulat ng maraming tao ay ang pag-cache ng modyulIniimbak ng Node.js ang module sa memorya sa unang pagkakataon na ito ay i-load. Kung tatawagin mo itong muli, hindi nito ito babasahin mula sa disk, ngunit sa halip ay ibabalik ang parehong instance. Ito ay mahusay para sa pagpapatupad ng Patern na singletonGayunpaman, kailangan mong maging maingat kung kailangan mong i-clear ang cache na iyon sa mga partikular na kaso tulad ng hot reloading.
Pagsusuri sa package.json file at sa mga manager
Ang file package.json Ito, walang duda, ang roadmap para sa anumang proyekto. Dito natin binibigyang-kahulugan ang lahat mula sa pangalan at bersyon hanggang sa mga script ng automation. Mahalagang malaman kung paano makilala ang pagkakaiba sa pagitan ng mga dependency at devDependencyAng mga nauna ay mahalaga para tumakbo ang app sa produksyon, habang ang mga huli ay mga support tool lamang, tulad ng mga linter o testing framework, na Hindi dapat i-install ang mga ito sa server pangwakas upang maiwasan ang paglaki ng laki ng imahe.
Kung tungkol sa kung sino ang namamahala sa mga aklatang ito, mayroon tayong ilang mga opsyon. NPM Ito ang pamantayan na siyang pamantayan. magkuwentuhan Lumitaw ito bilang isang mas mabilis at mas deterministikong alternatibo. Sa kabilang banda, pnpm Ito ang pinaka-matipid sa espasyong opsyon, dahil gumagamit ito ng matibay na mga link upang maiwasan ang pagdoble ng parehong library sa sampung magkakaibang proyekto, habang pinapanatili ang isang pare-parehong istruktura. node_modules mas mahigpit.
Semantic Versioning at ang mahika ng Lock Files
Para maiwasan ang pagkataranta sa mga update, ginagamit ang mga sumusunod: Pag-bersyon ng Semantiko (SemVer)na sumusunod sa format na MAJOR.MINOR.PATCH. Ang pagbabago sa bersyong MAJOR ay nagpapahiwatig na mayroong mga pagbabagong hindi tugmaNagdaragdag ang MINOR ng mga bagong tampok nang walang anumang nasisira, at inaayos naman ng PATCH ang mga bug. Ang paggamit ng simbolong caret (^) ay nagbibigay-daan sa mga pag-update sa parehong minor at patch na bersyon, habang ang tilde (~) ay nagpapahintulot lamang sa mga pagbabago sa patch.
Dito sila pumapasok mga file ng pag-lock (bilang package-lock.json o yarn.lockAng mga file na ito ay sagrado at dapat palaging i-upload sa Git repository. Ang kanilang tungkulin ay i-freeze ang eksaktong bersyon ng bawat dependency at ang mga transitibong dependency nito, na tinitiyak na lahat ng mga developer at ang CI/CD environment ay nag-i-install ng eksaktong parehong mga byte.
Seguridad at pag-awdit ng mga dependency
Hindi natin maaaring ipikit ang ating mga mata sa mga kahinaan. Mga kagamitang tulad ng npm audit Pinapayagan tayo ng mga ito na matukoy ang mga depekto sa seguridad sa mga library na ginagamit natin. Depende sa kalubhaan (mula Mababa hanggang Kritikal), dapat nating patakbuhin ang npm audit fix o, sa mas malalang mga kaso, maghanap ng alternatibo sa bookstore na iyon kung hindi pa naglalabas ng patch ang awtor.
Kapag nagtatrabaho tayo sa mga kumpanya, karaniwan nating ginagamit ang mga pribadong modyul naka-host sa mga registry tulad ng Artifact Registry. Para pamahalaan ito nang hindi inilalantad ang mga key sa code, ginagamit namin ang file na .npmrckung saan natin kino-configure ang mga authentication token. Mahalagang gumamit ng mga token mula sa basahin lang sa mga proseso ng pag-deploy upang maiwasan ang isang kompromiso sa seguridad na nagpapahintulot sa pagbabago ng aming mga pakete.
Pagdadala ng Node.js sa isang container environment gamit ang Docker
Ang tunay na kapayapaan ng isip ay dumarating kapag inilalagay natin ang aplikasyon sa isang lalagyan. Pinapayagan tayo ng Docker na lumikha ng isang pare-parehong kapaligiran, na inaalis ang klasikong problemang "gumagana ito sa aking makina". Ang isang pinakamahusay na kasanayan ay i-unlink ang configuration mula sa code gamit ang mga environment variable, ina-access ang mga ito sa pamamagitan ng process.envGinagawa nitong portable at madaling ibagay ang app sa anumang sitwasyon.
Para maayos ito, docker-compose.yml Ito ang pangunahing kagamitan. Pinapayagan ka nitong tukuyin hindi lamang ang Node app, kundi pati na rin ang database (tulad ng MongoDB) at ang mga network na nag-uugnay sa mga ito. Ang isang advanced na trick ay ang paggamit ng pinangalanang mga volume para sa node_modulesPinipigilan nito ang pag-mount ng ating lokal na code mula sa pag-overwrite sa folder ng mga dependency na naka-install sa loob ng container, na nagbibigay-daan sa app na magsimula nang walang mga error.
Isa pang kritikal na punto ay ang pagkakasunud-sunod ng pagsisimula. Hindi natin mailulunsad ang app kung hindi pa handa ang database. Pagpapatupad ng script ng pag-poll tulad ng wait-for.sh Tinitiyak nito na susubukan lamang ng Node server na kumonekta kapag tinatanggap na ng database port ang mga koneksyon ng TCP, na pumipigil sa container na patuloy na mag-restart dahil sa mga paunang error sa koneksyon.
Para ma-optimize ang daloy ng trabaho, maaari nating isama ang mga tool tulad ng nodemon sa devDependenciesSa pamamagitan ng pagpapatakbo nito sa loob ng container gamit ang isang linked volume, anumang mga pagbabagong gagawin natin sa host code ay agad na makikita sa container, awtomatikong ire-restart ang app nang hindi kinakailangang muling buuin ang Docker image sa tuwing babaguhin natin ang isang kuwit.
Masigasig na manunulat tungkol sa mundo ng mga byte at teknolohiya sa pangkalahatan. Gustung-gusto kong ibahagi ang aking kaalaman sa pamamagitan ng pagsusulat, at iyon ang gagawin ko sa blog na ito, ipakita sa iyo ang lahat ng mga pinaka-kagiliw-giliw na bagay tungkol sa mga gadget, software, hardware, teknolohikal na uso, at higit pa. Ang layunin ko ay tulungan kang mag-navigate sa digital na mundo sa simple at nakakaaliw na paraan.