.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
.zipenviado, 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.
.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
- 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.
- Escolha se o projeto deve iniciar quando terminar. Desligado (o padrão), ele fica parado até você conferir e clicar em Iniciar.
- Confirme. Se o projeto estava no ar, ele para.
- Os arquivos de agora são trocados pelos daquela versão. As dependências só são instaladas de novo se o
package.json, opackage-lock.jsonou orequirements.txtmudou; acompanhe em Logs › Instalação.
.zip novo.
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ãodeployments: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:

