almalinux/lorax
13
0
Fork 0
Code Issues Pull Requests Releases Activity

Update customizations.services documentation

Browse Source 
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 commit 4f701e7e92)
(cherry picked from commit 80281c7ad4)
This commit is contained in:
Brian C. Lane 2019-04-17 09:38:59 -07:00
parent 0945c9b81f
commit 36ba09345b
1 changed files with 8 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/lorax-composer.rst
View File

@ -315,25 +315,20 @@ This cannot be overridden by the blueprint.
[customizations.services] [customizations.services]
************************* *************************
This section can be used to control which services are enabled at boot time. Some image types This section can be used to control which services are enabled at boot time.
already have services enabled or disabled in order for the image to work correctly, and cannot Some image types already have services enabled or disabled in order for the
be overridden. eg. ``ami`` requires ``sshd``, ``chronyd``, and ``cloud-init``. Without them the image will image to work correctly, and cannot be overridden. eg. ``ami`` requires
not boot. ``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 The service names are systemd service units. You may specify any systemd unit
enabled or disabled. Other releases may specify any systemd unit file, eg. ``cockpit.socket`` file accepted by ``systemctl enable`` eg. ``cockpit.socket``::
[customizations.services] [customizations.services]
enabled = ["sshd", "cockpit.socket", "httpd"] enabled = ["sshd", "cockpit.socket", "httpd"]
disabled = ["postfix", "telnetd"] 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]] [[repos.git]]
~~~~~~~~~~~~~ ~~~~~~~~~~~~~