Como fazer o primeiro deploy na StayCloud #
Primeiro deploy StayCloud é o processo de publicar um projeto pela área Cloud do Painel Novo. Neste tutorial, você vai ver como preparar um projeto estático simples, enviar um arquivo .zip, acompanhar o processamento e abrir a aplicação publicada.
Este passo a passo usa o fluxo validado no painel com Upload de .zip. A tela também mostra opções de GitHub e CLI, mas elas não fazem parte deste tutorial. Para começar do jeito certo, confirme antes que o Deploy já está ativo na conta. Se ainda não estiver, veja primeiro como ativar o Deploy no Painel Novo da StayCloud.
Se o seu projeto estiver em repositório, mantenha esse caminho para um fluxo separado. A opção GitHub aparece na tela do produto, mas o primeiro deploy StayCloud demonstrado aqui usa apenas o envio de arquivo .zip.
O que você precisa antes de fazer o deploy #
Antes de publicar, tenha um projeto de teste sem dados sensíveis. Na validação deste tutorial, foi usado um HTML estático com uma mensagem de demonstração, sem formulário, banco de dados, token, variável de ambiente ou integração externa.
O arquivo enviado ao painel foi um .zip com o build pronto. A própria interface informa que o upload aceita arquivo .zip. No plano validado neste tutorial, o painel mostrou o limite disponível para upload; em outros planos, esse limite pode ser maior. O nome do projeto deve seguir o padrão indicado no campo: letras minúsculas, hífens e entre 3 e 32 caracteres.
Como funciona o primeiro deploy StayCloud #
No Painel Novo, o deploy é feito pela área Cloud. O fluxo validado começou em Novo projeto, usou a opção Upload de .zip, preencheu o campo NOME DO PROJETO e acionou o botão criar e implantar. Depois disso, o painel abriu a tela Implantando, exibiu os logs em tempo real e, ao finalizar, mostrou o projeto como pronto e No ar.
1. Abra a área Deploy #
Acesse o Painel Novo e abra a área Deploy. Na tela Cloud, clique em Novo projeto para iniciar a publicação de um projeto.
2. Prepare ou conecte o projeto #
Na opção Upload de .zip, clique em selecionar arquivo .zip e escolha o pacote do projeto. Depois do envio, o painel mostra o nome do arquivo e libera o campo NOME DO PROJETO.
3. Inicie o primeiro deploy StayCloud #
Preencha o nome do projeto usando o padrão indicado no painel. No exemplo validado, foi usado tutorial-deploy-teste. Em seguida, clique em criar e implantar.
4. Acompanhe o processamento #
Depois do clique, o painel abre a tela Implantando. Nela aparecem o projeto, a origem do arquivo, a região e os Logs de build. Durante a validação, o status exibido foi publicando, com mensagens como “deploy enfileirado”, “fonte validada” e “artefato estático pronto”.
5. Abra a aplicação publicada #
Quando o deploy termina, a visão geral do Cloud passa a mostrar o projeto como pronto. O painel também exibe o indicador No ar e a URL gerada para acessar a aplicação.
Abra a URL gerada e confirme se a página publicada corresponde ao projeto enviado. No teste validado, a URL pública respondeu com sucesso e exibiu a página estática de demonstração.
Como saber se o deploy foi concluído #
O deploy foi concluído quando o painel mostra o projeto como pronto, o resumo indica No ar e a URL pública abre a aplicação. Também é possível conferir se o contador de Deploys · 30D aumentou depois da publicação.
O que fazer quando o deploy apresenta erro #
Se o deploy não avançar, confira primeiro o formato do arquivo. O fluxo validado usa .zip, não uma pasta solta. Depois, revise se o nome do projeto respeita o padrão lowercase, kebab, 3-32 chars. Caso o painel exiba logs, leia as últimas mensagens para identificar em qual etapa o processo parou.
Não coloque token, chave ou variável de ambiente dentro do arquivo de teste. Configurações avançadas, domínio personalizado, variáveis, logs detalhados e redeploy devem ser tratados em fluxos separados. Para outros conteúdos do Painel Novo, acesse também a categoria Painel novo da Central de Ajuda.
Erros comuns no primeiro deploy #
Um erro comum é tentar publicar um projeto real de cliente para testar o recurso. Use sempre um projeto descartável. Outro erro é confundir este fluxo com publicação via cPanel: no Deploy StayCloud, o projeto é criado dentro da área Cloud e passa por processamento próprio.
Dúvidas frequentes #
Preciso usar GitHub para fazer o primeiro deploy? #
Não neste fluxo. A interface mostra GitHub como uma opção, mas o tutorial validado usa Upload de .zip.
Posso usar o comando de CLI? #
A tela mostra a opção Deploy via CLI, mas ela exige comando com token de conexão. Por segurança, esse caminho não foi usado neste tutorial.
O projeto de teste pode ter dados reais? #
Não. Use uma página simples, sem dados pessoais, segredos, integrações externas ou informações de cliente.
Conclusão #
Agora você sabe como fazer o primeiro deploy StayCloud pelo Painel Novo usando um arquivo .zip. O fluxo validado do primeiro deploy StayCloud consiste em abrir Novo projeto, selecionar o pacote, preencher NOME DO PROJETO, clicar em criar e implantar, acompanhar o status publicando e confirmar a aplicação como pronto e No ar.