Update customizations.services documentation
Make it clear that the services are added to services already listed in the image templates, and that you can specify any systemd unit filename. Older releases are more restrictive, and this documentation will need to be updated when these changes are backported. (cherry picked from commit4f701e7e92
) (cherry picked from commit80281c7ad4
)
This commit is contained in:
parent
0945c9b81f
commit
36ba09345b
@ -315,25 +315,20 @@ This cannot be overridden by the blueprint.
|
||||
[customizations.services]
|
||||
*************************
|
||||
|
||||
This section can be used to control which services are enabled at boot time. Some image types
|
||||
already have services enabled or disabled in order for the image to work correctly, and cannot
|
||||
be overridden. eg. ``ami`` requires ``sshd``, ``chronyd``, and ``cloud-init``. Without them the image will
|
||||
not boot.
|
||||
This section can be used to control which services are enabled at boot time.
|
||||
Some image types already have services enabled or disabled in order for the
|
||||
image to work correctly, and cannot be overridden. eg. ``ami`` requires
|
||||
``sshd``, ``chronyd``, and ``cloud-init``. Without them the image will not
|
||||
boot. Blueprint services are added to, not replacing, the list already in the
|
||||
templates, if any.
|
||||
|
||||
The service names are systemd service units. On RHEL7 only ``.service`` units can be
|
||||
enabled or disabled. Other releases may specify any systemd unit file, eg. ``cockpit.socket``
|
||||
The service names are systemd service units. You may specify any systemd unit
|
||||
file accepted by ``systemctl enable`` eg. ``cockpit.socket``::
|
||||
|
||||
[customizations.services]
|
||||
enabled = ["sshd", "cockpit.socket", "httpd"]
|
||||
disabled = ["postfix", "telnetd"]
|
||||
|
||||
.. warning::
|
||||
|
||||
The service must be installed, otherwise systemd will fail when trying to enable or disable
|
||||
the nonexistant service.
|
||||
|
||||
TODO -- Confirm this is still true and if not, on which releases
|
||||
|
||||
|
||||
[[repos.git]]
|
||||
~~~~~~~~~~~~~
|
||||
|
Loading…
Reference in New Issue
Block a user