summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorScott Moser <smoser@ubuntu.com>2011-01-19 15:34:10 +0000
committerScott Moser <smoser@ubuntu.com>2011-01-19 15:34:10 +0000
commit32eab86a04f4f6056b200e1cfac99ec0495cd5c0 (patch)
tree90bbf92cf3a5da3255591de75f7d9ac3ac946fa8 /doc
parent738766778c88bcfe692f8df17f91c4d5c6c90cdd (diff)
downloadvyos-cloud-init-32eab86a04f4f6056b200e1cfac99ec0495cd5c0.tar.gz
vyos-cloud-init-32eab86a04f4f6056b200e1cfac99ec0495cd5c0.zip
add doc about redesigned /var/lib/cloud
Diffstat (limited to 'doc')
-rw-r--r--doc/var-lib-cloud.txt46
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/var-lib-cloud.txt b/doc/var-lib-cloud.txt
new file mode 100644
index 00000000..328edd01
--- /dev/null
+++ b/doc/var-lib-cloud.txt
@@ -0,0 +1,46 @@
+/var/lib/cloud has the following structure:
+ - scripts/
+ per-instance/
+ per-boot/
+ per-once/
+
+ files in these directories will be run by 'run-parts' once per
+ instance, once per boot, and once per *ever*.
+
+ - seed/
+ <datasource>/
+ sys-user-data
+ user-data
+ meta-data
+
+ The 'seed/' directory allows you to seed a specific datasource
+ For example, to seed the 'nocloud' datasource you would need to
+ populate
+ seed/nocloud/user-data
+ seed/nocloud/meta-data
+
+ - instance -> instances/i-abcde
+ This is a symlink to the current instance/<instance-id> directory
+ created/updated on boot
+ - instances/
+ i-abcdefgh/
+ scripts/ # all scripts in scripts are per-instance
+ sem/
+ config-puppet
+ config-ssh
+ set-hostname
+ cloud-config.txt
+ user-data.txt
+ user-data.txt.i
+ obj.pkl
+ - sem/
+ scripts.once
+ These are the cloud-specific semaphores. The only thing that
+ would go here are files to mark that a "per-once" script
+ has run.
+
+
+to clear out the current instance's data as if to force a "new run" on reboot
+do:
+ ( cd /var/lib/cloud/instance && sudo rm -Rf * )
+