/ home / community / community.general / 2.5.9 / module / layman

community.general.layman (2.5.9) — module

Manage Gentoo overlays

Authors: Jakub Jirutka (@jirutka)

Install collection

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

Add to requirements.yml

  collections:
    - name: community.general
      version: 2.5.9

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

python >= 2.6
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 C(state=updated)).
    required: true
    type: str

state:
    choices:
    - present
    - absent
    - updated
    default: present
    description:
    - Whether to install (C(present)), sync (C(updated)), or uninstall (C(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 readed from the Layman's configuration.
    type: str

validate_certs:
    default: true
    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