ViennaNET: raamatukogude kogum backend’ile

Tere kõigile!

Me oleme .NET-arendajate kogukond Raiffeisenbankist ja tahame rääkida .NET Core'i infrastruktuuriraamatukogudest, mis võimaldavad kiiresti luua mikroteenuseid ühes ekosüsteemis. Oleme selle viinud avatud lähtekoodiga!

Enne kui liigume edasi

Kusagil oli meil suur monoliitne projekt, mis muutus järk-järgult mikroteenuste kogumiks (selle protsessi kohta saab lugeda selles artiklis). Protsessi käigus kohtasime probleemi, et uute mikroteenuste loomisel pidime sageli kopeerima erinevaid infrastruktuuri lahendusi – nagu logimise seadistamine, andmebaasi kasutamine, WCF jne. Selle projekti kallal töötas üks meeskond ja kõik olid harjunud teatud kindla lähenemisega infrastruktuuri loomisel. Seetõttu eraldasime ühise koodi eraldi repositooriumisse, kokku pandud raamatukogud pakkisime Nuget-pakettideks ja paigutasime meie sisemisse Nuget-hoidlasse.

Aeg möödus, projekt puhkes mitmeks osaks, tekkis soov luua uusi kliendipoolseid mooduleid kaasaegses Js-raamistikus ja käivitada neid brauseris. Me alustasime üleminekut WCF/SOAP-ist REST/HTTP-le, seetõttu vajasime uusi raamatukogusid, et kiiresti käivitada teenuseid AspNet WebApi baasil. Esimene versioon .Net Framework 4.5-lt tehti meie arhitekti poolt peaaegu vahepeal vabal ajal, kuid see võimaldas juba kastist välja kolmes reas Program.cs-s käivitada teenust, mis sisaldas autoriseerimist (NTLM), logimist, Swaggerit, IoC/DI Castle Windsor baasil, seadistatud HTTP-kliente, mis edastasid erinevaid päiseid, et tagada ühtne logimine kogu projektis. Ja kõik see oli võimalik ka lisakorraldamiseks teenuse konfiguratsioonifailis.

Kuid kõik ei kulgenud sujuvalt: see raamatukogu osutus uute moodulite sisestamise osas äärmiselt jäigaks. Näiteks, kui oli vaja lisada mõni eriline middleware, tuli luua uus kogumik ja pärida teenust käivitavast baasklassist, mis oli äärmiselt ebamugav. Õnneks selliseid juhtumeid ei olnud liiga palju.

Docker ja Kubernetes ajastu

On jõudnud aeg, mil ka meie juurde on jõudnud Docker ja Kubernetes, mida oleme tähelepanelikult jälginud: see oli suurepärane võimalus liikuda edasi tehnoloogiatega, .Net Core'i suunas. Seega vajame uut infrastruktuuri teenuste käivitamiseks: osa raamatukogusid on üle viidud .Net Frameworkilt .Net Standard'ile ja .Net Core'ile peaaegu muutumatuna, osa väikeste täiustustega. Aga kõige rohkem soovime ümber töötada AspNet Core'i teenuste käivitamisega seotud funktsionaalsust.

Esimese asjana kaaluti kontsepti, mis kõrvaldab eelmise versiooni peamise puuduse: paindlikkuse puudumise. Seetõttu otsustati muuta kogu raamatukogude süsteem võimalikult sõltumatuks ja modulaarseks ning koguda vajalikud teenused funktsionaalsuse järgi nagu konstruktori ehitamisel.

Peamine eesmärk on luua ühtne lähenemine, mis kirjeldab, kuidas suhelda andmebaaside, busside ja teiste teenustega. Püüdsime, et integreerimine oleks kiire ja valutuks ning arendajad saaksid keskenduda äri loogika kirjutamisele, mitte infrastruktuurile - see on juba valmis. Ühine repodeerimine aitab parandada koostöökogemust meeskondade vahel: kui kasutatakse väga sarnaseid sisemisi infrastruktuure, on lihtsam muuta teiste meeskondade arendusse ja jagada oma teadmisi.

Miks me vajame Open Source'i?

Soovime näidata oma ekspertiisi küpsust ja saada kvaliteetset tagasisidet: inimene, kes on väljaspool pankade süsteemi, suudab tuua midagi uut. Meid huvitab ka praktika arendamine mikroteenuste ja DDD osas .NET-is tööstuses, võib-olla tahab keegi osa raamistiku osade enda juurde võtta.

Oma osa on ViennaNET

Nüüd vaatame kõike lähemalt. Täielik lähtekood on siin.

ViennaNET.WebApi.*

See raamatukogude komplekt koosneb 'juurest' ViennaNET.WebApi, mis sisaldab CompanyHostBuilder teenuse konstruktorit, ja hulgast konfiguratoritest ViennaNET.WebApi.Configurators.*, millest igaüks võimaldab lisada ja konfigureerida teatud funktsionaalsust loodud teenuses. Konfiguratorite seast võib leida logimise, diagnostika, autentimise ja autoriseerimise tüüpe, swaggerit jms.

Siin ViennaNET.WebApi.Runners.* sisaldab eelnevalt seadistatud teenuste ehitajaid. Need paketid võimaldavad igakordse uue teenuse loomisel meeles pidada, millised konfigureerijad tuleb ühendada. Samas ei piira need teenuste ehitajate funktsionaalsust.

ViennaNET.Mediator.*

Raamatukogud, mis võimaldavad luua sisemise vahesilla käsud ja päringud teenuse sees. Selline lähenemine vähendab DI-süstimist näiteks kontrollerites ühe juhul. Seda saab teha erinevate dekoratorite lisamisega päringutele, mis ühtlustab nende töötlemist ja vähendab koodi hulka.

ViennaNET.Validation

Kogum, mis sisaldab klasside komplekti valideerimisreeglite ja nende järjestuste loomiseks. Väga mugav domaaniväärtingute rakendamiseks, kuna see võimaldab iga ärijoont kirjeldada lihtsa ja eraldi reegliga.

ViennaNET.Redis

Raamatukogu Redisiga mugavaks töötamiseks mälu kohandajana.

ViennaNET.Specifications

Kogum, mis sisaldab klasside komplekti, mis rakendavad 'Spetsifikatsiooni' mustrit.

See pole kaugeltki kõik, mis meie komplektis on. Ülejäänut saab vaadata GitHubi hoidlast. Peagi on plaanis avaldada meie andmebaaside tööks mõeldud raamatukogusid avatud lähtekoodina.

Aitäh tähelepanu eest, ootame teie kommentaare ja pull request’e.

Allikas: habr.com