Pular para o conteúdo principal
Implantações de aplicativos permite implantar aplicativos e sites da web diretamente no Windsurf, por meio de chamadas de ferramenta do Cascade. Esse recurso ajuda você a compartilhar seu trabalho por meio de URLs públicas, atualizar suas implantações e reivindicar projetos para personalizações adicionais. Este recurso está em beta e, em breve, haverá suporte para mais frameworks, compilações mais robustas etc.

​
Visão geral

Com Implantações de aplicativos, você pode:
  • Implantar um site ou app web em JS em um domínio público
  • Reimplantar no mesmo URL após fazer alterações
  • Reivindicar o projeto para a sua conta pessoal
As Implantações de aplicativos são destinadas principalmente a fins de pré-visualização. Para aplicações de produção com dados confidenciais, recomendamos reivindicar sua implantação e seguir as melhores práticas de segurança.

​
Provedores compatíveis

Atualmente oferecemos suporte ao seguinte provedor de implantação:
  • Netlify - Para sites estáticos e aplicativos web
O suporte a provedores adicionais está planejado para versões futuras.

​
Como funciona

Ao usar Implantações de aplicativos, seu código é enviado para nosso servidor e implantado no provedor por meio de nossa conta principal. O site implantado ficará disponível em uma URL pública no seguinte formato: 
<SUBDOMAIN_NAME>.windsurf.build

​
Processo de Deploy

  1. O Cascade analisa seu projeto para determinar o framework apropriado
  2. Os arquivos do seu projeto são enviados com segurança para nosso servidor
  3. O deploy é criado na plataforma do provedor
  4. Você recebe uma URL pública e um link para reivindicação

​
Configuração do projeto

Para facilitar novas implantações, criamos um arquivo windsurf_deployment.yaml na raiz do seu projeto. Esse arquivo contém informações para futuras implantações, como o ID do projeto e o framework.

​
Usando Implantações de aplicativos

Para implantar seu aplicativo, basta pedir ao Cascade algo como: 
"Fazer deploy deste projeto no Netlify"
"Atualizar meu deployment"
O Cascade vai guiá-lo pelo processo e ajudar a solucionar problemas comuns.

​
Implantações da equipe

Você precisará de privilégios de administrador da equipe para ativar esse recurso.
Usuários nos planos Teams e Enterprise podem conectar suas contas da Netlify às suas contas do Windsurf e fazer deploy na equipe da Netlify. Isso pode ser ativado nas Configurações da equipe, acessíveis pela página de Perfil ou clicando aqui.

​
Considerações de segurança

Seu código será enviado aos nossos servidores para implantação. Faça deploy apenas de código que você esteja confortável em compartilhar publicamente.
Tomamos várias precauções para garantir a segurança:
  • Limites de tamanho de arquivo e validação
  • Limitação de taxa com base no seu plano/nível de conta
  • Tratamento seguro dos arquivos do projeto
Para maior privacidade, visite clear-cookies.windsurf.build para verificar e limpar quaisquer cookies definidos por sites sob windsurf.build. Se aparecerem cookies, eles não deveriam estar lá; limpá-los ajuda a evitar problemas de cookies entre sites e mantém sua experiência limpa. Os sites da Windsurf são criados por humanos e por IA e, embora incentivemos a IA a seguir as melhores práticas, é importante manter a cautela. A Windsurf não se responsabiliza por problemas causados por sites publicados por nossos usuários.

​
Reivindicar sua implantação

Após a implantação, você receberá uma URL para reivindicação. Ao acessar esse link, você pode reivindicar o projeto na sua conta pessoal do provedor, o que lhe garante:
  • Controle total sobre a implantação
  • Acesso a recursos específicos do provedor
  • Possibilidade de modificar o nome de domínio
  • Acesso direto aos logs e às informações de build
Implantações não reivindicadas podem ser excluídas após um determinado período. Recomendamos reivindicar projetos importantes o quanto antes.

​
Limites de uso

Para evitar abusos, aplicamos estes limites de uso por plano:
PlanoImplantações por diaMáximo de sites não reivindicados
Free11
Pro105

​
Frameworks compatíveis

Implantações de aplicativos funcionam com os frameworks JavaScript mais populares, incluindo:
  • Next.js
  • React
  • Vue
  • Svelte
  • Sites estáticos em HTML/CSS/JS

​
Solução de problemas

​
Falha na build de deploy

Se o seu deploy falhar:
  1. Verifique os logs de build fornecidos pelo Cascade
  2. Certifique-se de que seu projeto consegue compilar localmente (execute npm run build para testar)
  3. Confirme que seu projeto segue a estrutura recomendada pelo framework
  4. Consulte a documentação sobre como fazer deploy do seu framework no Netlify via netlify.toml
  5. Considere reivindicar o projeto para acessar logs detalhados no painel do provedor
Não podemos fornecer suporte direto para erros de build específicos do framework. Se o seu deploy falhar devido a problemas de código, depure localmente ou reivindique o projeto para trabalhar com a equipe de suporte do provedor.

​
Site da Netlify não encontrado

Isso provavelmente significa que a sua build falhou. Solicite a propriedade do seu site (você pode encontrá-lo no seu histórico de deploy) e verifique os logs de build para mais detalhes. Muitas vezes você pode colar seus logs de build no Cascade e pedir ajuda.

​
Alterando seu subdomínio/URL

​
Atualizando o domínio netlify.app

Você pode alterar seu subdomínio ao reivindicar sua implementação e atualizar as configurações do site no Netlify. Isso atualizará seu domínio .netlify.app.

​
Atualizando o subdomínio personalizado .windsurf.build

Você não pode alterar seu subdomínio personalizado .windsurf.build depois de implantar. Em vez disso, será necessário implantar um novo site com um novo subdomínio.
Para atualizar seu subdomínio personalizado .windsurf.build, você precisará implantar um novo site com um novo subdomínio:
  1. Exclua o arquivo windsurf_config.yaml do seu projeto
  2. Peça ao Cascade para implantar um novo site com um novo subdomínio e informe qual você deseja
  3. Pode ajudar iniciar uma nova conversa ou limpar suas memórias geradas automaticamente para que o Cascade não tente reimplantar no subdomínio antigo
  4. Ao criar uma nova implantação, você poderá clicar no botão “Edit” na interface de subdomínio para atualizá-lo antes de clicar em “Deploy”

​
Erro: Unable to get project name for project ID

Esse erro ocorre quando o ID do seu projeto não é encontrado em nosso sistema de registros ou quando o Cascade utiliza o subdomínio como ID do projeto de forma incorreta. Para corrigir:
  1. Verifique se o projeto ainda existe na sua conta da Netlify (pressupondo que ele já esteja reivindicado).
  2. Verifique se o ID do projeto está no arquivo windsurf_deployment.yaml. Se não estiver, você pode baixar o arquivo de configuração no menu suspenso do seu histórico de deploy.
  3. Tente fazer um novo deploy e instrua o Cascade a usar o project_id do arquivo windsurf_deployment.yaml de forma explícita.