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.

ArquivoFinalidadeConteúdo típicoImplantado em
.warAplicação webWEB-INF/, recursos estáticosContêiner de servlet (Tomcat)
.jarBiblioteca ou executávelClasses, META-INF/Classpath ou java -jar
.earAplicação corporativaVários módulosServidor Java EE / Jakarta EE
.zipArquivo compactado genéricoQualquer coisaEm 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çãoMelhor paraTamanho típicoEsforço
WAR de exemplo oficial do Apache TomcatTeste de implantação pela primeira vezDezenas de KBNenhum — baixar
Build com maven-archetype-webapp do MavenTestar um pipeline de build realPequenoBaixo — mvn package
ZIP criado manualmente renomeado para .warVerificações em ambientes isolados ou offlineMenos de 2 KBBaixo
Aplicações de exemplo do fornecedor do contêinerVerificar uma versão específica do runtimeVariaMé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:

EtapaAçãoO que verificar
1Copie o WAR para $CATALINA_HOME/webappsO arquivo chega com o .war intacto
2Inicie o Tomcat (catalina.sh run ou startup.sh)Nenhum stack trace em catalina.out
3Observe a autoexpansãoUma pasta aparece com o nome do WAR
4Abra http://localhost:8080/<context>/A página de boas-vindas é renderizada
5Releia o final do logInicializaçã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ãoO que fazQuando alterá-la
autoDeploytrueReimplanta quando um novo WAR apareceDesative em produção
unpackWARstrueExpande o WAR em um diretórioMantenha true para facilitar a depuração
deployOnStartuptrueImplanta aplicações existentes na inicializaçãoDesative para controle manual
appBasewebappsDiretório verificado em busca de aplicaçõesAponte 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.

SintomaCausa provávelCorreção
404 em /sample/Nome de contexto incorreto ou diferença de maiúsculas/minúsculasVerifique o nome da pasta expandida e corresponda exatamente
O WAR nunca é expandidounpackWARs ou autoDeploy desativadosReative ou reinicie o Tomcat
"Invalid or unreadable WAR file"O navegador o renomeou para .zip, ou o download foi truncadoBaixe novamente e verifique com unzip -t sample.war
Erro 500 na requisiçãoweb.xml malformadoValide de acordo com a versão correta da especificação Servlet
Loop repetido de reimplantaçãoDuas cópias do mesmo WARRemova as duplicatas de webapps
Funciona localmente, falha no CIVersão principal do Tomcat diferenteVerifique 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 pipelineComo o Dummy WAR ajudaSinal de sucesso
Configuração localConfirma que o Tomcat está instalado e acessívelA página de boas-vindas carrega
BuildVerifica o empacotamento e a nomenclatura do artefatomvn package produz um .war
Job de implantação no CITesta upload, permissões e lógica de reinícioO job termina com sucesso (verde)
Linha de base de stagingProva que o host de destino funciona antes da implantação realcatalina.out limpo
MonitoramentoAtua como aplicação de referência para verificações de saúdeHTTP 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.war nunca se torne sample-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 Atualizado