Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Mit App Deploys können Sie Webanwendungen und Websites direkt in Devin Desktop mithilfe von Tool-Aufrufen in Cascade bereitstellen. Mit dieser Funktion können Sie Ihre Arbeit über öffentliche URLs teilen, Ihre Deployments aktualisieren und Projekte für weitere Anpassungen beanspruchen. Diese Funktion befindet sich derzeit in der Beta-Phase; Unterstützung für zusätzliche Frameworks, robustere Builds und mehr folgt in Kürze.

Überblick

Mit App Deploys können Sie:
  • Eine Website oder JS-Web-App auf einer öffentlichen Domain bereitstellen
  • Nach Änderungen erneut unter derselben URL bereitstellen
  • Das Projekt Ihrem persönlichen Konto beanspruchen
App Deploys sind in erster Linie für Vorschauzwecke gedacht. Für Produktionsanwendungen mit sensiblen Daten empfehlen wir, Ihr Deployment Ihrem Konto zu beanspruchen und die bewährten Sicherheitspraktiken zu befolgen.

Unterstützte Anbieter

Derzeit unterstützen wir den folgenden Deployment-Anbieter:
  • Netlify - Für statische Websites und Webanwendungen
Die Unterstützung weiterer Anbieter ist für zukünftige Versionen geplant.

So funktioniert es

Wenn Sie App Deploys verwenden, wird Ihr Code auf unseren Server hochgeladen und über unser zentrales Konto beim Anbieter bereitgestellt. Die bereitgestellte Website ist dann unter einer öffentlichen URL im folgenden Format verfügbar:
<SUBDOMAIN_NAME>.windsurf.build

Deployment-Prozess

  1. Cascade analysiert Ihr Projekt, um das passende 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 Link zum Beanspruchen

Projektkonfiguration

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

App-Deploys nutzen

Um Ihre Anwendung bereitzustellen, fragen Sie Cascade einfach etwa Folgendes:
"Deploy this project to Netlify"
"Update my deployment"
Cascade führt Sie durch den Prozess und hilft Ihnen, häufige Probleme zu beheben.

Team-Deployments

Sie benötigen Team-Admin-Berechtigungen, um diese Funktion zu aktivieren oder zu deaktivieren.
Nutzer mit Teams- und Enterprise-Tarifen können ihre Netlify-Konten mit ihren Devin Desktop-Konten verbinden und Deployments für ihr Netlify-Team ausführen. Diese Option lässt sich in Team Settings aktivieren bzw. deaktivieren. Sie erreichen die Seite über die Profilseite oder hier.

Sicherheitsaspekte

Dein Code wird zur Bereitstellung auf unsere Server hochgeladen. Stelle nur Code bereit, den du bedenkenlos öffentlich teilen würdest.
Wir treffen mehrere Vorkehrungen, um die Sicherheit zu gewährleisten:
  • Beschränkungen der Dateigröße und Validierung
  • Anfragelimits basierend auf deiner Account-Ebene
  • Sichere Handhabung von Projektdateien
Für zusätzlichen Datenschutz besuche clear-cookies.windsurf.build, um nach Cookies zu suchen und alle von Websites unter windsurf.build gesetzten Cookies zu löschen. Falls Cookies angezeigt werden, sollten sie nicht vorhanden sein. Das Löschen hilft, Cross-Site-Cookie-Probleme zu vermeiden und sorgt für eine saubere Nutzungserfahrung. Devin-Desktop-Websites werden von Menschen und KI erstellt. Obwohl wir die KI dazu anhalten, Entscheidungen nach Best Practices zu treffen, ist es sinnvoll, vorsichtig zu bleiben. Devin Desktop ist nicht für Probleme verantwortlich, die durch von unseren Nutzern veröffentlichte Websites verursacht werden.

Ihr Deployment beanspruchen

Nach dem Deployment erhalten Sie eine URL zum Beanspruchen. Über diesen Link können Sie das Projekt Ihrem persönlichen Konto beim Anbieter zuordnen. Dadurch erhalten Sie:
  • Volle Kontrolle über das Deployment
  • Zugriff auf anbieterspezifische Funktionen
  • Die Möglichkeit, den Domainnamen zu ändern
  • Direktzugriff auf Logs und Build-Informationen
Nicht beanspruchte Deployments können nach einer gewissen Zeit gelöscht werden. Wir empfehlen, wichtige Projekte zeitnah zu beanspruchen.

Ratenlimits

Um Missbrauch zu verhindern, wenden wir diese Ratenlimits je Ebene an:
PlanDeployments pro TagMax. nicht beanspruchte Sites
Free11
Pro105

Unterstützte Frameworks

App Deploys unterstützt die gängigsten JavaScript-Frameworks, darunter:
  • Next.js
  • React
  • Vue
  • Svelte
  • Statische HTML/CSS/JS-Websites

Fehlerbehebung

Fehlgeschlagener Build beim Deployment

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 vom Framework empfohlenen Struktur folgt
  4. Lesen Sie in der Dokumentation nach, wie Sie Ihr Framework mit netlify.toml auf Netlify bereitstellen
  5. Erwägen Sie, das Projekt zu beanspruchen, um auf detaillierte Logs im Dashboard des Anbieters zuzugreifen
Wir können keinen direkten Support für Framework-spezifische Build-Fehler anbieten. Wenn Ihr Deployment aufgrund von Codeproblemen fehlschlägt, suchen Sie den Fehler lokal oder beanspruchen Sie das Projekt, um mit dem Support-Team des Anbieters zusammenzuarbeiten.

Netlify-Site nicht gefunden

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

Ihre Subdomain / URL ändern

netlify.app-Domain aktualisieren

Sie können Ihre Subdomain ändern, indem Sie Ihr Deployment beanspruchen und die Netlify-Settings der Website aktualisieren. Dadurch wird Ihre .netlify.app-Domain aktualisiert.

Aktualisieren der benutzerdefinierten .windsurf.build-Subdomain

Sie können Ihre benutzerdefinierte .windsurf.build-Subdomain nicht mehr ändern, nachdem Sie sie bereitgestellt haben. Stattdessen müssen Sie eine neue Website mit einer neuen Subdomain bereitstellen.
Um Ihre benutzerdefinierte .windsurf.build-Subdomain zu aktualisieren, müssen Sie eine neue Website mit einer neuen Subdomain bereitstellen:
  1. Löschen Sie die Datei windsurf_config.yaml aus Ihrem Projekt
  2. Bitten Sie Cascade, eine neue Website mit einer neuen Subdomain bereitzustellen, und teilen Sie ihr mit, welche Sie verwenden möchten
  3. Es kann hilfreich sein, eine neue Unterhaltung zu beginnen oder Ihre automatisch generierten Memorys zu löschen, damit Cascade nicht versucht, erneut auf der alten Subdomain bereitzustellen
  4. Wenn Sie ein neues Deployment erstellen, können Sie in der Subdomain-Benutzeroberfläche auf die Schaltfläche „Edit“ klicken, um sie vor dem Klicken auf „Deploy“ zu aktualisieren

Fehler: Unable to get project name for project ID

Dieser Fehler tritt auf, wenn Ihre Projekt-ID in unserem System nicht gefunden wird oder wenn Cascade fälschlicherweise die Subdomain als Projekt-ID verwendet. So beheben Sie das Problem:
  1. Prüfen Sie, ob das Projekt noch in Ihrem Netlify-Konto vorhanden ist (vorausgesetzt, es wurde beansprucht).
  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-Menü in Ihrem Bereitstellungsverlauf herunterladen.
  3. Versuchen Sie, erneut bereitzustellen, und weisen Sie Cascade dabei explizit an, die project_id aus der Datei windsurf_deployment.yaml zu verwenden.