History

Mathieu Trossevin 7c632352a0 Replace the `include` module with `include_tasks` or `import_tasks` The behaviour of the `include` module is badly defined (it try to choose between statically importing the tasks and dynamically including them) and can cause problems depending on any number of constraints (mostly if it choose the wrong behaviour). Replace it with the `import_tasks` (always statically import tasks) unless the `include` is in a loop in which case we replace it with `include_tasks` (always dynamically include tasks).		2023-01-03 14:43:42 +01:00
..
defaults	Use proper keyrings directory for APT version	2022-11-02 23:16:32 +01:00
files	apt_hold_packages: broadcast message with wall, if present	2022-02-24 11:49:12 +01:00
meta	Update Galaxy metadata (company, platforms and galaxy_tags)	2021-06-28 15:26:28 +02:00
tasks	Replace the `include` module with `include_tasks` or `import_tasks`	2023-01-03 14:43:42 +01:00
templates	Use bullseye suite even for bookworm	2022-11-06 15:25:17 +01:00
tests	Rename role "apt-repositories" to "apt"	2017-07-19 08:56:46 +02:00
.kitchen.yml	Rename role "apt-repositories" to "apt"	2017-07-19 08:56:46 +02:00
README.md	apt: add a script to manage packages with "hold" mark	2019-05-13 17:48:55 +02:00

README.md

apt

A few APT related operations, like easily install backports of change components for repositories.

Tasks

Tasks are extracted in several files, included in tasks/main.yml :

backports.yml : add a sources list for backports ;
basics_components.yml : replace components for the basic sources ;
hold_packages.yml : install script to automatically hold packages.

Available variables

apt_config : customize apt configuration (default: True) ;
apt_install_basics : change basic sources components (default: True) ;
apt_basics_components : basic sources components (default: main) ;
apt_install_backports : install backports sources (default: False) ;
apt_backports_components : backports sources (default: main) ;
apt_install_evolix_public : install Evolix public repositories (default: True) ;
apt_install_hold_packages : install script to automatically hold packages (default: True).
apt_hold_packages: list of packages that must have a "hold" mark (default: [])
apt_unhold_packages: list of packages that must not have a "hold" mark (default: [])

Examples

To add "non-free" and "contrib" components to basic sources lists :

{ role: apt,
    apt_install_basics: True,
    apt_basics_components: "main non-free contrib"
}

To install backports sources lists :

{ role: apt,
    apt_install_backports: True
}

To install backports sources lists with "non-free" and "contrib" :

{ role: apt,
    apt_install_backports: True,
    apt_backports_components: "main non-free contrib"
}

To install backports sources lists and have "non-free" and "contrib" for each repository :

{ role: apt,
    apt_install_basics: True,
    apt_basics_components: "main non-free contrib",
    apt_install_backports: True,
    apt_backports_components: "main non-free contrib"
}