From 4f701e7e9215eb4bdb0535b2a92925704d54e053 Mon Sep 17 00:00:00 2001 From: "Brian C. Lane" Date: Wed, 17 Apr 2019 09:38:59 -0700 Subject: [PATCH] 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. --- docs/lorax-composer.rst | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/lorax-composer.rst b/docs/lorax-composer.rst index 043c273e..cf466ff9 100644 --- a/docs/lorax-composer.rst +++ b/docs/lorax-composer.rst @@ -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]] ~~~~~~~~~~~~~