В ответе Джеймса содержатся хорошие инструкции по настройке Jetty для работы с Heroku, а в его комментарии содержится ссылка на хороший справочник по использованию встроенного Tomcat. Но также возможно запустить стандартную, автономную версию Tomcat на Heroku. Вот как я смог заставить его работать:
Сначала настройте POM для установки и настройки Tomcat как части вашей сборки, а также для развертывания приложения на установленном экземпляре Tomcat:
<plugin>
<groupId>org.codehaus.cargo</groupId>
<artifactId>cargo-maven2-plugin</artifactId>
<configuration>
<container>
<containerId>tomcat6x</containerId>
<zipUrlInstaller>
<url>http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.18/bin/apache-tomcat-6.0.18.zip</url>
</zipUrlInstaller>
<dependencies>
<dependency>
<groupId>javax.activation</groupId>
<artifactId>activation</artifactId>
</dependency>
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
</dependency>
</dependencies>
</container>
<configuration>
<type>standalone</type>
<deployables>
<deployable>
<groupId>com.yourcompany.name</groupId>
<artifactId>yourArtifact</artifactId>
<type>war</type>
<properties>
<context>ROOT</context>
</properties>
</deployable>
</deployables>
</configuration>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>install</goal>
<goal>configure</goal>
<goal>deploy</goal>
<goal>package</goal>
</goals>
</execution>
</executions>
</plugin>
Затем создайте урезанный server.xml файл, который будет работать на Heroku:
<?xml version='1.0' encoding='utf-8'?>
<Server port="-1">
<Listener className="org.apache.catalina.core.JasperListener" />
<Service name="Catalina">
<Connector port="${http.port}" protocol="HTTP/1.1" connectionTimeout="20000"/>
<Engine name="Catalina" defaultHost="localhost">
<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true"/>
</Engine>
</Service>
</Server>
... это необходимо, потому что вашему приложению Heroku разрешено связываться только с одним портом (который изменяется каждый раз при создании нового экземпляра и указывается в переменной среды $PORT). Попытка привязки к любому другому порту приведет к сбою вашего приложения. Поскольку порт динамический, он должен быть передан в server.xml через системное свойство http.port, но мы вернемся к этому позже.
Пока вы это делаете, также создайте файл persistence.xml, который будет работать с Heroku:
<?xml version="1.0" encoding="UTF-8"?>
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
<persistence-unit name="quiz_devel">
<provider>org.hibernate.ejb.HibernatePersistence</provider>
<exclude-unlisted-classes>false</exclude-unlisted-classes>
<properties>
<property name="hibernate.archive.autodetection" value="class"/>
<property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
<property name="hibernate.hbm2ddl.auto" value="update"/>
<property name="hibernate.show.sql" value="true"/>
<property name="hibernate.c3p0.acquire_increment" value="1"/>
<property name="hibernate.c3p0.idle_test_period" value="10"/>
<property name="hibernate.c3p0.max_size" value="20"/>
<property name="hibernate.c3p0.max_statements" value="40"/>
<property name="hibernate.c3p0.min_size" value="1"/>
<property name="hibernate.c3p0.timeout" value="30"/>
</properties>
</persistence-unit>
</persistence>
Обратите внимание, что здесь не указано hibernate.connection.url. Это связано с тем, что Heroku указывает URL базы данных, который ваше приложение должно использовать в переменной среды $DATABASE_URL.
Теперь пришло время создать простой сценарий оболочки, который настраивает среду и настраивает все так, чтобы Tomcat мог действительно работать:
#point to the correct configuration and webapp
CATALINA_BASE=`pwd`/target/cargo/configurations/tomcat6x
export CATALINA_BASE
#copy over the Heroku config files
cp ./server-heroku.xml ./target/cargo/configurations/tomcat6x/conf/server.xml
cp ./persistence-heroku.xml ./target/cargo/configurations/tomcat6x/webapps/ROOT/WEB-INF/classes/META-INF/persistence.xml
#make the Tomcat scripts executable
chmod a+x ./target/cargo/installs/apache-tomcat-6.0.18/apache-tomcat-6.0.18/bin/*.sh
#set the correct port and database settings
JAVA_OPTS="$JAVA_OPTS -Dhttp.port=$PORT -Dhibernate.connection.url=$DATABASE_URL"
export JAVA_OPTS
#start Tomcat
./target/cargo/installs/apache-tomcat-6.0.18/apache-tomcat-6.0.18/bin/catalina.sh run
Это делает несколько вещей:
- Он говорит Tomcat использовать артефакты конфигурации и развертывания, которые груз упаковал как часть вашей сборки, установив
CATALINE_BASE, чтобы он указывал на правильное место.
- Перезаписывает файлы по умолчанию
server.xml и persistence.xml с их характерными для heroku вариантами.
- Он отмечает все сценарии запуска в экземпляре Tomcat, которые груз установил как часть сборки, как исполняемый файл.
- Указывает значения для
http.port и hibernate.connection.url на основе переменных среды, предоставляемых платформой Heroku.
- Наконец, запускается Tomcat. Обратите внимание, что вы не можете использовать
startup.sh для этого, так как startup.sh запустит Tomcat в новом процессе, а затем завершит работу. Героку не понимает этого и думает, что завершение startup.sh - это завершение процесса Tomcat.
Наконец, последний шаг - настроить Procfile для вызова сценария запуска, что-то вроде:
web: sh startServer-heroku.sh
При таком подходе вы можете создать проект, совместимый с Heroku, при этом сохраняя возможность автономной работы в качестве стандартного веб-приложения Java.