community.general.rpm_ostree_pkg module – Install or uninstall overlay additional packages
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.rpm_ostree_pkg
.
New in community.general 2.0.0
Synopsis
Install or uninstall overlay additional packages using
rpm-ostree
command.
Aliases: packaging.os.rpm_ostree_pkg
Parameters
Parameter |
Comments |
---|---|
Name of overlay package to install or remove. |
|
State of the overlay package.
Choices:
|
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: none |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- name: Install overlay package
community.general.rpm_ostree_pkg:
name: nfs-utils
state: present
- name: Remove overlay package
community.general.rpm_ostree_pkg:
name: nfs-utils
state: absent
# In case a different transaction is currently running the module would fail.
# Adding a delay can help mitigate this problem:
- name: Install overlay package
community.general.rpm_ostree_pkg:
name: nfs-utils
state: present
register: rpm_ostree_pkg
until: rpm_ostree_pkg is not failed
retries: 10
dealy: 30
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
Action performed. Returned: always Sample: |
|
State changes. Returned: always Sample: |
|
Full command used for performed action. Returned: always Sample: |
|
A list of packages specified. Returned: always Sample: |
|
Return code of rpm-ostree command. Returned: always Sample: |
|
Stderr of rpm-ostree command. Returned: always Sample: |
|
Stdout of rpm-ostree command. Returned: always Sample: |