diff options
| author | Chad Smith <chad.smith@canonical.com> | 2018-07-09 20:13:47 +0000 |
|---|---|---|
| committer | Server Team CI Bot <josh.powers+server-team-bot@canonical.com> | 2018-07-09 20:13:47 +0000 |
| commit | 2e62cb8a6406309cbeb5f8d2aa00fb30e72e1cfc (patch) | |
| tree | d4ed2a20225ae9688a91e131c173a7eca17c8853 /cloudinit | |
| parent | c1a75a697d7cb2e6c97ad90d64c9b2b88db2034a (diff) | |
| download | vyos-cloud-init-2e62cb8a6406309cbeb5f8d2aa00fb30e72e1cfc.tar.gz vyos-cloud-init-2e62cb8a6406309cbeb5f8d2aa00fb30e72e1cfc.zip | |
docs: note in rtd about avoiding /tmp when writing files
LP: #1727876
Diffstat (limited to 'cloudinit')
| -rw-r--r-- | cloudinit/config/cc_bootcmd.py | 8 | ||||
| -rw-r--r-- | cloudinit/config/cc_runcmd.py | 5 | ||||
| -rw-r--r-- | cloudinit/config/cc_write_files.py | 5 |
3 files changed, 17 insertions, 1 deletions
diff --git a/cloudinit/config/cc_bootcmd.py b/cloudinit/config/cc_bootcmd.py index db64f0a6..6813f534 100644 --- a/cloudinit/config/cc_bootcmd.py +++ b/cloudinit/config/cc_bootcmd.py @@ -42,7 +42,13 @@ schema = { .. note:: bootcmd should only be used for things that could not be done later - in the boot process."""), + in the boot process. + + .. note:: + + when writing files, do not use /tmp dir as it races with + systemd-tmpfiles-clean LP: #1707222. Use /run/somedir instead. + """), 'distros': distros, 'examples': [dedent("""\ bootcmd: diff --git a/cloudinit/config/cc_runcmd.py b/cloudinit/config/cc_runcmd.py index b6f6c807..1f75d6c5 100644 --- a/cloudinit/config/cc_runcmd.py +++ b/cloudinit/config/cc_runcmd.py @@ -42,6 +42,11 @@ schema = { all commands must be proper yaml, so you have to quote any characters yaml would eat (':' can be problematic) + + .. note:: + + when writing files, do not use /tmp dir as it races with + systemd-tmpfiles-clean LP: #1707222. Use /run/somedir instead. """), 'distros': distros, 'examples': [dedent("""\ diff --git a/cloudinit/config/cc_write_files.py b/cloudinit/config/cc_write_files.py index 1b7e7e30..31d1db61 100644 --- a/cloudinit/config/cc_write_files.py +++ b/cloudinit/config/cc_write_files.py @@ -18,6 +18,11 @@ binary gzip data can be specified and will be decoded before being written. follows yaml formatting standards. to specify binary data, use the yaml option ``!!binary`` +.. note:: + Do not write files under /tmp during boot because of a race with + systemd-tmpfiles-clean that can cause temp files to get cleaned during + the early boot process. Use /run/somedir instead to avoid race LP:1707222. + **Internal name:** ``cc_write_files`` **Module frequency:** per instance |