Repository: incubator-unomi Updated Branches: refs/heads/master 8b068c291 -> c249483b9
UNOMI-182 add documentation for definition deployment Project: http://git-wip-us.apache.org/repos/asf/incubator-unomi/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-unomi/commit/c249483b Tree: http://git-wip-us.apache.org/repos/asf/incubator-unomi/tree/c249483b Diff: http://git-wip-us.apache.org/repos/asf/incubator-unomi/diff/c249483b Branch: refs/heads/master Commit: c249483b9d51665ee9b0be9874e70f14b48796c1 Parents: 8b068c2 Author: dgaillard <dgaill...@jahia.com> Authored: Tue May 29 11:24:54 2018 +0200 Committer: dgaillard <dgaill...@jahia.com> Committed: Tue May 29 11:24:54 2018 +0200 ---------------------------------------------------------------------- src/site/markdown/versions/master/custom-extensions.md | 6 ++++++ 1 file changed, 6 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-unomi/blob/c249483b/src/site/markdown/versions/master/custom-extensions.md ---------------------------------------------------------------------- diff --git a/src/site/markdown/versions/master/custom-extensions.md b/src/site/markdown/versions/master/custom-extensions.md index e688df2..d288663 100644 --- a/src/site/markdown/versions/master/custom-extensions.md +++ b/src/site/markdown/versions/master/custom-extensions.md @@ -73,6 +73,12 @@ An extension is simply a Maven project, with a Maven pom that looks like this: An extension may contain many different kinds of Apache Unomi objects, as well as custom OSGi services or anything that is needed to build your application. +## Deployment and custom definition + +When you deploy a custom bundle with a custom definition (see "Predefined xxx" chapters under) for the first time, the definition will automatically be deployed at your bundle start event **if it does not exist**, after that if you redeploy the same bundle there are two cases: +1. Your bundle **is a SNAPSHOT** then every time you redeploy it the definition will be redeployed +2. Your bundle **is NOT a SNAPSHOT** then the definition will not be redeployed, but you can redeploy it manually using the command `unomi:deploy-definition <bundleId> <fileName>` + ## Predefined segments You may provide pre-defined segments by simply adding a JSON file in the src/main/resources/META-INF/cxs/segments directory of