status.txt 1.74 KB
Newer Older
Scott Moser's avatar
Scott Moser committed
1 2 3 4 5
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
6
 result.json
Scott Moser's avatar
Scott Moser committed
7 8 9 10 11 12 13 14 15 16

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
Scott Moser's avatar
Scott Moser committed
17 18
       start: float # time.time() that this stage started or None
       end: float # time.time() that this stage finished or None
Scott Moser's avatar
Scott Moser committed
19 20
     },
     'init-local': {
Scott Moser's avatar
Scott Moser committed
21
       'errors': [], 'start': <float>, 'end' <float> # (same as 'init' above)
Scott Moser's avatar
Scott Moser committed
22 23
     },
     'modules-config': {
Scott Moser's avatar
Scott Moser committed
24
       'errors': [], 'start': <float>, 'end' <float> # (same as 'init' above)
Scott Moser's avatar
Scott Moser committed
25 26
     },
     'modules-final': {
Scott Moser's avatar
Scott Moser committed
27
       'errors': [], 'start': <float>, 'end' <float> # (same as 'init' above)
Scott Moser's avatar
Scott Moser committed
28 29 30 31 32 33 34 35
     },
     '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.
   }

36
result.json's format is:
Scott Moser's avatar
Scott Moser committed
37
   {
38
    'v1': {
Scott Moser's avatar
Scott Moser committed
39 40
     'datasource': string describing the datasource found
     'errors': [] # list of errors reported
41
    }
Scott Moser's avatar
Scott Moser committed
42 43 44
   }

Thus, to determine if cloud-init is finished:
45
 fin = "/run/cloud-init/result.json"
Scott Moser's avatar
Scott Moser committed
46 47
 if os.path.exists(fin):
   ret = json.load(open(fin, "r"))
48 49
   if len(ret['v1']['errors']):
     print "Finished with errors:" + "\n".join(ret['v1']['errors'])
Scott Moser's avatar
Scott Moser committed
50 51 52 53
   else:
     print "Finished no errors"
 else:
   print "Not Finished"