Package a Liberty server.
The libertyPackage
task is used to create a ZIP, TAR, TAR.GZ or JAR archive of your Liberty runtime and server.
In Open Liberty and WebSphere Liberty versions since 8.5.5.9, it is possible to package a server into an executable jar file by setting the include
parameter to runnable
. The created JAR file can be executed using the java -jar
command.
libertyPackage
depends on installLiberty
.
libertyPackage
also depends on deploy
and installFeature
if configured.
See the Liberty server configuration properties for common server configuration.
The libertyPackage
task uses a packageLiberty
block to define task specific behavior.
Attribute | Type | Since | Description | Required |
---|---|---|---|---|
include | String | 1.0 | Controls the package contents. Can be used with values all , usr , minify , wlp , runnable , all,runnable and minify,runnable . The default value is all . The runnable , all,runnable and minify,runnable values are supported beginning with 8.5.5.9 and works with jar type packages only. |
Yes, only when the os option is set. |
os | String | 1.0 | A comma-delimited list of operating systems that you want the packaged server to support. To specify that an operating system is not to be supported, prefix it with a minus sign ("-"). The 'include' attribute must be set to minify . |
No |
packageDirectory | String | 3.0 | Directory of the packaged file. The default value is ${project.getLayout().getBuildDirectory().getAsFile().get()}/libs . If the directory is not absolute, it is created in ${project.getLayout().getBuildDirectory().getAsFile().get()}/libs . |
No |
packageName | String | 3.0 | Name of the packaged file. The default value is ${project.name} . |
No |
packageType | String | 3.0 | Type of package. Can be used with values zip , jar , tar , or tar.gz . Defaults to jar if runnable is specified for the include property. Otherwise the default value is zip . |
No |
serverRoot | String | 3.0 | Specifies the root server folder name in the packaged file. | No |
This example shows you how to package a minified ZIP archive.
apply plugin: 'liberty'
liberty {
server {
name = 'myServer'
packageLiberty {
packageName = "MyPackage"
include = "minify"
os = "Linux"
}
}
}
This example shows you how to package a runnable JAR file.
apply plugin: 'liberty'
liberty {
server {
name = 'myServer'
packageLiberty {
packageName = "MyPackage"
include = "runnable"
}
}
}