Skip to content

ENT-11784: Added dnf package module documation (3.27) #3591

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nickanderson merged 2 commits into from
Feb 5, 2026
Merged

ENT-11784: Added dnf package module documation (3.27) #3591

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
21595d0
Added documentation for dnf package module
nickanderson Feb 3, 2026
096e8bd
Added missing introduction version in dnf module history
nickanderson Feb 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 73 additions & 2 deletions content/reference/promise-types/packages.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -371,7 +371,7 @@ packages:

Enable a specific repository for a specific promise.

```cf3
```cf3 {skip TODO}
bundle agent example
{
packages:
Expand All @@ -391,7 +391,7 @@ bundle agent example
"httpd"
policy => "present",
version => "latest",
options => { "disablerepo=* enablerepo=UPDATES" };
options => { "disablerepo=*", "enablerepo=UPDATES" };
}
```

Expand Down Expand Up @@ -443,6 +443,77 @@ bundle agent example
- Added in CFEngine 3.7.0
- `enablerepo` and `disablerepo` option support added in 3.7.8, 3.10.4, 3.12.0

### dnf

Manage packages using `dnf`. This is the [default package module][lib/packages.cf#package_module_knowledge] for modern Red Hat, CentOS, Fedora, and Amazon Linux systems.

**Examples:**

File based package source.

```cf3 {skip TODO}
packages:
redhat|centos|amazon_linux::
"/mnt/nfs/packages/httpd-2.4.37-65.module+el8.10.0+40053+5a18018e.7.x86_64.rpm"
policy => "present";
```

Repository based package source with a specific version of the package.

```cf3 {skip TODO}
packages:
(redhat|centos|amazon_linux).workstation::
"emacs"
policy => "present",
version => "26.1-13";
```

Enable a specific repository for a specific promise.

```cf3
bundle agent example
{
packages:

rocky_8::
# Enable the EPEL repo when making sure etc-keeper is installed
# and up to date.

"etckeeper-dnf"
policy => "present",
version => "latest",
options => { "enablerepo=powertools" };

# Only consider updates from the main repositories for
# httpd and disable all other repositories

"httpd"
policy => "present",
version => "latest",
options => { "disablerepo=*", "enablerepo=UPDATES" };
}
```

**Notes:**

- Supports file path and repository sourced packages.

- Requires Python 3 to be installed on the host (leverages cfengine-selected-python).

- Package downgrades default to the system configuration (typically disabled). To explicitly allow the module to downgrade a package for a specific promise, set `options => { "allow_downgrade=true" }`.

```cf3 {skip TODO}
packages:
"httpd"
policy => "present",
version => "2.4.37-64", # Older version
options => { "allow_downgrade=true" };
```

**History:**

- Added in CFEngine 3.28.0, 3.27.1, 3.24.4

### apt_get

Manage packages using `apt-get`.
Expand Down