salt.states.dnfmodule#

Management of DNF modules (modularity / AppStreams)

This state manages DNF modularity (AppStream) module streams on RHEL 8/9 and derivatives, using the dnfmodule execution module.

nodejs:18:
  dnfmodule.enabled

install_postgresql:
  dnfmodule.installed:
    - name: postgresql:15/client

New in version 3008.0.

salt.states.dnfmodule.disabled(name)#

Ensure that the named module is disabled.

name

The module name to disable, e.g. nodejs.

salt.states.dnfmodule.enabled(name, switch=False)#

Ensure that the named module stream is enabled.

name

The module name with the stream to enable, e.g. nodejs:18. If no stream is given, the module's default stream is enabled.

switch

DNF refuses to enable a stream while a different stream of the same module is already enabled. When False (the default) this state fails with a clear message describing the conflict. When True the module is first reset and the requested stream is then enabled, switching the enabled stream.

Note

Switching streams does not remove packages that were installed from the previously enabled stream; reset/switch only changes which stream is enabled.

salt.states.dnfmodule.installed(name)#

Ensure that the named module profile is installed. Installing a profile also enables the corresponding stream if it is not already enabled.

name

The module to install, optionally with a stream and/or profile, e.g. nodejs:18 or nodejs:18/common.

salt.states.dnfmodule.removed(name)#

Ensure that the named module profile is not installed. The module's stream remains enabled; use disabled() to change the stream state.

name

The module to remove, optionally with a stream and/or profile.