wcmio-content-package:download
Full name:
io.wcm.maven.plugins:wcmio-content-package-maven-plugin:2.1.7-SNAPSHOT:download
Description:
Builds and downloads a content package defined on a remote CRX or AEM system.
Attributes:
- Requires dependency resolution of artifacts in scope:
runtime
. - The goal is thread-safe and supports parallel builds.
- Binds by default to the lifecycle phase:
install
.
Required Parameters
Name | Type | Since | Description |
---|---|---|---|
<outputFile> |
String |
- |
The output file to save. Default: ${project.build.directory}/${project.build.finalName}.zip User Property: vault.outputFile |
<password> |
String |
- |
The password to authenticate against the remote CRX system (package manager). Default: admin User Property: vault.password |
<serviceURL> |
String |
- |
The URL of the HTTP service API of the CRX package manager. See Package Manager HTTP API for details on this interface. Default: http://localhost:4502/crx/packmgr/service User Property: vault.serviceURL |
<userId> |
String |
- |
The user name to authenticate as against the remote CRX system (package manager). Default: admin User Property: vault.userId |
Optional Parameters
Name | Type | Since | Description |
---|---|---|---|
<bundleStatusBlacklistBundleNames> |
String[] |
- |
Patterns for symbolic names of bundles that are expected to be not present in bundle list. If any of these bundles are found in the bundle list, this system is assumed as not ready for installing further packages because a previous installation (e.g. of AEM service pack) is still in progress. Default: ^updater\.aem.*$ User Property: vault.bundleStatusBlacklistBundleNames |
<bundleStatusURL> |
String |
- |
Bundle status JSON URL. If an URL is configured the activation status of all bundles in the system is checked before it is tried to upload and install a new package and after each upload. If not all bundles are activated the upload is delayed up to Expected is an URL like: http://localhost:4502/system/console/bundles/.json If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled. User Property: vault.bundleStatusURL |
<bundleStatusWaitLimit> |
int |
- |
Number of seconds to wait as maximum for a positive bundle status check. If this limit is reached and the bundle status is still not positive the install of the package proceeds anyway. Default: 360 User Property: vault.bundleStatusWaitLimit |
<bundleStatusWhitelistBundleNames> |
String[] |
- |
Patterns for symbolic names of bundles that are ignored in bundle list. The state of these bundles has no effect on the bundle status check. Default: ^com\.day\.crx\.crxde-support$,^com\.adobe\.granite\.crx-explorer$,^com\.adobe\.granite\.crxde-lite$,^org\.apache\.sling\.jcr\.webdav$,^org\.apache\.sling\.jcr\.davex$ User Property: vault.bundleStatusWhitelistBundleNames |
<consoleOauth2AccessToken> |
String |
- |
OAuth 2 access token to authenticate against the remote CRX system (Felix console). If this is configured, username and password are ignored. Defaults to value from oauth2AccessToken .User Property: console.consoleOauth2AccessToken |
<consolePassword> |
String |
- |
The password to authenticate against the remote CRX system (Felix console). Defaults to the value from password .User Property: console.password |
<consoleUserId> |
String |
- |
The user name to authenticate as against the remote CRX system (Felix console). Defaults to the value from userId .User Property: console.userId |
<contentPackagePath> |
String |
- |
Path of the content package to download. The path is detected automatically when uploadPackageDefinition is set to true (which is default). If set to false, the path of the content package needs to be specified explicitly. Example path: User Property: vault.download.contentPackagePath |
<dateLastReplicated> |
String |
- |
Sets a fixed date to be used for the "lastReplicated" property when setting replication status to "activated". If not set the current date is used. Use ISO8601 format. Example: |
<excludeFiles> |
String[] |
- |
List of regular patterns matching relative path of extracted content package. All files matching these patterns are excluded when unpacking the content package. |
<excludeMixins> |
String[] |
- |
List of regular patterns matching mixin names inside a .content.xml file. All mixins matching theses patterns are removed from the .content.xml when unpacking the content package. |
<excludeNodes> |
String[] |
- |
List of regular patterns matching node paths in the whole content package. All nodes matching theses patterns are removed from the .content.xml when unpacking the content package. |
<excludeProperties> |
String[] |
- |
List of regular patterns matching property names inside a .content.xml file. All properties matching theses patterns are removed from the .content.xml when unpacking the content package. |
<httpConnectTimeoutSec> |
int |
- |
HTTP connection timeout (in seconds). Default: 10 User Property: vault.httpConnectTimeoutSec |
<httpSocketTimeout> |
int |
- |
HTTP socket timeout (in seconds). Default: 60 User Property: vault.httpSocketTimeoutSec |
<markReplicationActivated> |
boolean |
- |
Set replication status to "activated" for all cq:Page and cq:Template nodes. |
<markReplicationActivatedIncludeNodes> |
String[] |
- |
List of regular patterns matching node paths in the whole content package. If markReplicationActivated is activated it affects only nodes matched by any of these patterns. |
<oauth2AccessToken> |
String |
- |
OAuth 2 access token to authenticate against the remote CRX system (package manager). If this is configured, username and password are ignored. User Property: vault.oauth2AccessToken |
<packageFile> |
File |
- |
The name of the content package file to install on the target system. If not set, the primary artifact of the project is considered the content package to be installed. Default: ${project.build.directory}/${project.build.finalName}.zip User Property: vault.file |
<packageManagerInstallStatusURL> |
String |
- |
Package Manager install status JSON URL. If an URL is configured the installation status of packages and embedded packages is checked before it is tried to upload and install a new package and after each upload. If not all packages are installed the upload is delayed up to Expected is an URL like: http://localhost:4502/crx/packmgr/installstatus.jsp If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled. User Property: vault.packageManagerInstallStatusURL |
<packageManagerInstallStatusWaitLimit> |
int |
- |
Number of seconds to wait as maximum for a positive package manager install status check. If this limit is reached and the package manager status is still not positive the install of the package proceeds anyway. Default: 360 User Property: vault.packageManagerInstallStatusWaitLimit |
<packageManagerOutputLogLevel> |
String |
- |
Log level to be used to log responses from package manager (which may get huge for large packages). Possible values are INFO (default) or DEBUG. Default: INFO User Property: vault.packageManagerOutputLogLevel |
<rebuildPackage> |
boolean |
- |
Whether to rebuild the package within the CRX package manager before downloading it to include the latest content from repository. Default: true User Property: vault.download.rebuildPackage |
<relaxedSSLCheck> |
boolean |
- |
If set to true also self-signed certificates are accepted. Default: false User Property: vault.relaxedSSLCheck |
<retryCount> |
int |
- |
Number of times to retry upload and install via CRX HTTP interface if it fails. Default: 24 User Property: vault.retryCount |
<retryDelay> |
int |
- |
Number of seconds between retry attempts. Default: 5 User Property: vault.retryDelay |
<skip> |
boolean |
- |
Set this to "true" to skip installing packages to CRX although configured in the POM. Default: false User Property: vault.skip |
<unpack> |
boolean |
- |
If set to true the package is unpacked to the directory specified by unpackDirectory .Default: false User Property: vault.unpack |
<unpackDeleteDirectories> |
String[] |
- |
If unpack=true: delete existing content from the named directories (relative to unpackDirectory root) before unpacking the package content, to make sure only the content from the downloaded package remains. |
<unpackDirectory> |
File |
- |
Directory to unpack the content of the package to. Default: ${basedir} User Property: vault.unpackDirectory |
<uploadPackageDefinition> |
boolean |
- |
Whether to upload the local package definition first to CRX package manager before actually downloading the package. For this, the local package has to been build locally already. Default: true User Property: vault.download.uploadPackageDefinition |
Parameter Details
<bundleStatusBlacklistBundleNames>
- Type:
java.lang.String[]
- Required:
No
- User Property:
vault.bundleStatusBlacklistBundleNames
- Default:
^updater\.aem.*$
<bundleStatusURL>
Bundle status JSON URL. If an URL is configured the activation status of all bundles in the system is checked before it is tried to upload and install a new package and after each upload.
If not all bundles are activated the upload is delayed up to bundleStatusWaitLimit
seconds, every 5 seconds the activation status is checked anew.
Expected is an URL like: http://localhost:4502/system/console/bundles/.json
If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled.
- Type:
java.lang.String
- Required:
No
- User Property:
vault.bundleStatusURL
<bundleStatusWaitLimit>
- Type:
int
- Required:
No
- User Property:
vault.bundleStatusWaitLimit
- Default:
360
<bundleStatusWhitelistBundleNames>
- Type:
java.lang.String[]
- Required:
No
- User Property:
vault.bundleStatusWhitelistBundleNames
- Default:
^com\.day\.crx\.crxde-support$,^com\.adobe\.granite\.crx-explorer$,^com\.adobe\.granite\.crxde-lite$,^org\.apache\.sling\.jcr\.webdav$,^org\.apache\.sling\.jcr\.davex$
<consoleOauth2AccessToken>
oauth2AccessToken
.
- Type:
java.lang.String
- Required:
No
- User Property:
console.consoleOauth2AccessToken
<consolePassword>
password
.
- Type:
java.lang.String
- Required:
No
- User Property:
console.password
<consoleUserId>
userId
.
- Type:
java.lang.String
- Required:
No
- User Property:
console.userId
<contentPackagePath>
uploadPackageDefinition
is set to true (which is default). If set to false, the path of the content package needs to be specified explicitly.
Example path: /etc/packages/mygroup/mypackage-1.0.0-SNAPSHOT.zip
- Type:
java.lang.String
- Required:
No
- User Property:
vault.download.contentPackagePath
<dateLastReplicated>
Use ISO8601 format. Example: 2020-01-01T00:00:00.000+02:00
.
- Type:
java.lang.String
- Required:
No
<excludeFiles>
- Type:
java.lang.String[]
- Required:
No
<excludeMixins>
.content.xml
file. All mixins matching theses patterns are removed from the .content.xml
when unpacking the content package.
- Type:
java.lang.String[]
- Required:
No
<excludeNodes>
.content.xml
when unpacking the content package.
- Type:
java.lang.String[]
- Required:
No
<excludeProperties>
.content.xml
file. All properties matching theses patterns are removed from the .content.xml
when unpacking the content package.
- Type:
java.lang.String[]
- Required:
No
<httpConnectTimeoutSec>
- Type:
int
- Required:
No
- User Property:
vault.httpConnectTimeoutSec
- Default:
10
<httpSocketTimeout>
- Type:
int
- Required:
No
- User Property:
vault.httpSocketTimeoutSec
- Default:
60
<markReplicationActivated>
- Type:
boolean
- Required:
No
<markReplicationActivatedIncludeNodes>
- Type:
java.lang.String[]
- Required:
No
<oauth2AccessToken>
- Type:
java.lang.String
- Required:
No
- User Property:
vault.oauth2AccessToken
<outputFile>
- Type:
java.lang.String
- Required:
Yes
- User Property:
vault.outputFile
- Default:
${project.build.directory}/${project.build.finalName}.zip
<packageFile>
- Type:
java.io.File
- Required:
No
- User Property:
vault.file
- Default:
${project.build.directory}/${project.build.finalName}.zip
<packageManagerInstallStatusURL>
Package Manager install status JSON URL. If an URL is configured the installation status of packages and embedded packages is checked before it is tried to upload and install a new package and after each upload.
If not all packages are installed the upload is delayed up to packageManagerInstallStatusWaitLimit
seconds, every 5 seconds the installation status is checked anew.
Expected is an URL like: http://localhost:4502/crx/packmgr/installstatus.jsp
If the URL is not set it is derived from serviceURL. If set to "-" the status check is disabled.
- Type:
java.lang.String
- Required:
No
- User Property:
vault.packageManagerInstallStatusURL
<packageManagerInstallStatusWaitLimit>
- Type:
int
- Required:
No
- User Property:
vault.packageManagerInstallStatusWaitLimit
- Default:
360
<packageManagerOutputLogLevel>
- Type:
java.lang.String
- Required:
No
- User Property:
vault.packageManagerOutputLogLevel
- Default:
INFO
<password>
- Type:
java.lang.String
- Required:
Yes
- User Property:
vault.password
- Default:
admin
<rebuildPackage>
- Type:
boolean
- Required:
No
- User Property:
vault.download.rebuildPackage
- Default:
true
<relaxedSSLCheck>
- Type:
boolean
- Required:
No
- User Property:
vault.relaxedSSLCheck
- Default:
false
<retryCount>
- Type:
int
- Required:
No
- User Property:
vault.retryCount
- Default:
24
<retryDelay>
- Type:
int
- Required:
No
- User Property:
vault.retryDelay
- Default:
5
<serviceURL>
The URL of the HTTP service API of the CRX package manager.
See Package Manager HTTP API for details on this interface.
- Type:
java.lang.String
- Required:
Yes
- User Property:
vault.serviceURL
- Default:
http://localhost:4502/crx/packmgr/service
<skip>
- Type:
boolean
- Required:
No
- User Property:
vault.skip
- Default:
false
<unpack>
unpackDirectory
.
- Type:
boolean
- Required:
No
- User Property:
vault.unpack
- Default:
false
<unpackDeleteDirectories>
unpackDirectory
root) before unpacking the package content, to make sure only the content from the downloaded package remains.
- Type:
java.lang.String[]
- Required:
No
<unpackDirectory>
- Type:
java.io.File
- Required:
No
- User Property:
vault.unpackDirectory
- Default:
${basedir}
<uploadPackageDefinition>
- Type:
boolean
- Required:
No
- User Property:
vault.download.uploadPackageDefinition
- Default:
true
<userId>
- Type:
java.lang.String
- Required:
Yes
- User Property:
vault.userId
- Default:
admin