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...
+# .......
+# .......