Descarga de un archivo WAR de prueba: un WAR de prueba seguro para el despliegue en Apache Tomcat
Consigue un archivo war de prueba para probar de forma segura el despliegue en Tomcat, las canalizaciones CI/CD y las configuraciones del servidor. Guía paso a paso para descargar, desplegar y solucionar problemas.
Desplegar una compilación no probada en un contenedor Tomcat en funcionamiento es una de las formas más rápidas de perder una tarde — y un archivo WAR de prueba es el seguro más barato que puedes conseguir. Un archivo WAR de prueba es un archivo web desplegable diminuto cuyo único cometido es demostrar que tu servidor, tus rutas y tu canalización funcionan realmente antes de que aparezca el código real. Normalmente incluye poco más que una página de bienvenida y un descriptor de despliegue, así que cuando se despliega sin errores sabes que el problema nunca estuvo en tu infraestructura. Esta guía cubre dónde descargar uno, cómo desplegarlo y cómo interpretar los errores cuando falla.
¿Qué es exactamente un archivo WAR de prueba?
Un WAR (archivo de aplicación web) es simplemente un archivo ZIP con una estructura interna muy concreta. Los contenedores de servlets —Tomcat, Jetty, WildFly y compañía— buscan esa estructura y nada más. Un archivo WAR de prueba lo reduce todo al mínimo que un contenedor seguirá aceptando: un descriptor WEB-INF/web.xml, un index.html estático en la raíz y absolutamente ninguna lógica de aplicación.
Esa huella mínima es precisamente el objetivo. Si un archivo WAR de prueba se despliega y se renderiza, has aislado la variable. Cualquier fallo posterior pertenece a tu aplicación real, no a tu entorno.
| Archivo | Propósito | Contenido típico | Se despliega en |
|---|---|---|---|
.war | Aplicación web | WEB-INF/, recursos estáticos | Contenedor de servlets (Tomcat) |
.jar | Biblioteca o ejecutable | Clases, META-INF/ | Classpath o java -jar |
.ear | Aplicación empresarial | Varios módulos | Servidor Java EE / Jakarta EE |
.zip | Archivo comprimido genérico | Cualquier cosa | En ningún sitio, por defecto |
Qué contiene un archivo WAR de prueba mínimo
WEB-INF/web.xml— el descriptor de despliegue. Es opcional desde Servlet 3.0, pero incluir uno hace que tu prueba sea más realista.index.html— una página de bienvenida estática para que puedas confirmar que la aplicación realmente se está sirviendo.WEB-INF/classes/— una carpeta vacía en la mayoría de las compilaciones de prueba, presente solo para reflejar la estructura real.META-INF/MANIFEST.MF— metadatos opcionales; inofensivos en cualquier caso.
Un archivo WAR de prueba bien construido suele ocupar menos de 10 KB. Si descargas algo que dice ser un WAR de prueba y pesa 40 MB, es una aplicación real disfrazada.
Dónde descargar un archivo WAR de prueba
Tienes cuatro caminos realistas, y el correcto depende de lo que realmente intentes demostrar.
| Opción | Ideal para | Tamaño típico | Esfuerzo |
|---|---|---|---|
| WAR de ejemplo oficial de Apache Tomcat | Primera prueba de despliegue | Decenas de KB | Ninguno: descargar |
Compilación con Maven maven-archetype-webapp | Probar una canalización de compilación real | Pequeño | Bajo: mvn package |
ZIP creado a mano y renombrado a .war | Comprobaciones en entornos aislados o sin conexión | Menos de 2 KB | Bajo |
| Aplicaciones de ejemplo del proveedor del contenedor | Verificar una versión específica del entorno de ejecución | Variable | Medio |
La ruta más rápida para la mayoría es la aplicación de ejemplo que incluye el propio proyecto Tomcat. La documentación oficial de la aplicación de ejemplo de Apache Tomcat explica que la aplicación de ejemplo se empaqueta como WAR y se puede descargar directamente, con una advertencia que conviene repetir: asegúrate de que tu navegador no cambie el nombre de la extensión del archivo ni añada una nueva. Se sabe que tanto Chrome como Edge han convertido sample.war en sample.zip o sample.war.zip en ciertos sistemas.
Si tu archivo llega con una extensión duplicada, el contenedor lo ignorará en silencio. Te quedarás mirando un 404 preguntándote qué se rompió. Cámbiale el nombre y sigue adelante.
Si quieres que el archivo WAR de prueba ponga a prueba tus herramientas de compilación reales, genéralo en lugar de descargarlo:
mvn archetype:generate -DgroupId=com.example \
-DartifactId=dummy-war \
-DarchetypeArtifactId=maven-archetype-webapp
Después, ejecuta mvn package y recoge el artefacto de target/. Ahora tienes un archivo WAR de prueba que pasó por la misma cadena de herramientas que tus compilaciones de producción, lo que supone una prueba considerablemente mejor.
Cómo desplegar un archivo WAR de prueba en Tomcat
El despliegue es deliberadamente aburrido, que es exactamente lo que quieres en una prueba de humo. El procedimiento estándar:
| Paso | Acción | Qué verificar |
|---|---|---|
| 1 | Copia el WAR en $CATALINA_HOME/webapps | El archivo llega con el .war intacto |
| 2 | Inicia Tomcat (catalina.sh run o startup.sh) | Sin trazas de pila en catalina.out |
| 3 | Observa la autoexpansión | Aparece una carpeta con el nombre del WAR |
| 4 | Abre http://localhost:8080/<context>/ | La página de bienvenida se renderiza |
| 5 | Vuelve a leer el final del registro | Arranque limpio, sin bucle de redespliegue |
La ruta de contexto se deriva del nombre del archivo. Un archivo llamado sample.war se convierte en /sample. Si quieres la aplicación en la raíz del servidor, nómbralo ROOT.war. Este detalle confunde a más principiantes que cualquier otro.
Tampoco tienes que desplegarlo para inspeccionarlo. Como un WAR es un ZIP, puedes descomprimirlo primero:
jar -xvf sample.war
Eso te da un árbol de directorios que puedes leer antes de subir nada a un servidor. Es la forma más segura de comprobar que una descarga desconocida es realmente un archivo WAR de prueba y no algo con un WEB-INF/lib lleno de sorpresas.
Ajustes del servidor que afectan al despliegue
Ajuste (en Host) | Valor predeterminado | Qué hace | Cuándo cambiarlo |
|---|---|---|---|
autoDeploy | true | Vuelve a desplegar cuando aparece un nuevo WAR | Desactívalo en producción |
unpackWARs | true | Expande el WAR en un directorio | Mantenlo en true para facilitar la depuración |
deployOnStartup | true | Despliega las aplicaciones existentes al arrancar | Desactívalo para tener control manual |
appBase | webapps | Directorio que se analiza en busca de aplicaciones | Apúntalo a otro sitio para estructuras personalizadas |
Para un despliegue de prueba, deja todo con los valores predeterminados. Todo el valor del ejercicio consiste en confirmar que el comportamiento de fábrica funciona. Ajusta la configuración solo después de tener una referencia.
Solucionar problemas de un archivo WAR de prueba que no se despliega
Cuando un archivo WAR de prueba falla, el error casi siempre es del entorno, lo que hace que sea fácil de corregir una vez que sabes dónde mirar.
| Síntoma | Causa probable | Solución |
|---|---|---|
404 en /sample/ | Nombre de contexto incorrecto o uso de mayúsculas distinto | Comprueba el nombre de la carpeta expandida y haz que coincida exactamente |
| El WAR nunca se expande | unpackWARs o autoDeploy desactivados | Vuelve a activarlos o reinicia Tomcat |
| "Archivo WAR no válido o ilegible" | El navegador lo renombró a .zip, o la descarga se truncó | Vuelve a descargarlo, verifícalo con unzip -t sample.war |
| Error 500 en la petición | web.xml mal formado | Valídalo con la versión correcta de la especificación de Servlet |
| Bucle de redespliegue repetido | Dos copias del mismo WAR | Elimina los duplicados de webapps |
| Funciona en local, falla en CI | Versión principal de Tomcat diferente | Comprueba el espacio de nombres; consulta más abajo |
Esa última fila merece énfasis. Tomcat 10 y versiones posteriores pasaron del espacio de nombres javax.servlet a jakarta.servlet. Un archivo WAR de prueba creado para Tomcat 9 que haga referencia a clases javax.servlet puede fallar en Tomcat 10+ con errores de clase no encontrada. Los archivos de prueba puramente estáticos suelen sobrevivir al salto porque no contienen ningún servlet compilado, un argumento más para mantener tu WAR de prueba mínimo.
Los informes de la comunidad de responsables de CI señalan sistemáticamente a los mismos tres culpables: el cambio de nombre de la extensión, las suposiciones sobre la ruta de contexto y la desviación de versiones. Ninguno de ellos es un problema de código.
Buenas prácticas para usar un archivo WAR de prueba en CI/CD
Trata el archivo WAR de prueba como una pieza permanente de la infraestructura de pruebas en lugar de una descarga puntual. Así es como los equipos le sacan el máximo partido:
| Etapa de la canalización | Cómo ayuda el WAR de prueba | Señal de éxito |
|---|---|---|
| Configuración local | Confirma que Tomcat está instalado y es accesible | La página de bienvenida carga |
| Compilación | Verifica el empaquetado y la nomenclatura del artefacto | mvn package produce un .war |
| Trabajo de despliegue en CI | Prueba la subida, los permisos y la lógica de reinicio | El trabajo termina en verde |
| Línea base de staging | Demuestra que el host de destino funciona antes del despliegue real | catalina.out limpio |
| Monitorización | Actúa como aplicación de referencia para las comprobaciones de estado | HTTP 200 desde una página estática |
Hábitos prácticos que conviene adoptar:
- Fija el nombre del archivo. Incluye el nombre del contexto en tus scripts de despliegue para que
sample.warnunca se convierta ensample-2.war. - Calcula la suma de comprobación de tu descarga. Guarda un hash SHA-256 para saber que se está probando el mismo artefacto cada vez.
- Vuelve a probar después de cada actualización de Tomcat. Un cambio de versión menor puede modificar los valores predeterminados de despliegue.
- Mantenlo fuera de producción. Un archivo WAR de prueba en un servidor público es inofensivo, pero también es ruido. Usa un host de staging.
- Registra la ruta de despliegue. La mayoría de los incidentes de "funcionaba ayer" son en realidad "el appBase cambió ayer".
Si quieres una prueba un poco más realista, añade un servlet trivial o un endpoint de estado a tu compilación de prueba. Así estarás ejercitando el ciclo de vida del servlet, no solo el servicio de archivos estáticos, lo que detecta toda una clase diferente de errores de configuración.
Preguntas frecuentes
¿Es seguro desplegar un archivo WAR de prueba en un servidor que no controlo?
Uno bien construido es solo una página HTML estática y un descriptor XML, así que no hay nada que explotar. Aun así, descomprímelo con jar -xvf antes de desplegarlo y confirma que no haya un WEB-INF/lib lleno de JAR desconocidos. Confía, pero verifica.
¿Cuál es la diferencia entre un archivo WAR de prueba y sample.war?
Funcionalmente, ninguna. sample.war es la aplicación de ejemplo oficial de Apache y sirve como el archivo WAR de prueba más utilizado en la práctica. Un archivo WAR de prueba hecho en casa es simplemente una versión que tú mismo construiste con menos piezas móviles.
¿Funcionará un archivo WAR de prueba en Tomcat 10 u 11?
Normalmente sí, siempre que no contenga servlets compilados. Si hace referencia a clases javax.servlet, fallará en Tomcat 10+ porque el espacio de nombres pasó a jakarta.servlet. Vuelve a compilarlo con la especificación de Servlet correspondiente.
¿Cómo creo mi propio archivo WAR de prueba desde cero?
Crea una carpeta, añade index.html en la raíz y un web.xml mínimo dentro de WEB-INF/, luego comprime el contenido —no la carpeta contenedora— y cambia el nombre del archivo con la extensión .war. Colócalo en webapps y tendrás un artefacto de prueba funcional en menos de dos minutos.
Por Equipo de DummyWar WikiActualizado
Guías relacionadas
Descarga de Dummy War Online: cómo jugar al sandbox alfa de DummyWar en PC
Consigue la descarga de Dummy War Online desde la página oficial de itch.io, descubre qué incluye la alfa de DummyWar y mira lo que está por venir.
Descarga de Dummy War: consigue el sandbox militar alfa en PC (2026)
Guía completa para descargar Dummy War: dónde obtener la versión alfa, cómo instalarla en PC, qué incluye y soluciones a problemas habituales de configuración.
Guía de descarga de Dummy War Itch Io: juega la alfa gratuita del sandbox militar
Guía de descarga de Dummy War Itch Io: cómo obtener la alfa gratuita, qué hace bien el sandbox de ragdoll activo y qué esperar de la compilación actual.
Guía de descarga de Dummy War Mobile: cómo jugar al sandbox ragdoll en Android e iOS
Todavía no existe ninguna versión oficial de Dummy War Mobile. Así funciona el sandbox ragdoll, formas seguras de probarlo en Android y qué esperar a continuación.