Pular para o conteúdo principal

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.

O App Deploys permite implantar aplicações web e sites diretamente no Devin Desktop por meio de chamadas da ferramenta Cascade. Esse recurso ajuda você a compartilhar seu trabalho com URLs públicas, atualizar suas implantações e reivindicar projetos para personalização adicional. Esse recurso está em beta, e o suporte a frameworks adicionais, builds mais robustos etc. chegará em breve.

​
Visão geral

Com o App Deploys, você pode:
  • Implantar um site ou app web em JS em um domínio público
  • Reimplantar na mesma URL após fazer alterações
  • Reivindicar o projeto para sua conta pessoal
O App Deploys se destina principalmente a fins de pré-visualização. Para aplicações em produção com dados sensíveis, recomendamos reivindicar sua implantação e seguir as práticas recomendadas de segurança.

​
Provedores compatíveis

Atualmente, oferecemos suporte ao seguinte provedor de implantação:
  • Netlify - Para sites estáticos e aplicações web
Há planos de adicionar suporte a outros provedores em versões futuras.

​
Como funciona

Quando você usa o App Deploys, seu código é importado para o nosso servidor e implantado no provedor por meio da nossa conta principal. O site implantado ficará disponível em uma URL pública no seguinte formato: 
<SUBDOMAIN_NAME>.windsurf.build

​
Processo de implantação

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

​
Configuração do projeto

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

​
Como usar App Deploys

Para fazer o deploy da sua aplicação, basta pedir ao Cascade algo como: 
"Deploy this project to Netlify"
"Update my deployment"
O Cascade vai orientar você ao longo do processo e ajudar a resolver problemas comuns.

​
Deploys da equipe

Você precisará de privilégios de administrador da equipe para habilitar ou desabilitar esse recurso.
Usuários dos planos Teams e Enterprise podem conectar suas contas da Netlify às contas do Devin Desktop e fazer deploy na sua equipe da Netlify. Esse recurso pode ser habilitado ou desabilitado em Configurações da equipe, que você pode acessar pela página de perfil ou clicando aqui.

​
Considerações de segurança

Seu código será importado para os nossos servidores para implantação. Implante apenas código que você se sinta à vontade para 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 nível da sua conta
  • Tratamento seguro dos arquivos do projeto
Para mais privacidade, acesse clear-cookies.windsurf.build para verificar se há cookies definidos por sites em windsurf.build e removê-los. Se algum cookie aparecer, ele não deveria estar lá, e removê-lo ajuda a evitar problemas de cookies entre sites e mantém sua experiência limpa. Os sites do Devin Desktop são criados por humanos e IA e, embora incentivemos a IA a tomar decisões alinhadas às melhores práticas, é importante manter a cautela. O Devin Desktop não se responsabiliza por problemas causados por sites implantados por nossos usuários.

​
Reivindicando sua implantação

Após o deploy, você receberá uma URL para reivindicação. Ao acessar esse link, você poderá reivindicar o projeto na sua conta pessoal do provedor, o que dá a você:
  • Controle total sobre a implantação
  • Acesso a recursos específicos do provedor
  • Possibilidade de modificar o nome de domínio
  • Acesso direto a logs e 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

Para evitar abusos, aplicamos estes limites por nível:
PlanoImplantações por diaMáx. de sites não reivindicados
Free11
Pro105

​
Frameworks compatíveis

O App Deploys é compatível com a maioria dos frameworks JavaScript mais populares, incluindo:
  • Next.js
  • React
  • Vue
  • Svelte
  • Sites estáticos em HTML/CSS/JS

​
Solução de problemas

​
Falha no build de implantação

Se a implantação falhar:
  1. Verifique os logs de build fornecidos pelo Cascade
  2. Certifique-se de que seu projeto consegue gerar a build localmente (execute npm run build para testar)
  3. Verifique se seu projeto segue a estrutura recomendada pelo framework
  4. Consulte a documentação sobre como implantar 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 a implantação falhar devido a problemas no código, faça a depuração localmente ou reivindique o projeto para trabalhar com a equipe de suporte do provedor.

​
Site da Netlify não encontrado

Isso provavelmente significa que seu build falhou. Reivindique 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 os logs de build no Cascade e pedir ajuda.

​
Alterar seu subdomínio / URL

​
Atualizando o domínio netlify.app

Você pode alterar seu subdomínio reivindicando sua implantação e atualizando as Configurações do site na 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 fazer o deploy. Em vez disso, será necessário fazer o deploy de um novo site com um novo subdomínio.
Para atualizar seu subdomínio personalizado .windsurf.build, será necessário fazer o deploy de um novo site com um novo subdomínio:
  1. Exclua o arquivo windsurf_config.yaml do seu projeto
  2. Peça ao Cascade para fazer o deploy de um novo site com um novo subdomínio e informe qual você quer
  3. Pode ser útil iniciar uma nova conversa ou limpar suas memórias geradas automaticamente para que o Cascade não tente fazer o deploy novamente no subdomínio antigo
  4. Ao criar uma nova implantação, você poderá clicar no botão “Edit” na UI do 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 projeto não é encontrado em nosso sistema ou quando o Cascade está usando incorretamente o subdomínio como ID do projeto. Para corrigir isso:
  1. Verifique se o projeto ainda existe na sua conta da Netlify (pressupondo que ele tenha sido 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 histórico de implantações.
  3. Tente implantar novamente e instrua o Cascade a usar mais explicitamente o project_id do arquivo windsurf_deployment.yaml