Download de Dummy War File: Um WAR de Teste Seguro para Implantação no Apache Tomcat
Baixe um dummy war file para testar com segurança a implantação no Tomcat, pipelines de CI/CD e configurações de servidor. Guia passo a passo de download, implantação e solução de problemas.
Implantar uma build não testada em um contêiner Tomcat em produção é uma das maneiras mais rápidas de perder uma tarde — e um dummy war file é o seguro mais barato que você pode comprar. Um dummy war file é um arquivo web compactado minúsculo e implantável cujo único trabalho é provar que seu servidor, seus caminhos e seu pipeline realmente funcionam antes que o código real apareça. Normalmente ele vem com nada mais do que uma página de boas-vindas e um descritor de implantação, então, quando é implantado sem erros, você sabe que o problema nunca foi sua infraestrutura. Este guia aborda onde baixar um, como implantá-lo e como interpretar os erros quando ele falha.
O Que Exatamente É um Dummy War File?
Um WAR (web application archive, ou arquivo de aplicação web) é simplesmente um arquivo ZIP com um layout interno muito específico. Contêineres de servlet — Tomcat, Jetty, WildFly e similares — procuram por esse layout e nada mais. Um dummy war file reduz tudo ao mínimo que um contêiner ainda aceitará: um descritor WEB-INF/web.xml, um index.html estático na raiz e absolutamente nenhuma lógica de aplicação.
Essa pegada minúscula é justamente o ponto. Se um dummy war file é implantado e renderiza, você isolou a variável. Qualquer falha depois disso pertence à sua aplicação real, não ao seu ambiente.
| Arquivo | Finalidade | Conteúdo típico | Implantado em |
|---|---|---|---|
.war | Aplicação web | WEB-INF/, recursos estáticos | Contêiner de servlet (Tomcat) |
.jar | Biblioteca ou executável | Classes, META-INF/ | Classpath ou java -jar |
.ear | Aplicação corporativa | Vários módulos | Servidor Java EE / Jakarta EE |
.zip | Arquivo compactado genérico | Qualquer coisa | Em lugar nenhum, por padrão |
O Que Há Dentro de um Dummy War File Mínimo
WEB-INF/web.xml— o descritor de implantação. Opcional desde o Servlet 3.0, mas incluí-lo torna seu teste mais realista.index.html— uma página de boas-vindas estática para que você possa confirmar que a aplicação está realmente sendo servida.WEB-INF/classes/— uma pasta vazia na maioria das builds dummy, presente apenas para espelhar a estrutura real.META-INF/MANIFEST.MF— metadados opcionais; inofensivo de qualquer forma.
Um dummy war file bem construído geralmente tem menos de 10 KB. Se você baixar algo que alega ser um WAR de teste e ele pesar 40 MB, isso é uma aplicação real disfarçada.
Onde Baixar um Dummy War File
Você tem quatro caminhos realistas, e o correto depende do que você realmente está tentando provar.
| Opção | Melhor para | Tamanho típico | Esforço |
|---|---|---|---|
| WAR de exemplo oficial do Apache Tomcat | Teste de implantação pela primeira vez | Dezenas de KB | Nenhum — baixar |
Build com maven-archetype-webapp do Maven | Testar um pipeline de build real | Pequeno | Baixo — mvn package |
ZIP criado manualmente renomeado para .war | Verificações em ambientes isolados ou offline | Menos de 2 KB | Baixo |
| Aplicações de exemplo do fornecedor do contêiner | Verificar uma versão específica do runtime | Varia | Médio |
O caminho mais rápido para a maioria das pessoas é a aplicação de exemplo fornecida pelo próprio projeto Tomcat. A documentação oficial da aplicação de exemplo do Apache Tomcat explica que a aplicação de exemplo é empacotada como um WAR e pode ser baixada diretamente — com uma ressalva que vale repetir: certifique-se de que seu navegador não renomeie a extensão do arquivo nem acrescente uma nova. Chrome e Edge já foram conhecidos por transformar sample.war em sample.zip ou sample.war.zip em certos sistemas.
Se seu arquivo chegar com uma extensão duplicada, o contêiner o ignorará silenciosamente. Você vai encarar um 404 se perguntando o que quebrou. Renomeie e siga em frente.
Para equipes que querem que o dummy war file exercite suas ferramentas de build reais, gere-o em vez de baixá-lo:
mvn archetype:generate -DgroupId=com.example \
-DartifactId=dummy-war \
-DarchetypeArtifactId=maven-archetype-webapp
Depois, execute mvn package e colete o artefato de target/. Agora você tem um dummy war file que passou pela mesma cadeia de ferramentas das suas builds de produção — o que é um teste significativamente melhor.
Como Implantar um Dummy War File no Tomcat
A implantação é deliberadamente entediante, que é exatamente o que você quer de um smoke test. O procedimento padrão:
| Etapa | Ação | O que verificar |
|---|---|---|
| 1 | Copie o WAR para $CATALINA_HOME/webapps | O arquivo chega com o .war intacto |
| 2 | Inicie o Tomcat (catalina.sh run ou startup.sh) | Nenhum stack trace em catalina.out |
| 3 | Observe a autoexpansão | Uma pasta aparece com o nome do WAR |
| 4 | Abra http://localhost:8080/<context>/ | A página de boas-vindas é renderizada |
| 5 | Releia o final do log | Inicialização limpa, sem loop de reimplantação |
O caminho de contexto é derivado do nome do arquivo. Um arquivo chamado sample.war se torna /sample. Se você quer a aplicação na raiz do servidor, nomeie-o ROOT.war. Isso confunde mais iniciantes do que qualquer outro detalhe isolado.
Você também não precisa implantar para inspecionar. Como um WAR é um ZIP, você pode descompactá-lo primeiro:
jar -xvf sample.war
Isso fornece uma árvore de diretórios que você pode ler antes de enviar qualquer coisa para um servidor. É a maneira mais segura de verificar se um download desconhecido é realmente um dummy war file e não algo com um WEB-INF/lib cheio de surpresas.
Configurações do Servidor Que Afetam a Implantação
Configuração (em Host) | Padrão | O que faz | Quando alterá-la |
|---|---|---|---|
autoDeploy | true | Reimplanta quando um novo WAR aparece | Desative em produção |
unpackWARs | true | Expande o WAR em um diretório | Mantenha true para facilitar a depuração |
deployOnStartup | true | Implanta aplicações existentes na inicialização | Desative para controle manual |
appBase | webapps | Diretório verificado em busca de aplicações | Aponte para outro local em layouts personalizados |
Para uma implantação de teste, deixe tudo nos padrões. Todo o valor do exercício é confirmar que o comportamento padrão funciona. Ajuste as configurações somente depois de ter uma linha de base.
Solução de Problemas Quando um Dummy War File Não É Implantado
Quando um dummy war file falha, o erro quase sempre é ambiental — o que torna fácil corrigi-lo depois que você sabe onde procurar.
| Sintoma | Causa provável | Correção |
|---|---|---|
404 em /sample/ | Nome de contexto incorreto ou diferença de maiúsculas/minúsculas | Verifique o nome da pasta expandida e corresponda exatamente |
| O WAR nunca é expandido | unpackWARs ou autoDeploy desativados | Reative ou reinicie o Tomcat |
| "Invalid or unreadable WAR file" | O navegador o renomeou para .zip, ou o download foi truncado | Baixe novamente e verifique com unzip -t sample.war |
| Erro 500 na requisição | web.xml malformado | Valide de acordo com a versão correta da especificação Servlet |
| Loop repetido de reimplantação | Duas cópias do mesmo WAR | Remova as duplicatas de webapps |
| Funciona localmente, falha no CI | Versão principal do Tomcat diferente | Verifique o namespace — veja abaixo |
A última linha merece ênfase. O Tomcat 10 e versões posteriores passaram do namespace javax.servlet para jakarta.servlet. Um dummy war file criado para o Tomcat 9 que referencia classes javax.servlet pode falhar no Tomcat 10+ com erros de classe não encontrada. Dummies puramente estáticos geralmente sobrevivem à mudança porque não contêm nenhum servlet compilado — mais um argumento para manter seu WAR de teste mínimo.
Relatos da comunidade de mantenedores de CI apontam consistentemente para os mesmos três culpados: renomeação de extensão, suposições sobre o caminho de contexto e divergência de versão. Nenhum deles é problema de código.
Boas Práticas para Usar um Dummy War File em CI/CD
Trate o dummy war file como uma peça permanente da infraestrutura de teste, e não como um download pontual. Veja como as equipes aproveitam ao máximo:
| Etapa do pipeline | Como o Dummy WAR ajuda | Sinal de sucesso |
|---|---|---|
| Configuração local | Confirma que o Tomcat está instalado e acessível | A página de boas-vindas carrega |
| Build | Verifica o empacotamento e a nomenclatura do artefato | mvn package produz um .war |
| Job de implantação no CI | Testa upload, permissões e lógica de reinício | O job termina com sucesso (verde) |
| Linha de base de staging | Prova que o host de destino funciona antes da implantação real | catalina.out limpo |
| Monitoramento | Atua como aplicação de referência para verificações de saúde | HTTP 200 de uma página estática |
Hábitos práticos que vale adotar:
- Fixe o nome do arquivo. Inclua o nome do contexto em seus scripts de implantação para que
sample.warnunca se tornesample-2.war. - Gere o checksum do seu download. Armazene um hash SHA-256 para saber que o mesmo artefato está sendo testado sempre.
- Teste novamente após cada atualização do Tomcat. Uma atualização de versão menor pode alterar os padrões de implantação.
- Mantenha-o fora da produção. Um dummy war file em um servidor público é inofensivo, mas também é ruído. Use um host de staging.
- Registre o caminho de implantação. A maioria dos incidentes do tipo "funcionou ontem" é, na verdade, "o appBase mudou ontem".
Se você quiser um teste um pouco mais realista, adicione um servlet trivial ou um endpoint de saúde à sua build dummy. Assim, você estará exercitando o ciclo de vida do servlet, não apenas o fornecimento de arquivos estáticos — o que captura uma classe completamente diferente de erros de configuração.
Perguntas Frequentes
Um dummy war file é seguro para implantar em um servidor que não controlo?
Um dummy war file construído corretamente é apenas uma página HTML estática e um descritor XML, então não há nada a explorar. Ainda assim, descompacte-o com jar -xvf antes de implantar e confirme que não há um WEB-INF/lib cheio de JARs desconhecidos. Confie, mas verifique.
Qual é a diferença entre um dummy war file e o sample.war?
Funcionalmente, nenhuma. O sample.war é a aplicação de exemplo oficial da Apache e serve como o dummy war file mais comumente usado no mundo. Um dummy war file feito em casa é apenas uma versão que você mesmo criou, com menos partes móveis.
Um dummy war file funcionará no Tomcat 10 ou 11?
Geralmente sim, desde que não contenha servlets compilados. Se ele referenciar classes javax.servlet, falhará no Tomcat 10+ porque o namespace mudou para jakarta.servlet. Recrie-o de acordo com a especificação Servlet correspondente.
Como crio meu próprio dummy war file do zero?
Crie uma pasta, adicione index.html na raiz e um web.xml mínimo dentro de WEB-INF/, depois compacte o conteúdo — não a pasta pai — e renomeie o arquivo com a extensão .war. Coloque-o em webapps e você terá um artefato de teste funcional em menos de dois minutos.
Por Equipe do DummyWar WikiAtualizado
Guias relacionados
Download do Dummy War Online: Como Jogar o Sandbox Alpha do DummyWar no PC
Baixe o Dummy War Online na página oficial do itch.io, saiba o que a alpha do DummyWar inclui e veja o que vem a seguir.
Dummy War Download: Baixe o Sandbox Militar Alpha no PC (2026)
Guia completo do Dummy War download: onde obter a build alpha, como instalá-la no PC, o que está incluído e correções para problemas comuns de instalação.
Guia de Download do Dummy War Itch Io: Jogue o Alpha Gratuito de Sandbox Militar
Guia de download do Dummy War Itch Io: como baixar o alpha gratuito, o que o sandbox de ragdoll ativo faz bem e o que esperar da build atual.
Guia de Download do Dummy War Mobile: Como Jogar o Sandbox Ragdoll no Android e iOS
Ainda não existe uma build oficial do Dummy War Mobile. Veja como o sandbox ragdoll funciona, formas seguras de testá-lo no Android e o que esperar a seguir.