update documentation for seed data

3 files changed, 25 insertions, 0 deletions

diff --git a/doc/examples/seed/README b/doc/examples/seed/README
new file mode 100644
index 00000000..927768f8
--- /dev/null
+++ b/doc/examples/seed/README
@@ -0,0 +1,22 @@
+This directory is an example of a 'seed' directory.
+
+
+copying these files inside an instance's
+  /var/lib/cloud/data/cache/nocloud
+or
+  /var/lib/cloud/data/cache/nocloud-net
+
+will cause the 'DataSourceNoCloud' and 'DataSourceNoCloudNet' modules
+to enable and read the given data.
+
+The directory must have both files.
+
+- user-data:
+  This is the user data, as would be consumed from ec2's metadata service
+  see examples in doc/examples.
+- meta-data:
+  This file is yaml formated data similar to what is in the ec2 metadata
+  service under meta-data/.  See the example, or, on an ec2 instance,
+  run:
+     python -c 'import boto.utils, yaml; print(
+        yaml.dump(boto.utils.get_instance_metadata()))'
diff --git a/doc/examples/preseed-metadata.txt b/doc/examples/seed/meta-data
index d0551448..d0551448 100644
--- a/doc/examples/preseed-metadata.txt
+++ b/doc/examples/seed/meta-data
diff --git a/doc/examples/seed/user-data b/doc/examples/seed/user-data
new file mode 100644
index 00000000..2bc87c0b
--- /dev/null
+++ b/doc/examples/seed/user-data
@@ -0,0 +1,3 @@
+#cloud-config
+runcmd:
+ - [ sh, -c, 'echo ==== $(date) ====; echo HI WORLD; echo =======' ]