Déploiements d’apps vous permet de déployer des applications web et des sites directement dans Windsurf via des appels d’outils Cascade. Cette fonctionnalité vous permet de partager votre travail via des URL publiques, de mettre à jour vos déploiements et de revendiquer des projets pour une personnalisation ultérieure. Cette fonctionnalité est en bêta, et la prise en charge de frameworks supplémentaires, des builds plus robustes, etc., arrive bientôt.

​
Vue d’ensemble

Avec les Déploiements d’apps, vous pouvez :
  • Déployer un site web ou une application web JS sur un domaine public
  • Redéployer vers la même URL après avoir apporté des modifications
  • Rattacher le projet à votre compte personnel
Les Déploiements d’apps sont principalement destinés à la prévisualisation. Pour les applications de production contenant des données sensibles, nous recommandons de revendiquer votre déploiement et de suivre les bonnes pratiques de sécurité.

​
Fournisseurs pris en charge

Nous prenons actuellement en charge le fournisseur de déploiement suivant :
  • Netlify - Pour les sites statiques et les applications web
La prise en charge d’autres fournisseurs est prévue dans de prochaines versions.

​
Fonctionnement

Lorsque vous utilisez les Déploiements d’apps, votre code est téléversé sur notre serveur puis déployé chez le fournisseur via notre compte central. Le site déployé sera accessible à une URL publique au format : 
<SUBDOMAIN_NAME>.windsurf.build

​
Processus de déploiement

  1. Cascade analyse votre projet pour déterminer le framework approprié
  2. Les fichiers de votre projet sont envoyés en toute sécurité vers notre serveur
  3. Le déploiement est créé sur la plateforme du fournisseur
  4. Vous recevez une URL publique et un lien de revendication

​
Configuration du projet

Pour faciliter les redéploiements, nous créons un fichier windsurf_deployment.yaml à la racine de votre projet. Ce fichier contient des informations destinées aux déploiements ultérieurs, telles qu’un identifiant de projet et un framework.

​
Utiliser les Déploiements d’apps

Pour déployer votre application, il vous suffit de demander à Cascade quelque chose comme : 
"Déployer ce projet sur Netlify"
"Mettre à jour mon déploiement"
Cascade vous guidera tout au long du processus et vous aidera à résoudre les problèmes courants.

​
Déploiements d’équipe

Vous devez disposer des privilèges d’administrateur d’équipe pour activer cette fonctionnalité.
Les utilisateurs des plans Teams et Enterprise peuvent connecter leurs comptes Netlify à leurs comptes Windsurf et effectuer des déploiements vers leur équipe Netlify. Cette option peut être activée dans Paramètres de l’équipe, accessibles depuis la page Profil ou en cliquant ici.

​
Considérations de sécurité

Votre code sera téléversé sur nos serveurs pour le déploiement. Ne déployez que du code que vous acceptez de partager publiquement.
Nous prenons plusieurs précautions pour garantir la sécurité :
  • Limites de taille de fichier et validations
  • Limitation du débit en fonction de votre offre de compte
  • Gestion sécurisée des fichiers de projet
Pour plus de confidentialité, rendez-vous sur clear-cookies.windsurf.build pour vérifier et effacer les cookies définis par des sites sous windsurf.build. Si des cookies apparaissent, ils n’ont pas lieu d’être ; les supprimer aide à prévenir les problèmes de cookies intersites et à garder votre expérience saine. Les sites Windsurf sont créés par des humains et par l’IA, et bien que nous encouragions l’IA à appliquer les meilleures pratiques, il est prudent de rester vigilant. Windsurf n’est pas responsable des problèmes causés par des sites déployés par nos utilisateurs.

​
Réclamer votre déploiement

Après le déploiement, vous recevrez une URL de réclamation. En suivant ce lien, vous pouvez associer le projet à votre compte personnel chez le fournisseur, ce qui vous donne :
  • Un contrôle total sur le déploiement
  • L’accès aux fonctionnalités propres au fournisseur
  • La possibilité de modifier le nom de domaine
  • Un accès direct aux logs et aux informations de build
Les déploiements non réclamés peuvent être supprimés après un certain délai. Nous vous recommandons de réclamer rapidement les projets importants.

​
Limites de taux

Pour prévenir les abus, nous appliquons les limites suivantes selon le palier d’abonnement :
PlanDéploiements par jourNombre maximal de sites non revendiqués
Free11
Pro105

​
Frameworks pris en charge

Les Déploiements d’apps fonctionnent avec la plupart des frameworks JavaScript populaires, notamment :
  • Next.js
  • React
  • Vue
  • Svelte
  • Sites statiques HTML/CSS/JS

​
Résolution des problèmes

​
Échec de la build de déploiement

Si votre déploiement échoue :
  1. Consultez les logs de build fournis par Cascade
  2. Assurez-vous que votre projet se build correctement en local (exécutez npm run build pour tester)
  3. Vérifiez que votre projet respecte la structure recommandée par le framework
  4. Consultez la documentation pour savoir comment déployer votre framework sur Netlify via netlify.toml
  5. Envisagez de réclamer le projet pour accéder à des logs détaillés sur le tableau de bord du fournisseur
Nous ne pouvons pas fournir d’assistance directe pour les erreurs de build propres à un framework. Si votre déploiement échoue en raison de problèmes de code, déboguez en local ou réclamez le projet afin de travailler avec l’équipe d’assistance du fournisseur.

​
Site Netlify introuvable

Cela signifie probablement que votre build a échoué. Veuillez revendiquer votre site (vous pouvez le retrouver dans votre historique de déploiements) et consulter les logs de build pour plus de détails. Bien souvent, vous pouvez coller vos logs de build dans Cascade et demander de l’aide.

​
Modifier votre sous-domaine/URL

​
Mise à jour du domaine netlify.app

Vous pouvez modifier votre sous-domaine en revendiquant votre déploiement et en mettant à jour les paramètres de votre site Netlify. Cela mettra à jour votre domaine .netlify.app.

​
Mise à jour d’un sous-domaine personnalisé .windsurf.build

Vous ne pouvez pas modifier votre sous-domaine personnalisé .windsurf.build après le déploiement. Vous devrez plutôt déployer un nouveau site avec un nouveau sous-domaine.
Pour mettre à jour votre sous-domaine personnalisé .windsurf.build, vous devrez déployer un nouveau site avec un nouveau sous-domaine :
  1. Supprimez le fichier windsurf_config.yaml de votre projet
  2. Demandez à Cascade de déployer un nouveau site avec un nouveau sous-domaine et indiquez celui que vous souhaitez
  3. Il peut être utile de démarrer une nouvelle conversation ou d’effacer vos mémoires générées automatiquement afin que Cascade n’essaie pas de redéployer sur l’ancien sous-domaine
  4. Lorsque vous créez un nouveau déploiement, vous pourrez cliquer sur le bouton « Edit » dans l’interface du sous-domaine pour le modifier avant de cliquer sur « Deploy »

​
Erreur : Unable to get project name for project ID

Cette erreur survient lorsque votre ID de projet est introuvable dans notre système d’enregistrement ou si Cascade utilise à tort le sous-domaine comme ID de projet. Pour corriger cela :
  1. Vérifiez que le projet existe toujours dans votre compte Netlify (en supposant qu’il est revendiqué).
  2. Vérifiez que l’ID de projet figure dans le fichier windsurf_deployment.yaml. S’il n’y figure pas, vous pouvez télécharger votre fichier de configuration depuis le menu déroulant de votre historique de déploiement.
  3. Essayez de redéployer et indiquez clairement à Cascade d’utiliser le project_id du fichier windsurf_deployment.yaml.