Скачивание фиктивного 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) | Значение по умолчанию | Что делает | Когда менять |
|---|---|---|---|
autoDeploy | true | Повторно развёртывает при появлении нового WAR | Отключить в продакшене |
unpackWARs | true | Распаковывает WAR в каталог | Оставить true для упрощения отладки |
deployOnStartup | true | Развёртывает существующие приложения при запуске | Отключить для ручного контроля |
appBase | webapps | Каталог, сканируемый для приложений | Указать другое место для нестандартной структуры |
При тестовом развёртывании оставьте всё по умолчанию. Весь смысл упражнения — убедиться, что поведение «из коробки» работает. Настраивайте параметры только после того, как получите базовую линию.
Устранение неполадок, когда фиктивный 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, и у вас будет рабочий тестовый артефакт менее чем за две минуты.
Автор: Команда DummyWar WikiОбновлено
Похожие гайды
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, что входит в комплект и как исправить типичные проблемы с установкой.