summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoshua Harlow <harlowja@yahoo-inc.com>2012-08-31 18:22:01 -0700
committerJoshua Harlow <harlowja@yahoo-inc.com>2012-08-31 18:22:01 -0700
commitc2e5c6fd4dc917d2d4fb23569b1615b76c695201 (patch)
tree1c28acc2a028d9d181cd221171657ed05f5b967d
parent1d67756be9e768ff9f55e7322c1ab3a6b5cdec34 (diff)
downloadvyos-cloud-init-c2e5c6fd4dc917d2d4fb23569b1615b76c695201.tar.gz
vyos-cloud-init-c2e5c6fd4dc917d2d4fb23569b1615b76c695201.zip
Add some examples on how to use the new launch-index
support in a cloud-archive format as well as a cloud-config format and explain how this will affect the final userdata available to an instance.
-rw-r--r--doc/examples/cloud-config-archive-launch-index.txt30
-rw-r--r--doc/examples/cloud-config-launch-index.txt23
2 files changed, 53 insertions, 0 deletions
diff --git a/doc/examples/cloud-config-archive-launch-index.txt b/doc/examples/cloud-config-archive-launch-index.txt
new file mode 100644
index 00000000..e2ac2869
--- /dev/null
+++ b/doc/examples/cloud-config-archive-launch-index.txt
@@ -0,0 +1,30 @@
+#cloud-config-archive
+
+# This is an example of a cloud archive
+# format which includes a set of launch indexes
+# that will be filtered on (thus only showing
+# up in instances with that launch index), this
+# is done by adding the 'launch-index' key which
+# maps to the integer 'launch-index' that the
+# corresponding content should be used with.
+#
+# It is possible to leave this value out which
+# will mean that the content will be applicable
+# for all instances
+
+- type: foo/wark
+ filename: bar
+ content: |
+ This is my payload
+ hello
+ launch-index: 1 # I will only be used on launch-index 1
+- this is also payload
+- |
+ multi line payload
+ here
+-
+ type: text/upstart-job
+ filename: my-upstart.conf
+ content: |
+ whats this, yo?
+ launch-index: 0 # I will only be used on launch-index 0
diff --git a/doc/examples/cloud-config-launch-index.txt b/doc/examples/cloud-config-launch-index.txt
new file mode 100644
index 00000000..e7dfdc0c
--- /dev/null
+++ b/doc/examples/cloud-config-launch-index.txt
@@ -0,0 +1,23 @@
+#cloud-config
+# vim: syntax=yaml
+
+#
+# This is the configuration syntax that can be provided to have
+# a given set of cloud config data show up on a certain launch
+# index (and not other launches) by provided a key here which
+# will act as a filter on the instances userdata. When
+# this key is left out (or non-integer) then the content
+# of this file will always be used for all launch-indexes
+# (ie the previous behavior).
+launch-index: 5
+
+# Upgrade the instance on first boot
+# (ie run apt-get upgrade)
+#
+# Default: false
+#
+apt_upgrade: true
+
+# Other yaml keys below...
+# .......
+# .......