Update docs for new timezone section

(cherry picked from commit 2929deaf01)

Related: rhbz#1718473
This commit is contained in:
Brian C. Lane 2019-04-10 09:14:33 -07:00 committed by Alexander Todorov
parent 956ebfc77c
commit 5d307a475d

View File

@ -172,16 +172,12 @@ for selecting optional packages.
Customizations Customizations
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
The ``[customizations]`` section can be used to configure the hostname, The ``[customizations]`` section can be used to configure the hostname of the final image. eg.::
language, and timezone of the final image. eg.::
[customizations] [customizations]
hostname = "baseimage" hostname = "baseimage"
timezone = "US/Eastern"
These are all optional and may be left out to use the defaults. This is optional and may be left out to use the defaults.
The values supported by ``timezone`` can be listed by running ``timedatectl list-timezones``.
[customizations.kernel] [customizations.kernel]
@ -239,9 +235,27 @@ Add a group to the image. ``name`` is required and ``gid`` is optional::
gid = 1130 gid = 1130
[customizations.locale] [customizations.timezone]
************************* *************************
Customizing the timezone and the NTP servers to use for the system::
[customizations.timezone]
timezone = "US/Eastern"
ntpservers = ["0.north-america.pool.ntp.org", "1.north-america.pool.ntp.org"]
The values supported by ``timezone`` can be listed by running ``timedatectl list-timezones``.
If no timezone is setup the system will default to using `UTC`. The ntp servers are also
optional and will default to using the distribution defaults which are fine for most uses.
In some image types there are already NTP servers setup, eg. Google cloud image, and they
cannot be overridden because they are required to boot in the selected environment. But the
timezone will be updated to the one selected in the blueprint.
[[customizations.locale]]
Customize the locale settings for the system:: Customize the locale settings for the system::
[[customizations.locale]] [[customizations.locale]]
@ -254,6 +268,10 @@ the command line.
The values supported by ``keyboard`` can be listed by running ``localectl list-keymaps`` from The values supported by ``keyboard`` can be listed by running ``localectl list-keymaps`` from
the command line. the command line.
Multiple locale and keyboard sections can be used. The first one becomes the
primary, and the others are added as secondary. One or the other of ``language``
or ``keyboard`` must be included (or both).
[customizations.firewall] [customizations.firewall]
************************* *************************