Pular para o conteúdo principal
Em Configurações › Deploy › Histórico de envios, cada envio do projeto aparece com o resultado da instalação. Todo .zip que você envia, pelo painel, pela CLI ou pela API, e cada Aplicar mudanças depois de editar no explorador de arquivos ficam guardados como uma versão: dá para baixar de novo ou voltar o projeto para ela.

Guardado sozinho

Cada .zip enviado e cada Aplicar mudanças viram uma versão, sem você fazer nada. O histórico diz quem enviou: você pelo painel ou o nome da chave de API.

Voltar para esta versão

Os arquivos voltam aos daquela versão. O projeto para antes e só liga depois se você pedir.

Quantas ficam guardadas

Cada versão fica guardada por até 30 dias do envio. O plano define quantas ficam por projeto, e ficam as usadas por último: voltar para uma versão conta como usar. Quando entra uma nova e o histórico está cheio, sai a que está há mais tempo fora do projeto (a linha continua no histórico, sem as ações). Exemplo no Free: você envia a v1, depois a v2 (que quebra) e volta para a v1. Ao enviar a v3, ficam a v3 e a v1, que era a que rodava antes; a v2 sai. Viram versão:
  • o .zip enviado, e o do commit implantado pelo deploy pelo GitHub;
  • o Aplicar mudanças, depois de editar no explorador de arquivos: a versão guarda os arquivos do projeto naquele momento, sem as dependências (node_modules, o ambiente do Python), até 500 MB e 20.000 arquivos, e aparece no histórico como Edições nos arquivos. Ela fica pronta alguns segundos depois de aplicar. Aplicar de novo sem mudar nada não guarda outra cópia igual: nenhuma versão sai do limite por isso.
A troca da versão da linguagem, um backup restaurado, o Reinstalar dependências e a própria volta aparecem no histórico, mas não guardam uma versão nova. Editou e quer guardar? Clique em Aplicar mudanças antes de reinstalar ou de voltar para outra versão. Se você mudar para um plano que guarda menos, as versões que passam do limite dele deixam de poder ser baixadas ou restauradas na hora. Uma versão de .zip maior que o limite do .zip do plano de agora ainda pode ser baixada, mas não restaurada: envie de novo um .zip menor. A versão do Aplicar mudanças não tem esse limite.

Baixar uma versão

No histórico, clique no ícone de download da versão (ou em Baixar no menu …). O .zip é o mesmo que foi enviado (na versão do Aplicar mudanças, os arquivos daquele momento), por um link que vale 5 minutos e só para a sua conta.

Voltar para uma versão

  1. Em Configurações › Deploy, abra o menu … da versão e escolha Voltar para esta versão. A versão Atual não tem essa opção: ela já é o que está no projeto. Depois de voltar, a Atual passa a ser a versão da volta, mesmo que existam envios mais novos no histórico.
  2. Escolha se o projeto deve iniciar quando terminar. Desligado (o padrão), ele fica parado até você conferir e clicar em Iniciar.
  3. Confirme. Se o projeto estava no ar, ele para.
  4. Os arquivos de agora são trocados pelos daquela versão. As dependências só são instaladas de novo se o package.json, o package-lock.json ou o requirements.txt mudou; acompanhe em Logs › Instalação.
A configuração não volta: o comando, o arquivo principal, a versão da linguagem, a memória e as variáveis de ambiente continuam as de agora, como no envio de um .zip novo.
Voltar troca a pasta inteira do projeto, inclusive o que o seu app criou depois (um banco SQLite, uploads), que não está em versão nenhuma. Quer guardar isso? Faça um backup antes.
Se o .zip for recusado na troca, não houver espaço no projeto para a versão do Aplicar mudanças ou o projeto não couber no plano ligado (quando você pediu para iniciar), nada muda: os arquivos ficam como estavam e, se o projeto estava no ar, ele volta ao ar. Se a resposta não chegar até o fim, não dá para saber se os arquivos já foram trocados e o projeto fica parado: confira os arquivos antes de iniciar ou tente de novo.

Excluir uma versão

Mandou um .zip com o .env ou o token do bot por engano? Em Configurações › Deploy, abra o menu … da versão e escolha Excluir versão. O .zip guardado é apagado na hora e não dá mais para baixar nem voltar para ele; a linha continua no histórico, e os arquivos do projeto não mudam. Excluir uma versão fica só no painel.

Pela API e no CI

O Histórico de envios sai com a permissão deployments:read; baixar e voltar pedem deployments:write (o modelo Deploy (CI/CD) tem as duas). Num deploy que quebrou, pegue a versão que estava no projeto antes da atual (entre as guardadas que não são a isCurrent, a de activatedAt mais recente) e volte para ela:

Atividade

Voltar, baixar e excluir uma versão entram na Atividade da conta (“Você voltou a uma versão guardada do bot X”), com a data da versão e, pela API, o nome da chave. Excluir o projeto apaga as versões guardadas junto.