raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 10

=doc #3849 Add instructions for Maven Shade plugin

Browse source
This commit is contained in:
bryan hunt 2014-02-07 09:14:22 +00:00
parent f1edf78979
commit ee352cee37
1 changed files with 40 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

40
akka-docs/rst/general/configuration.rst
View file

@ -79,6 +79,46 @@ When using JarJar, OneJar, Assembly or any jar-bundler
that if you put/merge multiple jars into the same jar, you need to merge all the
reference.confs as well. Otherwise all defaults will be lost and Akka will not function.
If you are using Maven to package your application, you can also make use of the `Apache Maven Shade Plugin<http://maven.apache.org/plugins/maven-shade-plugin>`_ support for `Resource Transformers<http://maven.apache.org/plugins/maven-shade-plugin/examples/resource-transformers.html#AppendingTransformer>`_ to merge all the reference.confs on the build classpath into one.
The plugin configuration might look like this::
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.5</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<shadedArtifactAttached>true</shadedArtifactAttached>
<shadedClassifierName>allinone</shadedClassifierName>
<artifactSet>
<includes>
<include>*:*</include>
</includes>
</artifactSet>
<transformers>
<transformer
implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
<resource>reference.conf</resource>
</transformer>
<transformer
implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<manifestEntries>
<Main-Class>akka.Main</Main-Class>
</manifestEntries>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
Custom application.conf
-----------------------