You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by al...@apache.org on 2016/08/18 23:19:33 UTC
[1/2] brooklyn-docs git commit: Updated the maven archetype doc to
more explicity show adding the JAR to Brooklyn
Repository: brooklyn-docs
Updated Branches:
refs/heads/master 284fd72d2 -> 7df556977
Updated the maven archetype doc to more explicity show adding the JAR to Brooklyn
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/792b72dc
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/792b72dc
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/792b72dc
Branch: refs/heads/master
Commit: 792b72dc560c8d2e07c367c663fbc58de7095c53
Parents: 284fd72
Author: graeme.miller <gr...@cloudsoftcorp.com>
Authored: Fri Aug 5 16:56:14 2016 +0100
Committer: graeme.miller <gr...@cloudsoftcorp.com>
Committed: Fri Aug 5 16:56:14 2016 +0100
----------------------------------------------------------------------
guide/java/archetype.md | 35 +++++++++++++++++++++++++----------
1 file changed, 25 insertions(+), 10 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/792b72dc/guide/java/archetype.md
----------------------------------------------------------------------
diff --git a/guide/java/archetype.md b/guide/java/archetype.md
index 3bd3426..8a9ac11 100644
--- a/guide/java/archetype.md
+++ b/guide/java/archetype.md
@@ -61,19 +61,34 @@ $ mvn clean install
The build will produce an OSGi bundle in `target/autobrick-0.1.0-SNAPSHOT.jar`, suitable for
use in the [Brooklyn catalog]({{ site.path.guide }}/ops/catalog/) (using `brooklyn.libraries`).
-The project comes with a `sample.bom` file, located in `src/test/resources`. You will first have
-to copy the target jar to a suitable location, and update the URL in `sample.bom` to point at that
-jar.
-
-The command below will use the REST api to add this to the catalog of a running Brooklyn instance:
+To use this in your Brooklyn catalog you will first have to copy the target jar to a suitable location.
+For developing/testing purposes storing on the local filesystem is fine.
+For production use, we recommend uploading to a remote maven repository or similar.
+
+Once your jar is in a suitable location the next step is to add a new catalog item to Brooklyn.
+The project comes with a `catalog.bom` file, located in `src/main/resources`.
+Modify this file by adding a 'brooklyn.libraries' statement to the bom pointing to the jar.
+For example:
+
+{% highlight yaml %}
+brooklyn.catalog:
+ brooklyn.libraries:
+ - file:///path/to/jar/autobrick-0.1.0-SNAPSHOT.jar
+ itemType: entity
+ items:
+ - id: com.acme.MySample
+ item:
+ type: com.acme.MySample
+{% endhighlight %}
- curl -u admin:pa55w0rd http://127.0.0.1:8081/v1/catalog --data-binary @src/test/resources/sample.bom
+The command below will use the CLI to add this to the catalog of a running Brooklyn instance:
-The YAML blueprint below shows an example usage of this blueprint:
+{% highlight bash %}
+ br add-catalog src/main/resources/catalog.bom
+{% endhighlight %}
- name: my sample
- services:
- - type: com.acme.MySampleInCatalog:1.0
+After running that command the entity will have been added to your catalog and can be used
+in the same way as regular Brooklyn entities.
### Testing Entities
[2/2] brooklyn-docs git commit: This closes #100
Posted by al...@apache.org.
This closes #100
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/7df55697
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/7df55697
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/7df55697
Branch: refs/heads/master
Commit: 7df556977dda13af2f9f62cf28e05c989b45ec4b
Parents: 284fd72 792b72d
Author: Aled Sage <al...@gmail.com>
Authored: Fri Aug 19 00:19:18 2016 +0100
Committer: Aled Sage <al...@gmail.com>
Committed: Fri Aug 19 00:19:18 2016 +0100
----------------------------------------------------------------------
guide/java/archetype.md | 35 +++++++++++++++++++++++++----------
1 file changed, 25 insertions(+), 10 deletions(-)
----------------------------------------------------------------------