Diena, kad es mēģināju izveidot servera pusi pirms kafijas
Vai esi kādreiz mēģinājis uzcelt servera pusi pirmdienas rītā — tikai lai saprastu, ka tava API vārteja atrodas atvaļinājumā 403 Forbidden režīmā un tavai datubāzei ir problēmas ar saistību uzņemšanos? Man reiz tā bija. Es vēlējos tikai vienu mazu galapunktu — tikai draudzīgu /hello — un kaut kā es nonācu pie strīda par VPC, it kā es izvēlētos Cūkkārpas māju.
Lūk, labā ziņa: Lovable Cloud cenšas padarīt “servera puses izveides” daļu… nu… mīļu. Vai vismaz mazāk dusmu izraisošu. Ja tev ir 30 minūtes, Wi-Fi savienojums un tolerance pret dažām metaforām, es tev soli pa solim izstāstīšu, kā izveidot servera pusi ar Lovable Cloud — soli pa solim, kam pievērst uzmanību un kā neļaut tai pārvērsties par galapunktu spaGeti bļodu.
Uzmanību: šis ir praktisks, praktisks ceļvedis. Mazāk piegādātāju dzejas, vairāk “noklikšķiniet šeit, ierakstiet šo, nedariet to”. Un jā, mēs piegādāsim kaut ko reālu: darba API ar autentifikāciju, datubāzi, vides noslēpumiem, izvietošanu, uzraudzību un ātru ceļu uz mērogošanu. Paņem uzkodu. Mēs piegādājam.
Kas ir Lovable Cloud un kāpēc tavai servera pusei par to vajadzētu rūpēties?
Padomājiet par Lovable Cloud kā par modernu servera puses Šveices armijas nazi: serverless funkcijas, API maršrutēšana, datubāzes savienojumi, vides noslēpumi un CI/CD — tas viss ir paredzēts, lai pasargātu jūs no putekļaina YAML failu zooloģiskā dārza uzturēšanas.
- Jūs rakstāt kodu (Node/TypeScript, Python — pārbaudiet dokumentus, lai uzzinātu, kas pašlaik ir aktuāls).
- Jūs definējat maršrutus (REST). Ja vēlaties, varat izmantot GraphQL vai palikt pie JSON.
- Jūs pievienojat pārvaldītu datubāzi (PostgreSQL šeit parasti ir vidusskolas mīļākā).
- Jūs izvietojat. Tas mērogojas. Jūs vairs neuztraucaties par pamošanos pulksten 3:00, lai pievienotu vairāk serveru.
Ja tavs garīgais modelis par “servera pusi” ir: galapunkti + autentifikācija + dati + izvietošana + žurnāli, Lovable Cloud cenšas būt ātrgaitas josla ar mazāk pīkstieniem un vairāk čekiem.
Spēles plāns servera puses izveidei ar Lovable Cloud
- Izveidojiet Lovable Cloud projektu un repozitoriju.
- Izveidojiet API ar vienu publisku un vienu aizsargātu maršrutu.
- Pievienojiet PostgreSQL datubāzi un palaidiet migrāciju.
- Savienojiet vides mainīgos un vienkāršu ORM.
- Pievienojiet autentifikāciju (JWT, sesijas marķieri vai OAuth — jūsu izvēle).
- Izvietojiet inscenējuma vidē.
- Pievienojiet uzraudzību/reģistrēšanu un vienu automatizētu testu.
- Pārejiet uz ražošanu, nesalaužot savu nākotnes pašapziņu.
Jā, tas izklausās daudz. Nē, tas neaizņems visu nedēļu.
1. solis: palaidiet savu Lovable Cloud projektu (A.K.A. jauna projekta smarža)
- Izveidojiet kontu un sāciet jaunu projektu. Nosauciet to tā, lai jūs to atpazītu vēlāk — “not_final_backend_v7” ir slazds.
- Izvēlieties savu izpildlaiku (Node/TypeScript parasti ir pūļa iecienītākais API).
- Izvēlieties veidni, ja tāda ir pieejama: “REST API” vai “Serverless Functions” ļauj ātrāk pāriet uz zaļo, nevis tukšas lapas bailes.
Jūs saņemsiet Git repozitoriju (jūsu vai viņu) un izstrādes vidi. Bonusa punkti, ja jūs uzreiz atzarojat (“feature/hello-api”), lai jūsu galvenā atzarošana nekļūtu par dzīvu kļūdu muzeju.
2. solis: izveidojiet savu pirmo galapunktu (jo Hello World joprojām ir aktuāls)
Izveidojiet pamata maršrutu: /api/hello. Saglabājiet to stulbu un laimīgu.
- Maršruta fails:
routes/hello.ts
- Funkcija: atgriež JSON, piemēram,
{ message: "Hello, world" }
- Testējiet lokāli: cURL vai jūsu iecienītākais HTTP klients. Ja nesaņemat 200, atgriezieties un pārbaudiet žurnālus.
Profesionāļa padoms: saglabājiet savus maršruta apstrādātājus slaidus — galapunktā nav biznesa loģikas. Ievietojiet loģiku pakalpojumos. Jūsu nākotnes refaktori jums pateiksies.
3. solis: pievienojiet datubāzi, neizsaucot senos DevOps garus
Izvēlieties PostgreSQL. Tas ir uzticams, relāciju un nav alerģisks pret savienojumiem.
- Lovable Cloud izveidojiet pārvaldītu Postgres instanci.
- Saglabājiet akreditācijas datus kā vides mainīgos:
DATABASE_URL, DB_USER, DB_PASS, DB_HOST, DB_NAME.
- Izvēlieties ORM vai vaicājumu veidotāju (Prisma, Drizzle, Knex). Esmu noskaņots uz Prisma ātruma un shēmas saprāta dēļ.
Izveidojiet nelielu users tabulu, lai pierādītu, ka tā darbojas:
- Shēma:
id (uuid), email (unikāls), created_at (timestamp).
- Palaidiet migrāciju no savas izstrādes vides.
- Uzrakstiet
GET /api/users galapunktu, kas atgriež sarakstu. Pievienojiet POST /api/users, lai ievietotu jaunu. Aizsargājiet to ar autentifikāciju (nākamais solis), bet pagaidām pārbaudiet ar testa ievietošanu.
Ja redzat taimautus vai savienojuma atiestatīšanu, pārbaudiet: pareizu portu, SSL režīmu un to, vai jūsu izstrādes videi ir atļauts sazināties ar DB (VPC noteikumi un IP atļauju saraksti mīl drāmu).
4. solis: pievienojiet autentifikāciju, kas neliek lietotājiem raudāt
Jums ir iespējas:
- Uz JWT balstīta autentifikācija bezstatūras API
- Sesijas marķieri ar drošiem sīkfailiem (lieliski piemēroti tīmekļa lietotnēm)
- OAuth ar Google, GitHub utt. (lieliski piemēroti, lai izvairītos no paroles šķīstītavas)
Lai ātri gūtu panākumus, sāciet ar JWT:
- Ģenerējiet marķierus, piesakoties (
POST /api/auth/login).
- Saglabājiet parakstīšanas slepeno atslēgu Lovable Cloud slepeno atslēgu pārvaldniekā.
- Izveidojiet starpprogrammatūru, kas nolasa
Authorization: Bearer <token> galveni.
- Aizsargājiet maršrutus, piemēram,
POST /api/users un visu, kas mutē datus.
Atcerieties: īss marķiera darbības laiks + atsvaidzināšanas marķieri = mazāk galvassāpju, ja ierīces tiek pazaudētas vai izstrādātāji aizmirst, ka ir atstājuši marķieri YouTube komentārā (nejautājiet).
5. solis: vides mainīgie: noslēpumi, nevis suvenīri
Centralizējiet slepenos datus, izmantojot Lovable Cloud vides pārvaldnieku:
- Trešo pušu API atslēgas (e-pasta pakalpojumu sniedzējs, maksājumi)
Iestatiet tos katrai videi (izstrādei, inscenēšanai, ražošanai). Nekodējiet neko. Nē. Pat “tikai tagad”. Tā sākas šausmu stāsti.
6. solis: izvietojiet inscenēšanai, nepaskaidrojot to savam nākotnes terapeitam
Noklikšķiniet uz Izvietot. Vērojiet žurnālus. Elpojiet.
- Validējiet veselības pārbaudes: vai jūsu sakne vai
/api/health atgriež ok?
- Palaidiet dūmu testu:
GET /api/hello, GET /api/users.
- Izmēģiniet vienu aizsargātu maršrutu ar testa marķieri — apstipriniet 401 bez tā, 200 ar to.
Ja aukstie starti ir lēni, apvienojiet mazas funkcijas vienā pakalpojumā, kur tas ir saprātīgi. Serverless ir lieliski, taču 400 mazas funkcijas var būt orķestris bez diriģenta.
7. solis: pievienojiet uzraudzību, lai jūs neminētu pulksten 2:00
- Iespējojiet pieprasījumu reģistrēšanu (strukturētus žurnālus, lūdzu).
- Iestatiet kļūdu uztveršanu (steku izsekošana ar pieprasījuma ID).
- Pievienojiet latentuma informācijas paneļus. Vērojiet p95, ne tikai p50. Jūsu lietotāji neizjūt vidējos rādītājus.
- Izveidojiet brīdinājumus par 5xx lēcieniem un DB savienojuma izmaiņām.
Viena žurnāla rinda ar pieprasījuma ID katrā slānī ir 10 000 Slack ziņojumu vērta, kas sākas ar “Vai kāds to redz?”
8. solis: uzrakstiet vienu testu. Pēc tam divus. Pēc tam automatizējiet.
Sāciet ar mazumiņu:
- Vienības tests: pakalpojuma funkcija, kas validē e-pastus vai aprēķina kopsummas.
- Integrācijas tests: zvaniet
/api/users ar testa DB.
Savienojiet CI, lai palaistu testus, veicot vilkšanas pieprasījumus. Nav PR apvienošanas ar sarkaniem testiem. Šodien jums nav vajadzīgs tūkstotis testu — tikai kritiskie ceļi. Tāpat kā drošības jostas.
9. solis: pārejiet uz ražošanu (jā, uzmanīgi)
- Iesaldējiet galveno uz stundu. Vispirms novietojiet labojumus inscenēšanai.
- Paaugstiniet būvējumu. Palaidiet dūmu testu pēc izvietošanas.
- Iespējojiet ātruma ierobežošanu publiskajos galapunktos.
- Ja kešatmiņa, iestatiet saprātīgus TTL. Ja neizmantojat kešatmiņu, sagatavojieties, ka jūsu DB skatīsies uz jums ar nogurušām acīm.
Pievienojiet atgriešanas plānu: jums nav slikta zīme, ja tāds ir. Jūs esat pieaudzis cilvēks.
Vienkārša, reāla servera puse, ko varat piegādāt pēcpusdienā
Savienosim nelielu, bet reālu funkciju kopumu:
- Publisks
GET /api/hello (veselība un saprāts).
- Aizsargāts
POST /api/users (izveidot lietotāju) un GET /api/me (atgriež autentificētu lietotāju).
GET /api/users/:id tiešajiem meklējumiem.
- Mīksta dzēšana:
DELETE /api/users/:id pārslēdz deleted_at.
Pievienojiet ātruma ierobežošanu /api/auth/login, lai roboti neizmantotu jūsu servera pusi kā kardio.
Pēc tam apkaisiet ar sagaidīšanas e-pastu, izmantojot savu e-pasta pakalpojumu sniedzēju. Saglabājiet ziņojumu transakciju un draudzīgu — saglabājiet mārketingu faktiskajiem mārketinga maršrutiem.
Bieži slazdi, veidojot servera pusi ar Lovable Cloud
- Kopīgais stāvoklis serverless: nepaļaujieties uz atmiņas kešatmiņām starp izsaukumiem. Izmantojiet Redis (pārvaldītu) vai savu DB.
- Trūkst CORS konfigurācijas: iestatiet atļautos izcelsmes punktus. Ierobežojiet līdz savas lietotnes domēnam(-iem). Neizmantojiet pilnu aizstājējzīmi ražošanā.
- Ilgi auksti starti: gudri apvienojiet atkarības, samaziniet katras funkcijas uzpūšanos vai konsolidējiet karstos ceļus.
- Neindeksēti vaicājumi: ja jūsu
GET /api/users rāpo, pievienojiet indeksu email un created_at . Jūsu nākotnes es sūta pateicības.
- Klusas kļūmes: vienmēr reģistrējiet kļūdas ar kontekstu. “Kaut kas salūza” nav DevOps dzeja.
Kā strukturēt kodu, lai vēlāk neraudātu
services/ biznesa loģikai
repositories/ vai db/ datu piekļuvei
middlewares/ autentifikācijai, ātruma ierobežošanai, ievades validācijai
lib/ palīgiem (e-pasts, kriptogrāfija, trešo pušu API)
Saglabājiet funkcijas tīras, kad vien iespējams. Novietojiet blakusparādības malās. Tas atvieglo testēšanu un atkļūdošanu padara mazāk līdzīgu kriminālšovam.
Veiktspējas uzlabojumi, kam patiešām ir nozīme
- Izmantojiet lapošanu jebkurā saraksta galapunktā. Uz kursora bāzes, ja jums ir lielas datu kopas.
- Pievienojiet ETag vai pēdējās modificēšanas galvenes, lai izvairītos no pasaules atkārtotas nosūtīšanas katrā pieprasījumā.
- Kešatmiņā aprēķinātas atbildes dārgiem vaicājumiem.
- Apvienojiet rakstīšanu, kad varat. N+1 vaicājumi ir servera puses kļūdu mirdzums — tie nonāk visur.
Drošības pamati, kurus jūs nevarat ignorēt (pat ja vēlaties)
- Validējiet ievadi katrā maršrutā. JSON shēma vai validācijas bibliotēka novērš negaidītus uzbrukumus.
- Jauc paroles ar Argon2 vai bcrypt. Nekad nerullējiet savu kriptogrāfiju. Nekad. Lūdzu.
- Regulāri rotējiet atslēgas un noslēpumus. Kalendāra atgādinājumi ir lētāki par pārkāpumiem.
- Izmantojiet datubāzes lomas ar vismazākajām privilēģijām. Jūsu API nav nepieciešamas superlietotāja pilnvaras — nevienam nav.
Cenu realitātes pārbaude: plānojiet izaugsmi, nevis dedzināšanu
Serverless jūtas brīvi… līdz brīdim, kad tas tā nav. Uzraugiet:
- Auksti starta sodi, kad satiksme ir pīķa.
- Izejas izmaksas pļāpīgām API.
- Ilgstošas funkcijas, kurām vajadzētu būt fona darbiem.
Iestatiet budžetus un brīdinājumus. Ja jūsu finanšu direktors jums nosūta uguns emocijzīmi, ir jau par vēlu.
Kad jums ir nepieciešama dokumentācija, piemēri un saprāta pārbaude
Es dzīvoju pēc divām patiesībām: jūs aizmirsīsit, kā kaut ko konfigurējāt, un jums tas atkal būs jāiestata pulksten 23:00. Saglabājiet README savā repozitorijā ar:
- Vides iestatīšanas darbības
- Biežas komandas (migrācijas, testi, izvietošana)
- Galapunktu saraksts ar pieprasījumu piemēriem
Padariet to draudzīgu jaunajam jūs pēc trim mēnešiem — vai faktiskajam jaunajam komandas biedram nākamnedēļ.
Vērts atzīmēt: saīsne pētniecībai un koda pārskatīšanai
Vērts atzīmēt: ja vēlaties saņemt otru viedokli par arhitektūras izvēlēm vai ātri salīdzināt labāko praksi, Sider.AI var rīkoties kā šis nopietnais komandas biedrs, kurš pārskata jūsu plānu, norāda uz dīvainajiem gadījumiem un pasniedz kontrolsarakstu pirms nosūtīšanas. Tas jūsu vietā nenoklikšķinās uz Izvietot — bet tas palīdzēs jums izvairīties no “ak, nē” Slack pavediena. Īsa atsauce: jūsu Lovable Cloud servera puses kontrolsaraksts
- Projekts izveidots, Git iestatīts, atzarošanas stratēģija
- Sveiciena galapunkts, kas atgriež JSON
- Datubāze nodrošināta, migrācija palaista, ORM savienots
- Autentifikācija ir ieviesta, noslēpumi vides pārvaldniekā
- Inscenēšana izvietota, žurnāli tīri, aizsargāti maršruti darbojas
- Uzraudzība, brīdinājumi, pamata informācijas paneļi
- Testi savienoti ar CI, nav sarkanu PR
- Ražošanas ieviešana ar ātruma ierobežošanu un atgriešanas plānu
Pielīmējiet to pie monitora. Vai uzlieciet tetovējumu. (Lūdzu, neuzlieciet to tetovējumu.)
Kopsavilkums: padariet to mīļu, padarot to garlaicīgu (labā ziņā)
Mīļa servera puse ir tāda, kas klusi dara savu darbu, kamēr jūs guļat. Veidojiet ar garlaicīgiem, pārbaudītiem elementiem: HTTP galapunktiem, tīru autentifikāciju, izturīgu datubāzi un saprātīgu izvietošanu. Lovable Cloud palīdz, novēršot sastatņu drāmu, lai jūs varētu koncentrēties uz svarīgākajām daļām — savu produktu, saviem lietotājiem un varbūt pat to kafiju, kuru izlaidāt.
Nosūtiet /hello. Pievienojiet /users. Pievelciet skrūves. Pēc tam dariet burtiski jebko citu, kamēr jūsu servera puse dūc līdzi. Tas nav tikai mīļš — tā ir dzīvošana.
Mini jautājumi un atbildes: reāli scenāriji
Vai vienā un tajā pašā projektā varu apvienot publiskas un privātas API?
Jā. Izmantojiet starpprogrammatūru, lai bloķētu privātos maršrutus, un atdaliet marķierus/atslēgas iekārtu savstarpējai satiksmei. Saglabājiet šķirkļus cieši.
Ko darīt, ja man ir nepieciešami fona darbi?
Palaidiet ieplānotas vai rindas vadītas funkcijas ilgstošam darbam (e-pasti, atskaites, sinhronizācija). Nebloķējiet lietotāju pieprasījumus, lai nosūtītu jaunumus.
Kā es varu pasargāt inscenēšanu un ražošanu no noslēpumu apmaiņas kā pusaudži?
Atdaliet vides. Atdaliet noslēpumus. Aizsarglīdzekļi CI, lai inscenēšanas akreditācijas dati nekad neiekļūtu ražošanas būvējumos.
Vai es varu sākt vienkārši un vēlāk pāriet uz pilniem mikropakalpojumiem?
Noteikti. Sāciet monolītiski ātruma dēļ. Izņemiet karstos punktus, kad jūsu metrika saka “tagad”, nevis tad, kad aplāde saka “mikropakalpojumi ir forši”.
Nākamie soļi: tavs 30 minūšu plāns
- 5 minūtes: izveidojiet projektu, izvēlieties veidni
- 10 minūtes: izveidojiet
/api/hello, savienojiet datubāzi, palaidiet migrāciju
- 10 minūtes: pievienojiet JWT autentifikāciju, aizsargājiet
POST /api/users
- 5 minūtes: izvietojiet inscenēšanai, palaidiet dūmu testu
Tas ir viss. Jūs tikko izveidojāt servera pusi ar Lovable Cloud. Tas darbojas. Tas mērogojas. Un jums joprojām ir laiks uzsildīt kafiju.
BUJ
Q1:Vai Lovable Cloud ir piemērots iesācējiem, veidojot servera pusi?
Jā — tā veidnes, serverless funkcijas un vides pārvaldnieks padara pirmo servera pusi daudz mazāk biedējošu. Sāciet ar vienkāršu REST API, pievienojiet datubāzi un pēc tam pievienojiet autentifikāciju. Jūs apgūsit reālus modeļus, necīnoties ar datu centru.
Q2:Kā es varu aizsargāt savu Lovable Cloud servera pusi ražošanai?
Izmantojiet JWT vai OAuth, bloķējiet CORS un saglabājiet noslēpumus vides pārvaldniekā. Pievienojiet ātruma ierobežojumus, validējiet ievadi katrā maršrutā un uzraugiet p95 latentumu, lai pamanītu problēmas, pirms to dara lietotāji.
Q3:Kura datubāze vislabāk darbojas ar Lovable Cloud REST API?
PostgreSQL ir uzticama izvēle lielākajai daļai lietotņu, īpaši ar tādu ORM kā Prisma vai Drizzle. Tas apstrādā relāciju datus, transakcijas un indeksēšanu bez drāmas un mērogojas līdz ar satiksmes pieaugumu.
Q4:Kā es varu apstrādāt aukstos startus un veiktspēju serverless servera pusēs?
Gudri apvienojiet atkarības, sasildiet kritiskos ceļus un izvairieties no simtiem mazu funkciju, ja viens pakalpojums darbosies. Pievienojiet kešatmiņu un lapošanu un vērojiet p95 latentumu, lai noregulētu to, kas patiesībā ir svarīgs.
Q5:Vai es varu izvietot inscenēšanu un ražošanu ar atsevišķiem noslēpumiem un URL?
Noteikti. Izveidojiet atsevišķas vides, iestatiet atšķirīgus DATABASE_URL, JWT_SECRET un domēnus un paaugstiniet būvējumus uz priekšu. Tas padara testēšanu drošu un atgriešanos bez sāpēm.
