Dnf Operations

Manage dnf packages and repositories. Note that dnf package names are case-sensitive.

dnf.key

Add dnf gpg keys with rpm.

dnf.key(src)

• key: filename or URL

Note:

always returns one command, not idempotent

Example:

linux_id = host.get_fact(LinuxDistribution)['release_meta'].get('ID')
dnf.key(
    name='Add the Docker CentOS gpg key',
    src='https://download.docker.com/linux/{}/gpg'.format(linux_id),
)

dnf.packages

Install/remove/update dnf packages & updates.

dnf.packages(
    packages=None, present=True, latest=False, update=False, clean=False, nobest=False,
    extra_install_args=None, extra_uninstall_args=None,
)

• packages: list of packages to ensure
• present: whether the packages should be installed
• latest: whether to upgrade packages without a specified version
• update: run dnf update before installing packages
• clean: run dnf clean before installing packages
• nobest: add the no best option to install
• extra_install_args: additional arguments to the dnf install command
• extra_uninstall_args: additional arguments to the dnf uninstall command

Versions:

Package versions can be pinned as follows: <pkg>=<version>

Examples:

# Update package list and install packages
dnf.packages(
    name='Install Vim and Vim enhanced',
    packages=['vim-enhanced', 'vim'],
    update=True,
)

# Install the latest versions of packages (always check)
dnf.packages(
    name='Install latest Vim',
    packages=['vim'],
    latest=True,
)

dnf.repo

Add/remove/update dnf repositories.

dnf.repo(
    src, present=True, baseurl=None, description=None, enabled=True, gpgcheck=True,
    gpgkey=None,
)

• name: URL or name for the .repo file
• present: whether the .repo file should be present
• baseurl: the baseurl of the repo (if name is not a URL)
• description: optional verbose description
• enabled: whether this repo is enabled
• gpgcheck: whether set gpgcheck=1
• gpgkey: the URL to the gpg key for this repo

Baseurl/description/gpgcheck/gpgkey:

These are only valid when name is a filename (ie not a URL). This is for manual construction of repository files. Use a URL to download and install remote repository files.

Examples:

# Download a repository file
dnf.rpm(
    name='Install Docker-CE repo via URL',
    src='https://download.docker.com/linux/centos/docker-ce.repo',
)

# Create the repository file from baseurl/etc
dnf.repo(
    name='Add the Docker CentOS repo',
    src='DockerCE',
    baseurl='https://download.docker.com/linux/centos/7/$basearch/stable',
)

dnf.rpm

Add/remove .rpm file packages.

dnf.rpm(src, present=True)

• src: filename or URL of the .rpm package
• present: whether ore not the package should exist on the system

URL sources with present=False:

If the .rpm file isn’t downloaded, pyinfra can’t remove any existing package as the file won’t exist until mid-deploy.

Example:

major_centos_version = host.get_fact(LinuxDistribution)['major']
dnf.rpm(
   name='Install EPEL rpm to enable EPEL repo',
   src='https://dl.fedoraproject.org/pub/epel/epel-release-latest-{}.noarch.rpm'.format(major_centos_version),
)

dnf.update

Updates all dnf packages.

dnf.update()