This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git
The following commit(s) were added to refs/heads/master by this push:
new 6fc75011 add notes on BYON locations being stateful, IPs for use by
one entity at a time
6fc75011 is described below
commit 6fc75011c4cbb10b6788fb9315d567bf19fd8f8f
Author: Alex Heneveld <[email protected]>
AuthorDate: Tue Dec 6 16:53:58 2022 +0000
add notes on BYON locations being stateful, IPs for use by one entity at a
time
---
guide/locations/_byon.md | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/guide/locations/_byon.md b/guide/locations/_byon.md
index 4547f3fb..4b2e1dff 100644
--- a/guide/locations/_byon.md
+++ b/guide/locations/_byon.md
@@ -27,6 +27,15 @@ location:
- 192.168.0.19
{% endhighlight %}
+This location acts like a cloud location or a pool of servers
+in that each entry in the `hosts` list is only allowed
+to be provisioned by one entity at a time.
+If two entities should share a host, they should be children of an entity
which provisions the host,
+or if a host should be allowed to be used multiple times, its IP should be
listed multiple times.
+When an entity releases an IP address from the list, that entry is again
available for other entities.
+If more entities try to provision machines from this location than there are
IP addresses listed,
+the BYON location will throw a `NoMachinesAvailableException`.
+
Some of the login properties as described above for jclouds are supported,
but not `loginUser` (as no users are created), and not any of the
VM creation parameters such as `minRam` and `imageId`.
