Skip to content

Latest commit

 

History

History
156 lines (122 loc) · 6.02 KB

ansible.posix.rhel_rpm_ostree_module.rst

File metadata and controls

156 lines (122 loc) · 6.02 KB
Raw

ansible.posix.rhel_rpm_ostree

Ensure packages exist in a RHEL for Edge rpm-ostree based system

Version added: 1.5.0

Synopsis

  • Compatibility layer for using the "package" module for RHEL for Edge systems utilizing the RHEL System Roles.

Requirements

The below requirements are needed on the host that executes this module.

  • rpm-ostree

Parameters

Parameter Choices/Defaults Comments
name
list / elements=string
Default:
[]
A package name or package specifier with version, like name-1.0.
Comparison operators for package version are valid here >, <, >=, <=. Example - name>=1.0
If a previous version is specified, the task also needs to turn allow_downgrade on. See the allow_downgrade documentation for caveats with downgrading packages.
When using state=latest, this can be '*' which means run yum -y update.
You can also pass a url or a local path to a rpm file (using state=present). To operate on several packages this can accept a comma separated string of packages or (as of 2.0) a list of packages.

aliases: pkg
state
string
    Choices:
  • absent
  • installed
  • latest
  • present
  • removed
Whether to install (present or installed, latest), or remove (absent or removed) a package.
present and installed will simply ensure that a desired package is installed.
latest will update the specified package if it's not of the latest available version.
absent and removed will remove the specified package.
Default is None, however in effect the default action is present unless the autoremove option is enabled for this module, then absent is inferred.

Notes

Note

- This module does not support installing or removing packages to/from an overlay as this is not supported by RHEL for Edge, packages needed should be defined in the osbuild Blueprint and provided to Image Builder at build time. This module exists only for package module compatibility.

Examples

- name: Ensure htop and ansible are installed on rpm-ostree based RHEL
  ansible.posix.rhel_rpm_ostree:
    name:
      - htop
      - ansible
    state: present

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
msg
string
always
status of rpm transaction

Sample:
No changes made.


Status

Authors

  • Adam Miller (@maxamillion)