Diena, kai bandžiau sukurti galinę sistemą prieš kavą
Ar kada nors bandėte paleisti galinę sistemą pirmadienio rytą ir supratote, kad jūsų API šliuzas atostogauja su klaida 403 Forbidden, o jūsų duomenų bazė turi įsipareigojimų problemų? Man taip buvo nutikę. Norėjau tik vieno mažyčio galinio taško – tiesiog draugiško /hello – ir kažkaip baigiau diskutuoti apie VPC tarsi rinkdamasis Hogvartso namą.
Geros naujienos: Lovable Cloud bando, kad dalis „sukurti galinę sistemą“ būtų... na... mėgstama. Arba bent jau mažiau įsiutinančia. Jei turite 30 minučių, „Wi-Fi“ ryšį ir pakantumo kelioms metaforoms, aš jums žingsnis po žingsnio parodysiu, kaip sukurti galinę sistemą su Lovable Cloud, į ką atkreipti dėmesį ir kaip neleisti jai virsti galinių taškų makaronų sriuba.
Dėmesio: tai praktinis, tiesioginis vadovas. Mažiau pardavėjų poezijos, daugiau „spustelėkite čia, įveskite tai, nedarykite to“. Ir taip, mes sukursime kažką tikro: veikiantį API su autentifikavimu, duomenų baze, aplinkos paslaptimis, diegimu, stebėsena ir greitu keliu į mastelio keitimą. Pasiimkite užkandį. Mes pradedame.
Kas yra Lovable Cloud ir kodėl jūsų galinei sistemai tai turėtų rūpėti?
Įsivaizduokite Lovable Cloud kaip šiuolaikinį galinės sistemos šveicarišką armijos peiliuką: serverless funkcijos, API maršrutizavimas, duomenų bazės jungtys, aplinkos paslaptys ir CI/CD – visa tai skirta atleisti jus nuo dulkinų YAML failų zoo priežiūros.
- Jūs rašote kodą (Node/TypeScript, Python – patikrinkite dokumentus, kas dabar populiaru).
- Jūs apibrėžiate maršrutus (REST). Jei norite išsiskirti, galite naudoti GraphQL arba laikytis JSON.
- Jūs prijungiate valdomą duomenų bazę (PostgreSQL čia yra tipiškas vidurinės mokyklos numylėtinis).
- Jūs diegiate. Ji keičiasi. Jūs nustojate jaudintis dėl pabudimo 3 val. ryto, kad pridėtumėte daugiau serverių.
Jei jūsų mentalinis „galinės sistemos“ modelis yra: galiniai taškai + autentifikavimas + duomenys + diegimas + žurnalai, Lovable Cloud bando būti greituoju keliu su mažiau pyptelėjimų ir daugiau kvitų.
Žaidimo planas kuriant galinę sistemą su Lovable Cloud
- Sukurkite Lovable Cloud projektą ir saugyklą.
- Sukurkite API su vienu viešu ir vienu apsaugotu maršrutu.
- Pridėkite PostgreSQL duomenų bazę ir paleiskite migraciją.
- Prijunkite aplinkos kintamuosius ir paprastą ORM.
- Pridėkite autentifikavimą (JWT, seanso žetonai arba OAuth – jūsų pasirinkimas).
- Diekite į parengtinę aplinką.
- Pridėkite stebėseną / žurnalų registravimą ir vieną automatinį testą.
- Perkelkite į gamybą nesulaužydami savo ateities širdies.
Taip, skamba kaip daug. Ne, tai neužtruks visą savaitę.
1 žingsnis: paleiskite savo Lovable Cloud projektą (A.K.A. Naujo projekto kvapas)
- Sukurkite paskyrą ir pradėkite naują projektą. Pavadinkite jį taip, kad vėliau atpažintumėte – „not_final_backend_v7“ yra spąstai.
- Pasirinkite savo vykdymo laiką (Node/TypeScript paprastai yra publikos numylėtinis API).
- Pasirinkite šabloną, jei jis yra: „REST API“ arba „Serverless Functions“ padės jums greičiau pasiekti žalią šviesą nei tuščio puslapio baimė.
Gausite „Git“ saugyklą (jūsų arba jų) ir kūrimo aplinką. Papildomi taškai, jei iškart sukursite šaką („feature/hello-api“), kad jūsų pagrindinė šaka netaptų gyvu klaidų muziejumi.
2 žingsnis: sukurkite savo pirmąjį galinį tašką (nes Hello World vis dar veikia)
Sukurkite pagrindinį maršrutą: /api/hello. Tegul jis būna kvailas ir laimingas.
- Maršruto failas:
routes/hello.ts
- Funkcija: grąžina JSON, pvz.,
{ message: "Hello, world" }
- Testuokite vietoje: cURL arba jūsų mėgstamiausias HTTP klientas. Jei negaunate 200, grįžkite atgal ir patikrinkite žurnalus.
Patarimas: stenkitės, kad jūsų maršrutų tvarkytojai būtų maži – jokios verslo logikos galiniame taške. Logiką dėkite į paslaugas. Jūsų ateities refaktoriai jums padėkos.
3 žingsnis: pridėkite duomenų bazę nekviesdami senovinių DevOps dvasių
Pasirinkite PostgreSQL. Jis patikimas, reliacinis ir nealergiškas jungtims.
- Lovable Cloud sukurkite valdomą Postgres egzempliorių.
- Išsaugokite kredencialus kaip aplinkos kintamuosius:
DATABASE_URL, DB_USER, DB_PASS, DB_HOST, DB_NAME.
- Pasirinkite ORM arba užklausų kūrėją („Prisma“, „Drizzle“, „Knex“). Esu linkęs į „Prisma“ dėl greičio ir schemos patikimumo.
Sukurkite mažytę users lentelę, kad įrodytumėte, jog ji veikia:
- Schema:
id (uuid), email (unique), created_at (timestamp).
- Paleiskite migraciją iš savo kūrimo aplinkos.
- Parašykite
GET /api/users galinį tašką, kuris grąžina sąrašą. Pridėkite POST /api/users, kad įterptumėte naują. Apsaugokite jį autentifikavimu (kitas žingsnis), bet kol kas patikrinkite su bandomuoju įterpimu.
Jei matote skirtuosius laikus arba ryšio atstatymus, patikrinkite: teisingą prievadą, SSL režimą ir ar jūsų kūrimo aplinkai leidžiama kalbėtis su DB (VPC taisyklės ir IP leidimų sąrašai mėgsta dramą).
4 žingsnis: pridėkite autentifikavimą, kuris nepriverčia vartotojų verkti
Turite pasirinkimų:
- JWT pagrįstas autentifikavimas be būsenos API
- Seanso žetonai su saugiais slapukais (puikiai tinka žiniatinklio programoms)
- OAuth su „Google“, „GitHub“ ir t. t. (puikiai tinka norint išvengti slaptažodžių skaistyklos)
Norėdami greitai laimėti, pradėkite nuo JWT:
- Generuokite žetonus prisijungiant (
POST /api/auth/login).
- Išsaugokite pasirašymo paslaptį Lovable Cloud paslapčių tvarkyklėje.
- Sukurkite tarpinę programinę įrangą, kuri nuskaito
Authorization: Bearer <token> antraštę.
- Apsaugokite maršrutus, pvz.,
POST /api/users ir viską, kas mutuoja duomenis.
Atminkite: trumpas žetonų galiojimo laikas + atnaujinimo žetonai = mažiau galvos skausmo, kai įrenginiai pametami arba kūrėjai pamiršta, kad paliko žetoną „YouTube“ komentare (neklauskite).
5 žingsnis: aplinkos kintamieji: paslaptys, ne suvenyrai
Centralizuokite paslaptis naudodami Lovable Cloud aplinkos tvarkyklę:
- Trečiųjų šalių API raktai (el. pašto tiekėjas, mokėjimai)
Nustatykite juos kiekvienai aplinkai (kūrimo, parengtinė, gamybos). Nieko nekoduokite. Nedarykite to. Net „tik dabar“. Taip prasideda siaubo istorijos.
6 žingsnis: diekite į parengtinę aplinką neaiškindami to savo ateities terapeutui
Spustelėkite „Deploy“. Stebėkite žurnalus. Kvėpuokite.
- Patikrinkite sveikatos patikrinimus: ar jūsų šaknis arba
/api/health grąžina ok?
- Paleiskite dūmų testą:
GET /api/hello, GET /api/users.
- Išbandykite vieną apsaugotą maršrutą su bandomuoju žetonu – patvirtinkite 401 be jo, 200 su juo.
Jei šaltas paleidimas yra vangus, sugrupuokite mažas funkcijas į vieną paslaugą ten, kur tai prasminga. Serverless yra puikus dalykas, tačiau 400 mažų funkcijų gali būti orkestras be dirigento.
7 žingsnis: pridėkite stebėseną, kad 2 val. ryto nesekiotumėte
- Įgalinkite užklausų registravimą (struktūrizuotus žurnalus, prašau).
- Nustatykite klaidų fiksavimą (stekų sekimai su užklausos ID).
- Pridėkite latentinių periodų informacijos suvestines. Stebėkite p95, o ne tik p50. Jūsų vartotojai nepatiria vidurkių.
- Sukurkite įspėjimus apie 5xx šuolius ir DB ryšio kaitą.
Viena žurnalo eilutė su užklausos ID kiekviename sluoksnyje yra verta 10 000 „Slack“ pranešimų, kurie prasideda nuo „Ar kas nors tai mato?"
8 žingsnis: parašykite vieną testą. Tada du. Tada automatizuokite.
Pradėkite nuo mažo:
- Vienetinis testas: paslaugos funkcija, kuri patvirtina el. laiškus arba apskaičiuoja sumas.
- Integracijos testas: iškvieskite
/api/users su bandomąja DB.
Prijunkite CI, kad paleistumėte testus atliekant pull requests. Jokie PR nesujungiami su raudonais testais. Jums nereikia tūkstančio testų šiandien – tik kritinių kelių. Kaip saugos diržai.
9 žingsnis: perkelkite į gamybą (taip, atsargiai)
- Užšaldykite main valandai. Pirmiausia įkelkite pataisymus į parengtinę aplinką.
- Perkelkite build. Paleiskite dūmų testą po diegimo.
- Įgalinkite dažnio ribojimą viešuose galiniuose taškuose.
- Jei talpyklą naudojate, nustatykite protingus TTL. Jei nenaudojate talpyklos, pasiruoškite, kad jūsų DB į jus žiūrės pavargusiomis akimis.
Pridėkite atšaukimo planą: turėdami jį, jūs neapgaunate. Jūs elgiatės kaip suaugęs.
Paprasta, tikra galinė sistema, kurią galite pristatyti per popietę
Prijunkime mažytę, bet tikrą funkcijų rinkinį:
- Viešas
GET /api/hello (sveikata ir patikimumas).
- Apsaugotas
POST /api/users (sukurti vartotoją) ir GET /api/me (grąžina autentifikuotą vartotoją).
GET /api/users/:id tiesioginėms paieškoms.
- Švelnus trynimas:
DELETE /api/users/:id perjungia deleted_at.
Pridėkite dažnio ribojimą /api/auth/login, kad robotai nenaudotų jūsų galinės sistemos kaip kardio treniruotės.
Tada įtraukite pasveikinimo el. laišką per savo el. pašto tiekėją. Laiškas turi būti transakcinis ir draugiškas – rinkodarą pasilikite tikriems rinkodaros maršrutams.
Dažnos spąstai kuriant galinę sistemą su Lovable Cloud
- Bendra būsena serverless: nesiremkite atminties talpyklomis tarp iškvietimų. Naudokite „Redis“ (valdomą) arba savo DB.
- Trūksta CORS konfigūracijos: nustatykite leidžiamus šaltinius. Apribokite savo programos domenu (-ais). Negalima naudoti pilno pakaitos simbolio gamyboje.
- Ilgas šaltas paleidimas: sumaniai susiekite priklausomybes, sumažinkite perkrovą vienai funkcijai arba sujunkite karštus kelius.
- Neindeksuotos užklausos: jei jūsų
GET /api/users nuskaitymas yra lėtas, pridėkite indeksą email ir created_at. Jūsų ateities aš jums padėkos.
- Tylus gedimai: visada registruokite klaidas su kontekstu. „Kažkas sugedo“ nėra DevOps poezija.
Kaip struktūrizuoti kodą, kad vėliau neverktumėte
routes/ skirtas galiniams taškams
services/ skirta verslo logikai
repositories/ arba db/ skirta duomenų prieigai
middlewares/ skirta autentifikavimui, dažnio ribojimui, įvesties patvirtinimui
lib/ skirta pagalbininkams (el. paštas, kriptografija, trečiųjų šalių API)
Jei įmanoma, laikykite funkcijas grynas. Šalutinius poveikius palikite pakraščiuose. Tai palengvina testavimą, o derinimas tampa mažiau panašus į kriminalinį šou.
Našumo patobulinimai, kurie iš tikrųjų svarbūs
- Naudokite puslapių numeraciją bet kuriame sąrašo galiniame taške. Kursoriais pagrįstas, jei turite didelius duomenų rinkinius.
- Pridėkite ETag arba paskutinio modifikavimo antraštes, kad nereikėtų iš naujo siųsti viso pasaulio su kiekviena užklausa.
- Talpykloje saugokite apskaičiuotus atsakymus brangioms užklausoms.
- Kai galite, sugrupuokite rašymą. N+1 užklausos yra galinės sistemos klaidų blizgučiai – jie patenka visur.
Saugumo pagrindai, kurių negalite ignoruoti (net jei norite)
- Patvirtinkite įvestį kiekviename maršrute. JSON schema arba patvirtinimo biblioteka apsaugo nuo netikėtų atakų.
- Maišykite slaptažodžius su Argon2 arba bcrypt. Niekada nekurkite savo kriptografijos. Niekada. Prašau.
- Reguliariai keiskite raktus ir paslaptis. Kalendoriaus priminimai yra pigesni nei pažeidimai.
- Naudokite mažiausių privilegijų duomenų bazės vaidmenis. Jūsų API nereikia supervartotojo galių – niekam nereikia.
Kainų realybės patikrinimas: planuokite augimą, o ne širdies skausmą
Serverless jaučiasi nemokamas... kol nebėra. Stebėkite:
- Šalto paleidimo baudos, kai srautas yra šuoliuojantis.
- Išėjimo išlaidos šnekantiems API.
- Ilgai veikiančios funkcijos, kurios turėtų būti foninės užduotys.
Nustatykite biudžetus ir įspėjimus. Jei jūsų finansų direktorius atsiųs jums ugnies jaustuką, jau bus per vėlu.
Kada jums reikia dokumentų, pavyzdžių ir patikrinimo
Gyvenu pagal dvi tiesas: jūs pamiršite, kaip ką nors sukonfigūravote, ir jums reikės tai vėl nustatyti 23 val. Laikykite README savo saugykloje su:
- Aplinkos nustatymo veiksmai
- Dažnos komandos (migracijos, testai, diegimas)
- Galinių taškų sąrašas su užklausų pavyzdžiais
Padarykite jį draugišku naujam sau po trijų mėnesių – arba tikram naujam komandos draugui kitą savaitę.
Verta paminėti: nuoroda tyrimams ir kodo peržiūroms
Verta paminėti: jei norite antros nuomonės apie architektūros pasirinkimus arba greitai palyginti geriausią praktiką, Sider.AI gali veikti kaip tas be jokių nesąmonių komandos draugas, kuris peržiūri jūsų planą, nurodo keistus kraštutinius atvejus ir įteikia kontrolinį sąrašą prieš jums išsiunčiant. Jis nepaspaus „Deploy“ už jus, bet padės išvengti „o ne“ Slack gijos. Greita nuoroda: jūsų Lovable Cloud galinės sistemos kontrolinis sąrašas
- Projektas sukurtas, Git nustatytas, šakų strategija
- Sveikinimo galinis taškas, grąžinantis JSON
- Duomenų bazė paruošta, migracija paleista, ORM prijungtas
- Autentifikavimas įdiegtas, paslaptys aplinkos tvarkyklėje
- Parengtinė aplinka įdiegta, žurnalai švarūs, apsaugoti maršrutai veikia
- Stebėsena, įspėjimai, pagrindinės informacijos suvestinės
- Testai prijungti prie CI, nėra raudonų PR
- Gamybos diegimas su dažnio ribojimu ir atšaukimo planu
Priklijuokite tai prie monitoriaus. Arba pasidarykite tatuiruotę. (Prašau, nesidarykite tatuiruotės.)
Apibendrinimas: padarykite tai mylimu, padarydami tai nuobodžiu (gera prasme)
Mylima galinė sistema yra ta, kuri tyliai atlieka savo darbą, kol jūs miegate. Kurkite naudodami nuobodžias, patikrintas dalis: HTTP galinius taškus, švarų autentifikavimą, tvirtą duomenų bazę ir protingą diegimą. Lovable Cloud padeda pašalindama pastolių dramą, kad galėtumėte sutelkti dėmesį į tai, kas svarbu – savo produktą, savo vartotojus ir galbūt net tą kavą, kurią praleidote.
Išsiųskite /hello. Pridėkite /users. Priveržkite varžtus. Tada eikite daryti bet ką kita, kol jūsų galinė sistema dūzgia. Tai ne tik mylima – tai gyvenimas.
Mini klausimai ir atsakymai: realaus pasaulio scenarijai
Ar galiu maišyti viešus ir privačius API tame pačiame projekte?
Taip. Naudokite tarpinę programinę įrangą, kad užblokuotumėte privačius maršrutus ir atskirtumėte žetonus / raktus mašinos-mašinai srautui. Laikykite apimtis siauras.
Ką daryti, jei man reikia foninių užduočių?
Paleiskite suplanuotas arba eilės valdomas funkcijas ilgai trunkančiam darbui (el. laiškai, ataskaitos, sinchronizavimas). Neblokuokite vartotojų užklausų, kad išsiųstumėte naujienlaiškius.
Kaip man neleisti parengtinės ir gamybos aplinkoms keistis paslaptimis kaip paaugliams?
Atskirti aplinkas. Atskirti paslaptis. Apsaugos priemonės CI, kad parengtinės aplinkos kredencialai niekada neprasiskverbtų į gamybos build.
Ar galiu pradėti paprastai ir vėliau pereiti prie pilnų mikroservisų?
Visiškai. Pradėkite nuo monolito, kad būtų greičiau. Ištraukite karštas vietas, kai jūsų metrika sako „dabar“, o ne tada, kai podcast'as sako „mikroservisai yra šaunūs“.
Kiti žingsniai: jūsų 30 minučių planas
- 5 minutės: sukurkite projektą, pasirinkite šabloną
- 10 minučių: sukurkite
/api/hello, prijunkite duomenų bazę, paleiskite migraciją
- 10 minučių: pridėkite JWT autentifikavimą, apsaugokite
POST /api/users
- 5 minutės: diekite į parengtinę aplinką, paleiskite dūmų testą
Viskas. Jūs ką tik sukūrėte galinę sistemą su Lovable Cloud. Ji veikia. Ji keičiasi. Ir jūs vis dar turite laiko pašildyti savo kavą.
DUK
Q1:Ar Lovable Cloud tinka pradedantiesiems, kuriantiems galinę sistemą?
Taip – jo šablonai, serverless funkcijos ir aplinkos tvarkyklė padaro pirmąją galinę sistemą daug mažiau bauginančia. Pradėkite nuo paprasto REST API, pridėkite duomenų bazę, tada pridėkite autentifikavimą. Išmoksite tikrų šablonų nekovodami su duomenų centru.
Q2:Kaip apsaugoti savo Lovable Cloud galinę sistemą gamybai?
Naudokite JWT arba OAuth, užrakinkite CORS ir saugokite paslaptis aplinkos tvarkyklėje. Pridėkite dažnio apribojimus, patvirtinkite įvestį kiekviename maršrute ir stebėkite p95 latentinį periodą, kad pastebėtumėte problemas anksčiau nei vartotojai.
Q3:Kuri duomenų bazė geriausiai veikia su Lovable Cloud REST API?
PostgreSQL yra patikimas pasirinkimas daugeliui programų, ypač su ORM, pvz., Prisma arba Drizzle. Jis tvarko reliacinius duomenis, transakcijas ir indeksavimą be dramos ir keičiasi, kai srautas auga.
Q4:Kaip tvarkyti šaltus paleidimus ir našumą serverless galinėse sistemose?
Sumaniai susiekite priklausomybes, apšildykite kritinius kelius ir venkite šimto mažų funkcijų, kai viena paslauga atliks darbą. Pridėkite talpyklą ir puslapių numeraciją ir stebėkite p95 latentinį periodą, kad sureguliuotumėte tai, kas iš tikrųjų svarbu.
Q5:Ar galiu diegti parengtinę ir gamybos aplinkas su atskiromis paslaptimis ir URL?
Visiškai. Sukurkite atskiras aplinkas, nustatykite skirtingus DATABASE_URL, JWT_SECRET ir domenus ir perkelkite build į priekį. Tai užtikrina saugų testavimą ir neskausmingą atšaukimą.
