Saltar al contenido principal
Implementaciones de aplicaciones te permite desplegar aplicaciones web y sitios directamente en Windsurf mediante llamadas a herramientas de Cascade. Esta función te ayuda a compartir tu trabajo a través de URL públicas, actualizar tus despliegues y reclamar proyectos para personalizarlos más. Esta función está en beta y pronto incorporará compatibilidad con más frameworks, compilaciones más robustas, etc.

Descripción general

Con Implementaciones de aplicaciones, puedes:
  • Implementar un sitio web o una aplicación web en JavaScript en un dominio público
  • Volver a implementar en la misma URL después de realizar cambios
  • Reclamar el proyecto en tu cuenta personal
Implementaciones de aplicaciones está pensado principalmente para vistas previas. Para aplicaciones de producción con datos sensibles, recomendamos reclamar tu implementación y seguir las prácticas recomendadas de seguridad.

Proveedores compatibles

Actualmente admitimos el siguiente proveedor de implementación:
  • Netlify - Para sitios web estáticos y aplicaciones web
Está previsto añadir compatibilidad con proveedores adicionales en versiones futuras.

Cómo funciona

Cuando usas Implementaciones de aplicaciones, tu código se sube a nuestro servidor y se despliega en el proveedor bajo nuestra cuenta general. El sitio desplegado estará disponible en una URL pública con el siguiente formato:

Proceso de despliegue

  1. Cascade analiza tu proyecto para determinar el framework adecuado
  2. Los archivos de tu proyecto se cargan de forma segura en nuestro servidor
  3. El despliegue se crea en la plataforma del proveedor
  4. Recibes una URL pública y un enlace para reclamarlo

Configuración del proyecto

Para facilitar los redepliegues, creamos un archivo windsurf_deployment.yaml en la raíz de tu proyecto. Este archivo contiene información para despliegues futuros, como el ID del proyecto y el framework.

Uso de Implementaciones de aplicaciones

Para implementar tu aplicación, simplemente pídele a Cascade algo como:
Cascade te guiará durante el proceso y te ayudará a resolver problemas comunes.

Despliegues del equipo

Necesitarás permisos de administrador del equipo para activar o desactivar esta función.
Los usuarios con planes Teams y Enterprise pueden conectar sus cuentas de Netlify con sus cuentas de Windsurf y desplegar en su equipo de Netlify. Esta opción se puede activar o desactivar en la configuración del equipo, a la cual puedes acceder desde la página de Perfil o haciendo clic aquí.

Consideraciones de seguridad

Tu código se subirá a nuestros servidores para su despliegue. Solo despliega código que te sientas cómodo compartiendo públicamente.
Tomamos varias precauciones para garantizar la seguridad:
  • Límites de tamaño de archivo y validación
  • Limitación de solicitudes según tu plan de cuenta
  • Manejo seguro de archivos del proyecto
Para mayor privacidad, visita clear-cookies.windsurf.build para comprobar y borrar cualquier cookie establecida por sitios bajo windsurf.build. Si aparece alguna cookie, no debería estar allí; al borrarla, ayudas a prevenir problemas de cookies entre sitios y mantienes tu experiencia limpia. Los sitios de Windsurf son creados por personas y por IA; aunque incentivamos que la IA tome decisiones basadas en buenas prácticas, es sensato mantener la cautela. Windsurf no se hace responsable de los problemas causados por sitios desplegados por nuestros usuarios.

Reclamación de tu despliegue

Después de desplegar, recibirás una URL de reclamación. Al seguir este enlace, podrás reclamar el proyecto en tu cuenta personal del proveedor, lo que te brindará:
  • Control total sobre el despliegue
  • Acceso a funciones específicas del proveedor
  • Posibilidad de modificar el nombre de dominio
  • Acceso directo a logs e información de compilación
Los despliegues no reclamados pueden eliminarse después de cierto tiempo. Recomendamos reclamar los proyectos importantes sin demora.

Límites de uso

Para prevenir abusos, aplicamos estos límites por nivel:

Frameworks compatibles

Implementaciones de aplicaciones funciona con los frameworks de JavaScript más populares, entre ellos:
  • Next.js
  • React
  • Vue
  • Svelte
  • Sitios estáticos HTML/CSS/JS

Resolución de problemas

Error en la compilación del despliegue

Si tu despliegue falla:
  1. Revisa los logs de compilación proporcionados por Cascade
  2. Asegúrate de que tu proyecto pueda compilarse localmente (ejecuta npm run build para probar)
  3. Verifica que tu proyecto siga la estructura recomendada del framework
  4. Consulta la documentación sobre cómo desplegar tu framework en Netlify mediante netlify.toml
  5. Considera reclamar el proyecto para acceder a logs detallados en el panel del proveedor
No podemos brindar soporte directo para errores de compilación específicos del framework. Si tu despliegue falla debido a problemas de código, depura localmente o reclama el proyecto para trabajar con el equipo de soporte del proveedor.

Sitio de Netlify no encontrado

Es probable que la compilación haya fallado. Reclama tu sitio (puedes encontrarlo en tu historial de despliegues) y revisa los logs de compilación para más detalles. A menudo puedes pegar tus logs de compilación en Cascade y pedir ayuda.

Cambiar tu subdominio o URL

Actualización del dominio netlify.app

Puedes cambiar tu subdominio al reclamar tu despliegue y actualizar la configuración del sitio en Netlify. Esto actualizará tu dominio .netlify.app.

Actualización del subdominio personalizado .windsurf.build

No puedes cambiar tu subdominio personalizado .windsurf.build después de haber hecho el despliegue. En su lugar, tendrás que desplegar un sitio nuevo con un subdominio nuevo.
Para actualizar tu subdominio personalizado .windsurf.build, tendrás que desplegar un sitio nuevo con un subdominio nuevo:
  1. Elimina el archivo windsurf_config.yaml de tu proyecto
  2. Pídele a Cascade que despliegue un sitio nuevo con un subdominio nuevo y especifica cuál quieres
  3. Puede ayudar iniciar una conversación nueva o borrar tus memorias autogeneradas para que Cascade no intente volver a desplegar en el subdominio anterior
  4. Cuando crees un nuevo despliegue, podrás hacer clic en el botón “Edit” en la interfaz del subdominio para actualizarlo antes de hacer clic en “Deploy”

Error: Unable to get project name for project ID

Este error ocurre cuando tu ID de proyecto no se encuentra en nuestro sistema de registros o si Cascade está usando incorrectamente el subdominio como ID de proyecto. Para solucionarlo:
  1. Comprueba que el proyecto aún exista en tu cuenta de Netlify (suponiendo que esté reclamado).
  2. Comprueba que el ID de proyecto esté en el archivo windsurf_deployment.yaml. Si no está en el archivo, puedes descargar el archivo de configuración desde el menú desplegable de tu historial de implementaciones.
  3. Intenta volver a implementar e indicarle a Cascade que use el project_id del archivo windsurf_deployment.yaml de forma explícita.