Скачивание фиктивного WAR-файла: безопасный тестовый WAR для развёртывания в Apache Tomcat

Скачайте фиктивный WAR-файл, чтобы безопасно проверить развёртывание в Tomcat, CI/CD-конвейеры и конфигурации сервера. Пошаговое руководство по скачиванию, развёртыванию и устранению неполадок.

Развёртывание непроверенной сборки в работающем контейнере Tomcat — один из самых быстрых способов потерять полдня, а фиктивный WAR-файл — самая дешёвая страховка, которую можно купить. Фиктивный WAR-файл — это крошечный развёртываемый веб-архив, единственная задача которого — доказать, что ваш сервер, пути и конвейер действительно работают до появления реального кода. Обычно он содержит не больше страницы приветствия и дескриптора развёртывания, поэтому если он развёртывается без ошибок, вы знаете: проблема была не в инфраструктуре. Это руководство охватывает, где скачать такой файл, как его развернуть и как читать ошибки, если он не работает.

Что именно представляет собой фиктивный WAR-файл?

WAR (web application archive) — это просто ZIP-файл с очень конкретной внутренней структурой. Контейнеры сервлетов — Tomcat, Jetty, WildFly и другие — ищут именно эту структуру и ничего больше. Фиктивный WAR-файл сводит всё к минимуму, который контейнер всё ещё примет: дескриптор WEB-INF/web.xml, статический index.html в корне и абсолютно никакой логики приложения.

В этом минимализме и весь смысл. Если фиктивный WAR-файл развёртывается и отображается, вы изолировали переменную. Любой сбой после этого относится к вашему реальному приложению, а не к окружению.

АрхивНазначениеТипичное содержимоеКуда развёртывается
.warВеб-приложениеWEB-INF/, статические ресурсыКонтейнер сервлетов (Tomcat)
.jarБиблиотека или исполняемый файлКлассы, META-INF/Classpath или java -jar
.earКорпоративное приложениеНесколько модулейJava EE / Jakarta EE сервер
.zipОбычный сжатый файлЧто угодноНикуда по умолчанию

Что внутри минимального фиктивного WAR-файла

  • WEB-INF/web.xml — дескриптор развёртывания. Необязателен начиная с Servlet 3.0, но если он есть, тест становится реалистичнее.
  • index.html — статическая страница приветствия, чтобы убедиться, что приложение действительно обслуживается.
  • WEB-INF/classes/ — пустая папка в большинстве фиктивных сборок; присутствует только для имитации реальной структуры.
  • META-INF/MANIFEST.MF — необязательные метаданные; безвредны в любом случае.

Хорошо собранный фиктивный WAR-файл обычно весит меньше 10 КБ. Если вы скачиваете что-то, что называет себя тестовым WAR, а весит оно 40 МБ, это реальное приложение под маскировкой.

Где скачать фиктивный WAR-файл

Есть четыре реалистичных пути, и правильный зависит от того, что вы на самом деле пытаетесь доказать.

ВариантЛучше всего подходит дляТипичный размерУсилия
Официальный пример WAR от Apache TomcatПервый тест развёртыванияДесятки КБНет — просто скачать
Сборка Maven maven-archetype-webappПроверка реального конвейера сборкиНебольшойНизкие — mvn package
ZIP, собранный вручную и переименованный в .warПроверки в изолированных или офлайн-средахМеньше 2 КБНизкие
Примеры приложений от производителя контейнераПроверка конкретной версии среды выполненияЗависитСредние

Самый быстрый путь для большинства — пример приложения, поставляемый самим проектом Tomcat. Официальная документация Apache Tomcat по примеру приложения объясняет, что пример упакован как WAR и может быть скачан напрямую — с одной оговоркой, которую стоит повторить: убедитесь, что браузер не переименовывает расширение файла и не добавляет новое. Известно, что Chrome и Edge на некоторых системах превращали sample.war в sample.zip или sample.war.zip.

Если файл сохранился с двойным расширением, контейнер молча его проигнорирует. Вы будете смотреть на 404 и гадать, что сломалось. Переименуйте файл и продолжайте.

Командам, которые хотят, чтобы фиктивный WAR-файл задействовал их реальные инструменты сборки, стоит сгенерировать его, а не скачивать:

mvn archetype:generate -DgroupId=com.example \
  -DartifactId=dummy-war \
  -DarchetypeArtifactId=maven-archetype-webapp

Затем выполните mvn package и заберите артефакт из target/. Теперь у вас есть фиктивный WAR-файл, прошедший тот же инструментарий, что и производственные сборки, — а это заметно более качественная проверка.

Как развернуть фиктивный WAR-файл в Tomcat

Развёртывание намеренно скучное — именно это и нужно от smoke-теста. Стандартная процедура:

ШагДействиеЧто проверить
1Скопируйте WAR в $CATALINA_HOME/webappsФайл оказался на месте с целым .war
2Запустите Tomcat (catalina.sh run или startup.sh)В catalina.out нет стектрейсов
3Следите за авторазвёртываниемПоявляется папка с именем WAR
4Откройте http://localhost:8080/<context>/Страница приветствия отображается
5Перечитайте конец журналаЧистый запуск, без цикла повторного развёртывания

Путь контекста получается из имени файла. Файл с именем sample.war становится /sample. Если хотите разместить приложение в корне сервера, назовите его ROOT.war. Именно на этой детали спотыкается больше новичков, чем на любой другой.

Чтобы осмотреть файл, необязательно развёртывать его. Поскольку WAR — это ZIP, можно сначала распаковать его:

jar -xvf sample.war

Так вы получите дерево каталогов, которое можно прочитать до передачи чего-либо на сервер. Это самый безопасный способ проверить, что незнакомый файл действительно является фиктивным WAR-файлом, а не чем-то с WEB-INF/lib, полным сюрпризов.

Настройки сервера, влияющие на развёртывание

Настройка (в Host)Значение по умолчаниюЧто делаетКогда менять
autoDeploytrueПовторно развёртывает при появлении нового WARОтключить в продакшене
unpackWARstrueРаспаковывает WAR в каталогОставить true для упрощения отладки
deployOnStartuptrueРазвёртывает существующие приложения при запускеОтключить для ручного контроля
appBasewebappsКаталог, сканируемый для приложенийУказать другое место для нестандартной структуры

При тестовом развёртывании оставьте всё по умолчанию. Весь смысл упражнения — убедиться, что поведение «из коробки» работает. Настраивайте параметры только после того, как получите базовую линию.

Устранение неполадок, когда фиктивный WAR-файл не развёртывается

Когда фиктивный WAR-файл не работает, ошибка почти всегда связана с окружением — поэтому её легко исправить, когда знаешь, где искать.

СимптомВероятная причинаИсправление
404 по адресу /sample/Несовпадение имени контекста или регистраПроверьте имя распакованной папки и сопоставьте его точно
WAR не распаковываетсяОтключены unpackWARs или autoDeployВключите обратно или перезапустите Tomcat
«Invalid or unreadable WAR file»Браузер переименовал файл в .zip или загрузка прерваласьСкачайте заново, проверьте с помощью unzip -t sample.war
Ошибка 500 при запросеНекорректный web.xmlПроверьте соответствие нужной версии спецификации Servlet
Повторяющийся цикл развёртыванияДве копии одного и того же WARУдалите дубликаты из webapps
Работает локально, падает в CIДругая мажорная версия TomcatПроверьте пространство имён — см. ниже

На последней строке стоит заострить внимание. Tomcat 10 и более поздние версии перешли от пространства имён javax.servlet к jakarta.servlet. Фиктивный WAR-файл, собранный для Tomcat 9 и ссылающийся на классы javax.servlet, может падать на Tomcat 10+ с ошибками «класс не найден». Чисто статические фиктивные файлы обычно переживают переход, потому что вообще не содержат скомпилированных сервлетов, — ещё один аргумент в пользу минимального тестового WAR.

Сообщения от сопровождающих CI неизменно указывают на три виновника: переименование расширения, предположения о пути контекста и рассинхронизацию версий. Ни одна из них не является проблемой кода.

Лучшие практики использования фиктивного WAR-файла в CI/CD

Относитесь к фиктивному WAR-файлу как к постоянному элементу тестовой инфраструктуры, а не как к разовой загрузке. Вот как команды извлекают из него максимум пользы:

Этап конвейераЧем помогает фиктивный WARПризнак успеха
Локальная настройкаПодтверждает, что Tomcat установлен и доступенСтраница приветствия загружается
СборкаПроверяет упаковку и именование артефактаmvn package создаёт .war
Задача развёртывания в CIПроверяет загрузку, разрешения и логику перезапускаЗадача завершается успешно
Базовая линия на stagingДоказывает, что целевой хост работает до реального развёртыванияЧистый catalina.out
МониторингСлужит эталонным приложением для проверок работоспособностиHTTP 200 со статической страницы

Практические привычки, которые стоит перенять:

  • Закрепите имя файла. Указывайте имя контекста в скриптах развёртывания, чтобы sample.war никогда не превращался в sample-2.war.
  • Проверяйте контрольную сумму загрузки. Храните хеш SHA-256, чтобы каждый раз знать, что тестируется один и тот же артефакт.
  • Повторяйте тест после каждого обновления Tomcat. Даже повышение минорной версии может изменить настройки развёртывания по умолчанию.
  • Держите его вне продакшена. Фиктивный WAR-файл на публичном сервере безвреден, но создаёт шум. Используйте staging-хост.
  • Логируйте путь развёртывания. Большинство инцидентов «вчера всё работало» на самом деле означают «вчера изменился appBase».

Если нужен чуть более реалистичный тест, добавьте в фиктивную сборку тривиальный сервлет или health-эндпоинт. Тогда вы будете проверять жизненный цикл сервлета, а не только отдачу статических файлов, — это ловит совершенно другой класс ошибок конфигурации.

Часто задаваемые вопросы (FAQ)

Безопасно ли развёртывать фиктивный WAR-файл на сервере, который я не контролирую? Правильно собранный — это просто статическая HTML-страница и XML-дескриптор, поэтому эксплуатировать там нечего. Тем не менее распакуйте его с помощью jar -xvf перед развёртыванием и убедитесь, что в WEB-INF/lib нет неизвестных JAR. Доверяй, но проверяй.

В чём разница между фиктивным WAR-файлом и sample.war? Функционально — ни в чём. sample.war — официальное примерное приложение Apache, и оно служит самым распространённым фиктивным WAR-файлом в природе. Самодельный фиктивный WAR-файл — это просто версия, которую вы собрали сами, с меньшим числом движущихся частей.

Будет ли фиктивный WAR-файл работать на Tomcat 10 или 11? Обычно да, при условии что он не содержит скомпилированных сервлетов. Если он ссылается на классы javax.servlet, он не будет работать на Tomcat 10+, потому что пространство имён перешло на jakarta.servlet. Пересоберите его под соответствующую спецификацию Servlet.

Как создать собственный фиктивный WAR-файл с нуля? Создайте папку, добавьте index.html в корень и минимальный web.xml в WEB-INF/, затем заархивируйте содержимое — не родительскую папку — и переименуйте архив с расширением .war. Поместите его в webapps, и у вас будет рабочий тестовый артефакт менее чем за две минуты.

Автор: Обновлено

Похожие гайды

Dummy War Itch Io: руководство по скачиванию — играйте в бесплатную альфу военной песочницы

Руководство по скачиванию Dummy War Itch Io: как получить бесплатную альфу, что хорошо удаётся песочнице с активным рэгдоллом и чего ждать от текущей сборки.

Dummy War Mobile: руководство по загрузке — как играть в рэгдолл-песочницу на Android и iOS

Официальной версии Dummy War Mobile пока не существует. Рассказываем, как устроена рэгдолл-песочница, какие безопасные способы попробовать её на Android есть и чего ждать дальше.

Скачать Dummy War Online: как играть в песочницу DummyWar Alpha на ПК

Скачайте Dummy War Online с официальной страницы itch.io, узнайте, что входит в альфа-версию DummyWar, и что появится дальше.

Скачать Dummy War: альфа-версия военной песочницы для PC (2026)

Полное руководство по скачиванию Dummy War: где взять альфа-сборку, как установить её на PC, что входит в комплект и как исправить типичные проблемы с установкой.