Zum Hauptinhalt springen
Mit App Deploys können Sie Webanwendungen und Websites direkt in Windsurf über Cascade-Toolaufrufe bereitstellen. So teilen Sie Ihre Arbeit über öffentliche URLs, aktualisieren Ihre Deployments und übernehmen Projekte für weitere Anpassungen. Diese Funktion befindet sich in der Beta-Phase; Unterstützung für weitere Frameworks, robustere Builds usw. folgt in Kürze.

Überblick

Mit App Deploys kannst du:
  • Eine Website oder JS‑Web‑App auf einer öffentlichen Domain bereitstellen
  • Nach Änderungen erneut unter derselben URL bereitstellen
  • Das Projekt deinem persönlichen Konto zuordnen
App Deploys sind in erster Linie für Vorschauzwecke gedacht. Für Produktionsanwendungen mit sensiblen Daten empfehlen wir, deine Bereitstellung zu claimen und Sicherheits‑Best Practices zu befolgen.

Unterstützte Anbieter

Derzeit unterstützen wir den folgenden Bereitstellungsanbieter:
  • Netlify – für statische Websites und Webanwendungen
Unterstützung für zusätzliche Anbieter ist für zukünftige Versionen geplant.

Funktionsweise

Wenn Sie App Deploys verwenden, wird Ihr Code auf unseren Server hochgeladen und über unser übergeordnetes Konto beim Anbieter bereitgestellt. Die bereitgestellte Website ist unter einer öffentlichen URL verfügbar, die wie folgt formatiert ist:

Bereitstellungsprozess

  1. Cascade analysiert Ihr Projekt, um das geeignete Framework zu ermitteln
  2. Ihre Projektdateien werden sicher auf unseren Server hochgeladen
  3. Das Deployment wird auf der Plattform des Anbieters erstellt
  4. Sie erhalten eine öffentliche URL und einen Claim-Link

Projektkonfiguration

Um spätere Deployments zu erleichtern, erstellen wir im Stammverzeichnis Ihres Projekts die Datei windsurf_deployment.yaml. Diese Datei enthält Informationen für zukünftige Deployments, etwa eine Projekt-ID und das verwendete Framework.

Verwendung von App Deploys

Um Ihre Anwendung zu deployen, bitten Sie Cascade einfach mit einer Anfrage wie:
Cascade führt Sie durch den Ablauf und hilft bei der Behebung gängiger Probleme.

Team-Deployments

Sie benötigen Team-Administratorrechte, um diese Funktion zu aktivieren oder zu deaktivieren.
Benutzer:innen mit Teams- und Enterprise-Plänen können ihre Netlify-Konten mit ihren Windsurf-Konten verbinden und in ihr Netlify-Team deployen. Dies kann in den Team-Einstellungen umgeschaltet werden, auf die Sie über die Profilseite oder über diesen Link zugreifen können.

Sicherheitshinweise

Ihr Code wird für das Deployment auf unsere Server hochgeladen. Deployen Sie nur Code, den Sie bedenkenlos öffentlich teilen würden.
Wir ergreifen mehrere Maßnahmen, um die Sicherheit zu gewährleisten:
  • Limits für Dateigröße und Validierung
  • Rate Limiting basierend auf Ihrem Kontotarif
  • Sichere Verarbeitung von Projektdateien
Für zusätzlichen Datenschutz besuchen Sie clear-cookies.windsurf.build, um nach Cookies zu prüfen, die von Sites unter windsurf.build gesetzt wurden, und diese zu löschen. Wenn dort Cookies erscheinen, sollten sie nicht vorhanden sein; das Löschen hilft, bereichsübergreifende Cookie-Probleme zu vermeiden und sorgt für ein sauberes Nutzungserlebnis. Windsurf‑Sites werden von Menschen und KI erstellt. Obwohl wir die KI zu Entscheidungen nach Best Practices anhalten, ist es sinnvoll, vorsichtig zu bleiben. Windsurf ist nicht verantwortlich für Probleme, die durch von unseren Nutzern bereitgestellte Sites verursacht werden.

Beanspruchen Ihrer Bereitstellung

Nach der Bereitstellung erhalten Sie eine Claim-URL. Über diesen Link können Sie das Projekt in Ihrem persönlichen Provider-Konto beanspruchen und erhalten dadurch:
  • Vollständige Kontrolle über die Bereitstellung
  • Zugriff auf anbieterspezifische Funktionen
  • Die Möglichkeit, den Domainnamen zu ändern
  • Direkten Zugriff auf Logs und Build-Informationen
Nicht beanspruchte Bereitstellungen können nach einer gewissen Zeit gelöscht werden. Wir empfehlen, wichtige Projekte zeitnah zu beanspruchen.

Nutzungslimits

Um Missbrauch zu verhindern, wenden wir folgende stufenbasierte Limits an:

Unterstützte Frameworks

App Deploys funktioniert mit den gängigsten JavaScript-Frameworks, darunter:
  • Next.js
  • React
  • Vue
  • Svelte
  • Statische HTML/CSS/JS‑Sites

Problembehandlung

Fehlgeschlagener Deployment-Build

Wenn Ihr Deployment fehlschlägt:
  1. Prüfen Sie die von Cascade bereitgestellten Build-Logs
  2. Stellen Sie sicher, dass sich Ihr Projekt lokal bauen lässt (führen Sie zum Test npm run build aus)
  3. Vergewissern Sie sich, dass Ihr Projekt der empfohlenen Struktur des Frameworks folgt
  4. Lesen Sie die Dokumentation dazu, wie Sie Ihr Framework über netlify.toml auf Netlify deployen
  5. Erwägen Sie, das Projekt zu claimen, um auf detaillierte Logs im Dashboard des Providers zuzugreifen
Wir können keinen direkten Support für frameworkspezifische Build-Fehler leisten. Wenn Ihr Deployment aufgrund von Code-Problemen fehlschlägt, debuggen Sie lokal oder claimen Sie das Projekt, um mit dem Support-Team des Providers zusammenzuarbeiten.

Netlify‑Site nicht gefunden

Das bedeutet wahrscheinlich, dass Ihr Build fehlgeschlagen ist. Beanspruchen Sie Ihre Site (Sie finden sie in Ihrem Deploy-Verlauf) und prüfen Sie die Build-Logs für weitere Details. Häufig können Sie Ihre Build-Logs in Cascade einfügen und um Hilfe bitten.

Ändern der Subdomain/URL

netlify.app-Domain aktualisieren

Sie können Ihre Subdomain ändern, indem Sie Ihre Deployment-Instanz beanspruchen und die Einstellungen Ihrer Netlify‑Site aktualisieren. Dadurch wird Ihre .netlify.app-Domain aktualisiert.

Aktualisieren der benutzerdefinierten Subdomain .windsurf.build

Sie können Ihre benutzerdefinierte .windsurf.build-Subdomain nach der Bereitstellung nicht ändern. Stattdessen müssen Sie eine neue Site mit einer neuen Subdomain bereitstellen.
Um Ihre benutzerdefinierte .windsurf.build-Subdomain zu aktualisieren, müssen Sie eine neue Site mit einer neuen Subdomain bereitstellen:
  1. Löschen Sie die Datei windsurf_config.yaml aus Ihrem Projekt
  2. Bitten Sie Cascade, eine neue Site mit einer neuen Subdomain bereitzustellen, und geben Sie die gewünschte Subdomain an
  3. Es kann helfen, eine neue Unterhaltung zu starten oder Ihre automatisch generierten Memories zu löschen, damit Cascade nicht versucht, erneut auf die alte Subdomain bereitzustellen
  4. Wenn Sie eine neue Bereitstellung erstellen, können Sie in der Subdomain-UI vor dem Klicken auf „Deploy“ die Schaltfläche „Edit“ verwenden, um sie anzupassen

Fehler: Unable to get project name for project ID

Dieser Fehler tritt auf, wenn Ihre Projekt-ID nicht in unserem System of Record gefunden wird oder wenn Cascade irrtümlich die Subdomain als Projekt-ID verwendet. So beheben Sie das:
  1. Prüfen Sie, ob das Projekt in Ihrem Netlify-Konto noch existiert (sofern es beansprucht ist).
  2. Prüfen Sie, ob die Projekt-ID in der Datei windsurf_deployment.yaml enthalten ist. Falls nicht, können Sie Ihre Konfigurationsdatei über das Dropdown Ihrer Deploy-Historie herunterladen.
  3. Versuchen Sie, erneut zu deployen, und weisen Sie Cascade explizit an, die project_id aus der Datei windsurf_deployment.yaml zu verwenden.