Source code for saltext.apache.states.apache_conf

"""
Manage Apache Confs

.. versionadded:: 2016.3.0

Enable and disable apache confs.

.. code-block:: yaml

    Enable security conf:
      apache_conf.enabled:
        - name: security

    Disable security conf:
      apache_conf.disabled:
        - name: security
"""

import salt.utils.path


[docs] def __virtual__(): """ Only load if a2enconf is available. """ if "apache.a2enconf" in __salt__ and salt.utils.path.which("a2enconf"): return "apache_conf" return (False, "apache module could not be loaded")
[docs] def enabled(name): """ Ensure an Apache conf is enabled. name Name of the Apache conf """ ret = {"name": name, "result": True, "comment": "", "changes": {}} is_enabled = __salt__["apache.check_conf_enabled"](name) if not is_enabled: if __opts__["test"]: msg = f"Apache conf {name} is set to be enabled." ret["comment"] = msg ret["changes"]["old"] = None ret["changes"]["new"] = name ret["result"] = None return ret status = __salt__["apache.a2enconf"](name)["Status"] if isinstance(status, str) and "enabled" in status: ret["result"] = True ret["changes"]["old"] = None ret["changes"]["new"] = name else: ret["result"] = False ret["comment"] = f"Failed to enable {name} Apache conf" if isinstance(status, str): ret["comment"] = ret["comment"] + f" ({status})" return ret else: ret["comment"] = f"{name} already enabled." return ret
[docs] def disabled(name): """ Ensure an Apache conf is disabled. name Name of the Apache conf """ ret = {"name": name, "result": True, "comment": "", "changes": {}} is_enabled = __salt__["apache.check_conf_enabled"](name) if is_enabled: if __opts__["test"]: msg = f"Apache conf {name} is set to be disabled." ret["comment"] = msg ret["changes"]["old"] = name ret["changes"]["new"] = None ret["result"] = None return ret status = __salt__["apache.a2disconf"](name)["Status"] if isinstance(status, str) and "disabled" in status: ret["result"] = True ret["changes"]["old"] = name ret["changes"]["new"] = None else: ret["result"] = False ret["comment"] = f"Failed to disable {name} Apache conf" if isinstance(status, str): ret["comment"] = ret["comment"] + f" ({status})" return ret else: ret["comment"] = f"{name} already disabled." return ret