From d1e26fc118cdb641829fbe6b838ef46d4ab1f113 Mon Sep 17 00:00:00 2001 From: Kiril Vladimiroff Date: Wed, 19 Feb 2014 10:45:53 +0200 Subject: Read encoded with base64 user data This allows users of CloudSigma's VM to encode their user data with base64. In order to do that thet have to add the ``cloudinit-user-data`` field to the ``base64_fields``. The latter is a comma-separated field with all the meta fields whit base64 encoded values. --- doc/sources/cloudsigma/README.rst | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'doc') diff --git a/doc/sources/cloudsigma/README.rst b/doc/sources/cloudsigma/README.rst index 1d9160a2..6509b585 100644 --- a/doc/sources/cloudsigma/README.rst +++ b/doc/sources/cloudsigma/README.rst @@ -23,6 +23,10 @@ You can provide user-data to the VM using the dedicated `meta field`_ in the `se header could be omitted. However since this is a raw-text field you could provide any of the valid `config formats`_. +You have the option to encode your user-data using Base64. In order to do that you have to add the +``cloudinit-user-data`` field to the ``base64_fields``. The latter is a comma-separated field with +all the meta fields whit base64 encoded values. + If your user-data does not need an internet connection you can create a `meta field`_ in the `server context`_ ``cloudinit-dsmode`` and set "local" as value. If this field does not exist the default value is "net". -- cgit v1.2.3 From 16f95094209faeb7f6fcdb0d9ac498360e7a3e42 Mon Sep 17 00:00:00 2001 From: Scott Moser Date: Mon, 24 Feb 2014 20:23:59 -0500 Subject: add doc/status.txt --- doc/status.txt | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 doc/status.txt (limited to 'doc') diff --git a/doc/status.txt b/doc/status.txt new file mode 100644 index 00000000..9c2f4b89 --- /dev/null +++ b/doc/status.txt @@ -0,0 +1,51 @@ +cloud-init will keep a 'status' file up to date for other applications +wishing to use it to determine cloud-init status. + +It will manage 2 files: + status.json + finished.json + +The files will be written to /var/lib/cloud/data/ . +A symlink will be created in /run/cloud-init. The link from /run is to ensure +that if the file exists, it is not stale for this boot. + +status.json's format is: + { + 'v1': { + 'init': { + errors: [] # list of strings for each error that occurred + start: integer # time.time() that this stage started or None + end: integer # time.time() that this stage finished or None + }, + 'init-local': { + 'errors': [], 'start': , 'end' # (same as 'init' above) + }, + 'modules-config': { + 'errors': [], 'start': , 'end' # (same as 'init' above) + }, + 'modules-final': { + 'errors': [], 'start': , 'end' # (same as 'init' above) + }, + 'datasource': string describing datasource found or None + 'stage': string representing stage that is currently running + ('init', 'init-local', 'modules-final', 'modules-config', None) + if None, then no stage is running. Reader must read the start/end + of each of the above stages to determine the state. + } + +finished.json's format is: + { + 'datasource': string describing the datasource found + 'errors': [] # list of errors reported + } + +Thus, to determine if cloud-init is finished: + fin = "/run/cloud-init/finished.json" + if os.path.exists(fin): + ret = json.load(open(fin, "r")) + if len(ret): + print "Finished with errors:" + "\n".join(ret['errors']) + else: + print "Finished no errors" + else: + print "Not Finished" -- cgit v1.2.3 From 4055b6d303da775580ab299145788c0cd16c0d45 Mon Sep 17 00:00:00 2001 From: Scott Moser Date: Mon, 24 Feb 2014 20:27:03 -0500 Subject: fix end/start in doc --- doc/status.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'doc') diff --git a/doc/status.txt b/doc/status.txt index 9c2f4b89..5958fa85 100644 --- a/doc/status.txt +++ b/doc/status.txt @@ -14,17 +14,17 @@ status.json's format is: 'v1': { 'init': { errors: [] # list of strings for each error that occurred - start: integer # time.time() that this stage started or None - end: integer # time.time() that this stage finished or None + start: float # time.time() that this stage started or None + end: float # time.time() that this stage finished or None }, 'init-local': { - 'errors': [], 'start': , 'end' # (same as 'init' above) + 'errors': [], 'start': , 'end' # (same as 'init' above) }, 'modules-config': { - 'errors': [], 'start': , 'end' # (same as 'init' above) + 'errors': [], 'start': , 'end' # (same as 'init' above) }, 'modules-final': { - 'errors': [], 'start': , 'end' # (same as 'init' above) + 'errors': [], 'start': , 'end' # (same as 'init' above) }, 'datasource': string describing datasource found or None 'stage': string representing stage that is currently running -- cgit v1.2.3