/ home / community / community.general / 8.5.0 / module / layman

community.general.layman (8.5.0) — module

Manage Gentoo overlays

Authors: Jakub Jirutka (@jirutka)

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

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

layman python module

Usage examples

Scanned by Steampunk Spotter

- name: Install the overlay mozilla which is on the central overlays list
  community.general.layman:
    name: mozilla

Scanned by Steampunk Spotter

- name: Install the overlay cvut from the specified alternative list
  community.general.layman:
    name: cvut
    list_url: 'http://raw.github.com/cvut/gentoo-overlay/master/overlay.xml'

Scanned by Steampunk Spotter

- name: Update (sync) the overlay cvut or install if not installed yet
  community.general.layman:
    name: cvut
    list_url: 'http://raw.github.com/cvut/gentoo-overlay/master/overlay.xml'
    state: updated

Scanned by Steampunk Spotter

- name: Update (sync) all of the installed overlays
  community.general.layman:
    name: ALL
    state: updated

Scanned by Steampunk Spotter

- name: Uninstall the overlay cvut
  community.general.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 O(state=updated)).
    required: true
    type: str

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

list_url:
    aliases:
    - 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 read from the Layman's configuration.
    type: str

validate_certs:
    default: true
    description:
    - If V(false), SSL certificates will not be validated. This should only be set to
      V(false) when no other option exists.  Prior to 1.9.3 the code defaulted to V(false).
    type: bool