Salt la conținutul principal
Implementări de aplicații vă permite să implementați aplicații web și site-uri direct din Windsurf, prin apeluri ale instrumentelor Cascade. Această funcționalitate vă ajută să vă publicați munca prin URL-uri publice, să vă actualizați implementările și să revendicați proiecte pentru personalizări ulterioare. Funcționalitatea este în beta, iar suportul pentru frameworkuri suplimentare, builduri mai robuste etc. va sosi în curând.

​
Prezentare generală

Cu Implementări de aplicații, poți:
  • Implementa un site sau o aplicație web JS pe un domeniu public
  • Reimplementa la aceeași adresă URL după ce faci modificări
  • Reivindica proiectul în contul tău personal
Implementările de aplicații sunt destinate în principal previzualizării. Pentru aplicații de producție cu date sensibile, recomandăm să revendici implementarea și să urmezi cele mai bune practici de securitate.

​
Furnizori compatibili

În prezent, acceptăm următorul furnizor de implementare:
  • Netlify - pentru site-uri statice și aplicații web
Suport pentru furnizori suplimentari este planificat pentru versiunile viitoare.

​
Cum funcționează

Când folosiți Implementări de aplicații, codul dvs. este încărcat pe serverul nostru și implementat la furnizor prin contul nostru umbrelă. Site-ul implementat va fi disponibil la un URL public cu următorul format: 
<SUBDOMAIN_NAME>.windsurf.build

​
Procesul de deployment

  1. Cascade analizează proiectul pentru a determina framework-ul potrivit
  2. Fișierele proiectului sunt încărcate în siguranță pe serverul nostru
  3. Deployment-ul este creat pe platforma furnizorului
  4. Primiți un URL public și un link pentru revendicare

​
Configurarea proiectului

Pentru a facilita redeployarea, creăm un fișier windsurf_deployment.yaml în rădăcina proiectului. Acest fișier conține informații pentru viitoarele redeployări, precum un ID de proiect și frameworkul.

​
Utilizarea Implementărilor de aplicații

Pentru a-ți implementa aplicația, pur și simplu cere-i lui Cascade ceva de genul: 
"Implementează acest proiect pe Netlify"
"Actualizează implementarea mea"
Cascade te va ghida prin proces și te va ajuta să rezolvi problemele comune.

​
Deploy-uri de echipă

Veți avea nevoie de privilegii de administrator de echipă pentru a activa sau dezactiva această funcționalitate.
Utilizatorii cu abonamente Teams și Enterprise își pot conecta conturile Netlify la conturile Windsurf și pot face deploy în echipa lor Netlify. Această opțiune poate fi activată/dezactivată în Team Settings, pe care o puteți accesa din pagina Profile sau făcând clic aici.

​
Considerații de securitate

Codul tău va fi încărcat pe serverele noastre pentru implementare. Implementează doar codul pe care ești dispus să îl partajezi public.
Luăm mai multe măsuri pentru a asigura securitatea:
  • Limite de dimensiune și validare a fișierelor
  • Limitare a ratei pe baza nivelului contului tău
  • Gestionare sigură a fișierelor proiectului
Pentru confidențialitate suplimentară, vizitează clear-cookies.windsurf.build pentru a verifica și șterge orice cookie-uri setate de site-urile din domeniul windsurf.build. Dacă apar cookie-uri, ele nu ar trebui să fie acolo, iar ștergerea lor ajută la prevenirea problemelor cu cookie-uri cross-site și îți păstrează experiența curată. Site-urile Windsurf sunt create de oameni și de AI și, deși încurajăm AI-ul să ia decizii conform celor mai bune practici, este înțelept să rămâi precaut. Windsurf nu este responsabil pentru problemele cauzate de site-urile implementate de utilizatorii noștri.

​
Preluarea implementării

După implementare, vei primi un URL pentru preluare. Urmând acest link, poți prelua proiectul în contul tău personal la furnizor, ceea ce îți oferă:
  • Control total asupra implementării
  • Acces la funcționalități specifice furnizorului
  • Posibilitatea de a modifica numele de domeniu
  • Acces direct la loguri și informații despre build
Implementările nepreluate pot fi șterse după o anumită perioadă. Îți recomandăm să preiei prompt proiectele importante.

​
Limitări de rată

Pentru a preveni abuzurile, aplicăm aceste limitări de rată în funcție de plan:
PlanImplementări pe ziNumăr maxim de site-uri nealocate
Free11
Pro105

​
Frameworkuri acceptate

Implementări de aplicații funcționează cu majoritatea frameworkurilor JavaScript populare, inclusiv:
  • Next.js
  • React
  • Vue
  • Svelte
  • Site-uri statice HTML/CSS/JS

​
Depanare

​
Build de deployment eșuat

Dacă deploymentul tău eșuează:
  1. Verifică logurile de build furnizate de Cascade
  2. Asigură-te că proiectul tău se poate construi local (rulează npm run build pentru test)
  3. Verifică dacă proiectul urmează structura recomandată de framework
  4. Consultă documentația despre cum să faci deploy frameworkului tău pe Netlify prin netlify.toml
  5. Ia în considerare revendicarea proiectului pentru a accesa loguri detaliate în dashboardul furnizorului
Nu putem oferi suport direct pentru erori de build specifice frameworkului. Dacă deploymentul tău eșuează din cauza problemelor de cod, depanează local sau revendică proiectul pentru a lucra cu echipa de suport a furnizorului.

​
Site Netlify indisponibil

Cel mai probabil buildul a eșuat. Revendică-ți site-ul (îl poți găsi în istoricul de deploy) și verifică logurile de build pentru detalii. De multe ori poți insera logurile de build în Cascade și solicita ajutor.

​
Modificarea subdomeniului/URL-ului

​
Actualizarea domeniului netlify.app

Îți poți schimba subdomeniul solicitând asocierea cu deploymentul tău și actualizând setările site‑ului în Netlify. Astfel, ți se va actualiza domeniul .netlify.app.

​
Actualizarea subdomeniului personalizat .windsurf.build

Nu puteți schimba subdomeniul personalizat .windsurf.build după ce ați efectuat un deployment. În schimb, va trebui să faceți deployment pentru un site nou cu un subdomeniu nou.
Pentru a actualiza subdomeniul personalizat .windsurf.build, va trebui să faceți deployment pentru un site nou cu un subdomeniu nou:
  1. Ștergeți fișierul windsurf_config.yaml din proiect
  2. Cereți Cascade să facă deployment pentru un site nou cu un subdomeniu nou și specificați subdomeniul dorit
  3. Poate fi util să începeți o conversație nouă sau să ștergeți amintirile auto-generate, astfel încât Cascade să nu încerce să redeployeze pe vechiul subdomeniu
  4. Când creați un nou deployment, veți putea apăsa butonul „Edit” în interfața subdomeniului pentru a-l actualiza înainte de a apăsa „Deploy”

​
Eroare: Unable to get project name for project ID

Această eroare apare când ID‑ul proiectului nu este găsit în sistemul nostru de evidențe sau dacă Cascade folosește greșit subdomeniul ca ID de proiect. Pentru a remedia:
  1. Verifică dacă proiectul există în continuare în contul tău Netlify (presupunând că a fost revendicat).
  2. Verifică dacă ID‑ul proiectului se află în fișierul windsurf_deployment.yaml. Dacă nu se află în fișier, poți descărca fișierul de configurare din meniul derulant deploy history.
  3. Încearcă să redeplasezi și indică explicit lui Cascade să folosească project_id din fișierul windsurf_deployment.yaml.