You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by he...@apache.org on 2016/02/24 19:56:44 UTC
[2/9] brooklyn-docs git commit: Added locations example to catalog
entries
Added locations example to catalog entries
Added format for the getting started vagrant byon to a catalog entry example
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/16cd115d
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/16cd115d
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/16cd115d
Branch: refs/heads/master
Commit: 16cd115d7d3b842bd8b8b775f28caddec8cb65f1
Parents: ee148da
Author: drigodwin <dr...@googlemail.com>
Authored: Mon Feb 22 11:34:17 2016 +0000
Committer: drigodwin <dr...@googlemail.com>
Committed: Mon Feb 22 11:34:17 2016 +0000
----------------------------------------------------------------------
guide/ops/catalog/index.md | 29 ++++++++++++++++++++++++++++-
1 file changed, 28 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/16cd115d/guide/ops/catalog/index.md
----------------------------------------------------------------------
diff --git a/guide/ops/catalog/index.md b/guide/ops/catalog/index.md
index 700b24f..1997095 100644
--- a/guide/ops/catalog/index.md
+++ b/guide/ops/catalog/index.md
@@ -12,7 +12,7 @@ children:
---
-Brooklyn provides a **catalog**, which is a persisted collection of versioned blueprints and other resources.
+Apache Brooklyn provides a **catalog**, which is a persisted collection of versioned blueprints and other resources.
Blueprints in the catalog can be deployed directly, via the Brooklyn REST API or the web console,
or referenced in other blueprints using their `id`.
@@ -126,6 +126,33 @@ The following optional catalog metadata is supported:
and if entities have been deployed against that version, their behavior may change in subtle or potentially incompatible ways.
To avoid this situation, it is highly recommended to use OSGi version stamps as part of the URL.
+#### Locations in Catalog
+
+In addition to blueprints, locations can be stored in the Apache Brooklyn catalog. The example below shows a location for the vagrant configuration used in the [getting started guide]({{ site.path.guide }}/start/blueprints.html}, formatted as a catalog entry.
+
+~~~ yaml
+brooklyn.catalog:
+ id: vagrant
+ version: 1.0
+ itemType: location
+ name: Vagrant getting started location
+ item:
+ type: byon
+ brooklyn.config:
+ user: vagrant
+ password: vagrant
+ hosts:
+ - 10.10.10.101
+ - 10.10.10.102
+ - 10.10.10.103
+ - 10.10.10.104
+~~~
+
+Once this has been added to the catalog it can be used as a named location in yaml templates using:
+
+~~~ yaml
+location: vagrant
+~~~
#### Catalog YAML Examples