ansible.builtin.layman (v2.9.27) — module

Manage Gentoo overlays

| "added in version" 1.6 of ansible.builtin"

Authors: Jakub Jirutka (@jirutka)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Uses Layman to manage an additional repositories for the Portage package manager on Gentoo Linux. Please note that Layman must be installed on a managed node prior using this module.


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Install the overlay 'mozilla' which is on the central overlays list.
- layman:
    name: mozilla
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Install the overlay 'cvut' from the specified alternative list.
- layman:
    name: cvut
    list_url: 'http://raw.github.com/cvut/gentoo-overlay/master/overlay.xml'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Update (sync) the overlay 'cvut', or install if not installed yet.
- layman:
    name: cvut
    list_url: 'http://raw.github.com/cvut/gentoo-overlay/master/overlay.xml'
    state: updated
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Update (sync) all of the installed overlays.
- layman:
    name: ALL
    state: updated
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Uninstall the overlay 'cvut'.
- layman:
    name: cvut
    state: absent

Inputs

    
name:
    description:
    - The overlay id to install, synchronize, or uninstall. Use 'ALL' to sync all of the
      installed overlays (can be used only when C(state=updated)).
    required: true

state:
    choices:
    - present
    - absent
    - updated
    default: present
    description:
    - Whether to install (C(present)), sync (C(updated)), or uninstall (C(absent)) the
      overlay.

list_url:
    description:
    - An URL of the alternative overlays list that defines the overlay to install. This
      list will be fetched and saved under C(${overlay_defs})/${name}.xml), where C(overlay_defs)
      is readed from the Layman's configuration.

validate_certs:
    default: 'yes'
    description:
    - If C(no), SSL certificates will not be validated. This should only be set to C(no)
      when no other option exists.  Prior to 1.9.3 the code defaulted to C(no).
    type: bool
    version_added: 1.9.3
    version_added_collection: ansible.builtin