Apache Sling Maven Plugin for Supporting Bundle Development

Required Parameters

Name	Type	Since	Description
bundleStart	`boolean`	`-`	Whether to start the uploaded bundle or not. Only applies when POSTing to Felix Web Console Default value is: `true`. User property is: `sling.bundle.start`.
bundleStartLevel	`String`	`-`	The startlevel for the uploaded bundle. Only applies when POSTing to Felix Web Console. Default value is: `20`. User property is: `sling.bundle.startlevel`.
failOnError	`boolean`	`-`	Determines whether or not to fail the build if the HTTP POST or PUT returns an non-OK response code. Default value is: `true`. User property is: `sling.failOnError`.
mimeType	`String`	`-`	The content type / mime type used for WebDAV or Sling POST deployment. Default value is: `application/java-archive`. User property is: `sling.mimeType`.
mountByFS	`boolean`	`-`	Whether to add the mapping for the fs provider Default value is: `false`. User property is: `sling.mountByFS`.
password	`String`	`-`	The password to authenticate at the running Sling instance. Default value is: `admin`. User property is: `sling.password`.
refreshPackages	`boolean`	`-`	Whether to refresh the packages after installing the uploaded bundle. Only applies when POSTing to Felix Web Console Default value is: `true`. User property is: `sling.refreshPackages`.
slingUrl	`String`	`-`	The URL of the running Sling instance. The default is only useful for WebConsole deployment (see `deploymentMethod`). Default value is: `http://localhost:8080/system/console`. User property is: `sling.url`.
user	`String`	`-`	The user name to authenticate at the running Sling instance. Default value is: `admin`. User property is: `sling.user`.

Optional Parameters

Name	Type	Since	Description
artifact	`String`	`-`	A string of the form groupId:artifactId:version[:packaging[:classifier]]. User property is: `sling.artifact`.
artifactId	`String`	`-`	The artifactId of the artifact to install User property is: `sling.artifactId`.
bundleFileName	`String`	`-`	The name of the generated JAR file. User property is: `sling.file`.
classifier	`String`	`-`	The classifier of the artifact to install User property is: `sling.classifier`.
deploymentMethod	`AbstractBundleInstallMojo$BundleDeploymentMethod`	`-`	Bundle deployment method. One of the following three values are allowed WebConsole, uses the Felix Web Console REST API for deployment (HTTP POST). This is the default. Make sure that `slingUrl` points to the Felix Web Console in that case. WebDAV, uses WebDAV for deployment (HTTP PUT). Make sure that `slingUrl` points to the entry path of the Sling WebDAV bundle (usually below regular Sling root URL). Issues a HTTP Delete for the uninstall goal. SlingPostServlet, uses the Sling Post Servlet for deployment (HTTP POST). Make sure that `slingUrl` points a path which is handled by the Sling POST Servlet (usually below regular Sling root URL). This has precedence over the deprecated parameter `usePut`. User property is: `sling.deploy.method`.
groupId	`String`	`-`	The groupId of the artifact to install User property is: `sling.groupId`.
packaging	`String`	`-`	The packaging of the artifact to install Default value is: `jar`. User property is: `sling.packaging`.
repositoryId	`String`	`-`	The id of the repository from which we'll download the artifact Default value is: `temp`. User property is: `sling.repoId`.
repositoryUrl	`String`	`-`	The url of the repository from which we'll download the artifact User property is: `sling.repoUrl`.
slingUrlSuffix	`String`	`-`	An optional url suffix which will be appended to the `sling.url` for use as the real target url. This allows to configure different target URLs in each POM, while using the same common `sling.url` in a parent POM (eg. `sling.url=http://localhost:8080` and `sling.urlSuffix=/project/specific/path`). This is typically used in conjunction with WebDAV or SlingPostServlet deployment methods. User property is: `sling.urlSuffix`.
usePut	`boolean`	`-`	Deprecated. Use `deploymentMethod` instead. Default value is: `false`. User property is: `sling.usePut`.
version	`String`	`-`	The version of the artifact to install User property is: `sling.version`.

Parameter Details

artifact:

A string of the form groupId:artifactId:version[:packaging[:classifier]].

Type: java.lang.String
Required: No
User Property: sling.artifact

artifactId:

The artifactId of the artifact to install

Type: java.lang.String
Required: No
User Property: sling.artifactId

bundleFileName:

The name of the generated JAR file.

Type: java.lang.String
Required: No
User Property: sling.file

bundleStart:

Whether to start the uploaded bundle or not. Only applies when POSTing to Felix Web Console

Type: boolean
Required: Yes
User Property: sling.bundle.start
Default: true

bundleStartLevel:

The startlevel for the uploaded bundle. Only applies when POSTing to Felix Web Console.

Type: java.lang.String
Required: Yes
User Property: sling.bundle.startlevel
Default: 20

classifier:

The classifier of the artifact to install

Type: java.lang.String
Required: No
User Property: sling.classifier

deploymentMethod:

Bundle deployment method. One of the following three values are allowed

WebConsole, uses the Felix Web Console REST API for deployment (HTTP POST). This is the default. Make sure that slingUrl points to the Felix Web Console in that case.
WebDAV, uses WebDAV for deployment (HTTP PUT). Make sure that slingUrl points to the entry path of the Sling WebDAV bundle (usually below regular Sling root URL). Issues a HTTP Delete for the uninstall goal.
SlingPostServlet, uses the Sling Post Servlet for deployment (HTTP POST). Make sure that slingUrl points a path which is handled by the Sling POST Servlet (usually below regular Sling root URL).

This has precedence over the deprecated parameter usePut.

Type: org.apache.sling.maven.bundlesupport.AbstractBundleInstallMojo$BundleDeploymentMethod
Required: No
User Property: sling.deploy.method

failOnError:

Determines whether or not to fail the build if the HTTP POST or PUT returns an non-OK response code.

Type: boolean
Required: Yes
User Property: sling.failOnError
Default: true

groupId:

The groupId of the artifact to install

Type: java.lang.String
Required: No
User Property: sling.groupId

mimeType:

The content type / mime type used for WebDAV or Sling POST deployment.

Type: java.lang.String
Required: Yes
User Property: sling.mimeType
Default: application/java-archive

mountByFS:

Whether to add the mapping for the fs provider

Type: boolean
Required: Yes
User Property: sling.mountByFS
Default: false

packaging:

The packaging of the artifact to install

Type: java.lang.String
Required: No
User Property: sling.packaging
Default: jar

password:

The password to authenticate at the running Sling instance.

Type: java.lang.String
Required: Yes
User Property: sling.password
Default: admin

refreshPackages:

Whether to refresh the packages after installing the uploaded bundle. Only applies when POSTing to Felix Web Console

Type: boolean
Required: Yes
User Property: sling.refreshPackages
Default: true

repositoryId:

The id of the repository from which we'll download the artifact

Type: java.lang.String
Required: No
User Property: sling.repoId
Default: temp

repositoryUrl:

The url of the repository from which we'll download the artifact

Type: java.lang.String
Required: No
User Property: sling.repoUrl

slingUrl:

The URL of the running Sling instance. The default is only useful for WebConsole deployment (see deploymentMethod).

Type: java.lang.String
Required: Yes
User Property: sling.url
Default: http://localhost:8080/system/console

slingUrlSuffix:

An optional url suffix which will be appended to the sling.url for use as the real target url. This allows to configure different target URLs in each POM, while using the same common sling.url in a parent POM (eg. sling.url=http://localhost:8080 and sling.urlSuffix=/project/specific/path). This is typically used in conjunction with WebDAV or SlingPostServlet deployment methods.

Type: java.lang.String
Required: No
User Property: sling.urlSuffix

usePut:

Deprecated. Use deploymentMethod instead.

If a PUT via WebDAV should be used instead of the standard POST to the Felix Web Console. In the uninstall goal, a HTTP DELETE will be used.

Type: boolean
Required: No
User Property: sling.usePut
Default: false

user:

The user name to authenticate at the running Sling instance.

Type: java.lang.String
Required: Yes
User Property: sling.user
Default: admin

version:

The version of the artifact to install

Type: java.lang.String
Required: No
User Property: sling.version