No longer run pollinate by default in seed_random

The user can still choose to run pollinate here to seed their
random data. And in an environment with network datasource, that
would be expected to work. However, we do not want to run it any
more from cloud-init because
a.) pollinate's own init system jobs should get it ran before ssh,
    which is the primary purpose of wanting cloud-init to run it.
b.) with a local datasource, there is no network guarantee when
    init_modules run, so pollinate -q would often cause issues then.
c.) cloud-init would run pollinate and log the failure causing
    many cloud-init specific failures that it could do nothing about.

Additionally, add documentation for the seed_random config module.

1 files changed, 32 insertions, 0 deletions

diff --git a/doc/examples/cloud-config-seed-random.txt b/doc/examples/cloud-config-seed-random.txt
new file mode 100644
index 00000000..08f69a9f
--- /dev/null
+++ b/doc/examples/cloud-config-seed-random.txt
@@ -0,0 +1,32 @@
+#cloud-config
+#
+# random_seed is a dictionary.
+#
+# The config module will write seed data from the datasource
+# to 'file' described below.
+#
+# Entries in this dictionary are:
+#   file:     the file to write random data to (default is /dev/urandom)
+#   data:     this data will be written to 'file' before data from
+#             the datasource
+#   encoding: this will be used to decode 'data' provided.
+#             allowed values are 'encoding', 'raw', 'base64', 'b64'
+#             'gzip', or 'gz'.  Default is 'raw'
+#
+#   command:  execute this command to seed random.
+#             the command will have RANDOM_SEED_FILE in its environment
+#             set to the value of 'file' above.
+#   command_required: default False
+#             if true, and 'command' is not available to be run
+#             then exception is raised and cloud-init will record failure.
+#             Otherwise, only debug error is mentioned.
+#
+# Note: command could be ['pollinate',
+#                         '--server=http://local.pollinate.server']
+# which would have pollinate populate /dev/urandom from provided server
+seed_random:
+  file: '/dev/urandom'
+  data: 'my random string'
+  encoding: 'raw'
+  command: ['sh', '-c', 'dd if=/dev/urandom of=$RANDOM_SEED_FILE']
+  command_required: True