Remover

Uma aplicação criada por engano, um protótipo que não vingou ou um módulo que foi absorvido por outro: eventualmente é preciso remover uma aplicação de um projeto no Embrapa I/O, mantendo o projeto e as demais aplicações intactas.

A remoção é diferente do arquivamento de um projeto, que atua sobre o projeto inteiro. Aqui, apenas a aplicação indicada é retirada, e o nome unix que ela ocupava volta a ficar livre dentro do projeto.

Atenção! Esta é uma ação destrutiva. Antes de prosseguir, faça o backup do que for relevante: o histórico de erros, as métricas de acesso e, sobretudo, os valores das variáveis de ambiente configuradas nas builds, que não são recuperáveis depois da remoção.

O que a remoção faz — e o que ela preserva

A remoção desfaz a configuração da aplicação na plataforma:

1. Apaga os valores das variáveis de ambiente e dos volumes de todos os estágios;
2. Apaga o histórico de builds e o estado dos deploys;
3. Libera as portas que estavam reservadas para a aplicação nos clusters; e
4. Retira a aplicação da dashboard.

Por outro lado, ela não apaga o código-fonte nem as integrações:

1. O repositório é arquivado no GitLab e renomeado com a data e a hora da remoção — por exemplo, pwa_20260910_133155 —, ficando somente leitura;
2. A organização no bug tracking, o site na analítica, o projeto na qualidade de código e os painéis de observabilidade permanecem como estão.

O sublinhado no nome do repositório arquivado é proposital: o nome unix de uma aplicação aceita apenas letras minúsculas, números e hífen, de modo que o repositório arquivado nunca colide com uma aplicação criada depois.

É justamente por isso que é possível criar uma nova aplicação com o mesmo nome — inclusive a partir de um boilerplate diferente. Ela reaproveitará as integrações que sobreviveram, com todo o histórico de erros e de acessos que já existia.

Pré-requisitos

Para remover uma aplicação é necessário:

1. Ser Architect do projeto; e
2. Que a aplicação não tenha nenhuma build instanciada em cluster algum.

Se ainda houver instâncias no ar, remova as builds de todos os estágios antes de prosseguir — a plataforma recusa a remoção enquanto existir qualquer uma.

Removendo a aplicação

No card do projeto, deixe em foco a aplicação que será removida e acesse a opção Remover no menu contextual, na seção “Avançado”. O nome da aplicação em foco aparece no próprio item do menu, para não haver dúvida sobre qual delas será retirada.

O diálogo apresenta as consequências da remoção: o que se perde, o que é preservado e como desfazer. Leia com atenção, aceite os termos e clique em “Prosseguir”.

Um PIN (one-time password) será enviado ao e-mail do Architect para confirmar a ação. Insira o código e clique em “Remover”.

A remoção é imediata: ao final, a aplicação desaparece do card do projeto.

Desfazendo uma remoção

Como o código-fonte é preservado, uma remoção pode ser desfeita — mas não pelo próprio Architect. Desarquivar um repositório no GitLab exige permissão de dono, e o papel do Architect no GitLab é o de Maintainer, que renomeia repositórios mas não os desarquiva.

Para restaurar uma aplicação, um administrador da plataforma precisa:

1. Desarquivar o repositório no GitLab;
2. Devolver-lhe o nome original, removendo o sufixo com a data; e
3. Recriar a aplicação no projeto a partir do repositório existente.

Vale lembrar que apenas o código-fonte volta: as variáveis de ambiente, os volumes e o histórico de builds foram apagados na remoção e precisarão ser configurados novamente.