New in version 1.6.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
changed_use bool (added in 1.8) |
| Include installed packages where USE flags have changed, except when flags that the user has not enabled are added or removed (--changed-use) |
deep bool |
| Consider the entire dependency tree of packages (--deep) |
depclean bool |
| Remove packages not needed by explicitly merged packages (--depclean) If no package is specified, clean up the world's dependencies Otherwise, --depclean serves as a dependency aware version of --unmerge |
getbinpkg bool |
| Prefer packages specified at PORTAGE_BINHOST in make.conf |
jobs (added in 2.3) | Specifies the number of packages to build simultaneously. Since version 2.6: Value of 0 or False resets any previously added --jobs setting values | |
keepgoing bool (added in 2.3) |
| Continue as much as possible after an error. |
loadavg (added in 2.3) | Specifies that no new builds should be started if there are other builds running and the load average is at least LOAD Since version 2.6: Value of 0 or False resets any previously added --load-average setting values | |
newuse bool |
| Include installed packages where USE flags have changed (--newuse) |
nodeps bool |
| Only merge packages but not their dependencies (--nodeps) |
noreplace bool |
| Do not re-emerge installed packages (--noreplace) |
oneshot bool |
| Do not add the packages to the world file (--oneshot) |
onlydeps bool |
| Only merge packages' dependencies but not the packages (--onlydeps) |
package | Package atom or set, e.g. sys-apps/foo or >foo-2.13 or @world
| |
quiet bool |
| Run emerge in quiet mode (--quiet) |
quietbuild bool (added in 2.6) |
| Redirect all build output to logs alone, and do not display it on stdout (--quiet-build) |
quietfail bool (added in 2.6) |
| Suppresses display of the build log on stdout (--quiet-fail) Only the die message and the path of the build log will be displayed on stdout. |
state |
| State of the package atom |
sync |
| Sync package repositories first If yes, perform "emerge --sync" If web, perform "emerge-webrsync" |
update bool |
| Update packages to the best version available (--update) |
usepkgonly bool |
| Merge only binaries (no compiling). This sets getbinpkg=yes. |
verbose bool |
| Run emerge in verbose mode (--verbose) |
# Make sure package foo is installed - portage: package: foo state: present # Make sure package foo is not installed - portage: package: foo state: absent # Update package foo to the "latest" version ( os specific alternative to latest ) - portage: package: foo update: yes # Install package foo using PORTAGE_BINHOST setup - portage: package: foo getbinpkg: yes # Re-install world from binary packages only and do not allow any compiling - portage: package: '@world' usepkgonly: yes # Sync repositories and update world - portage: package: '@world' update: yes deep: yes sync: yes # Remove unneeded packages - portage: depclean: yes # Remove package foo if it is not explicitly needed - portage: package: foo state: absent depclean: yes
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/portage_module.html