Skip to content

Latest commit

 

History

History
112 lines (73 loc) · 3.02 KB

README.md

File metadata and controls

112 lines (73 loc) · 3.02 KB
Raw

enix.deb

A role for deploying and configuring deb software sources list on Debian based distributions using Ansible.

Requirements

Supported targets:

  • Ubuntu all
  • Debian all

Role Variables

This roles comes preloaded with almost every available default. You can override each one in your hosts/group vars, in your inventory, or in your play. See the annotated defaults in defaults/main.yml for help in configuration. All provided variables start with deb__.

  • deb__distribution - Distribution selected for source software installation. Default to {{ ansible_distribution }}. Options are ["Debian", "Ubuntu"].
  • deb__release - Distribution release software suite. Default to {{ ansible_distribution_release }}. Can be override for release upgrade for example.
  • deb__backports - Enable the backports repository. Only supported on stable distributions. Default: false.
  • deb__updates - Enable the updates repository. Only supported on stable distributions. Default: false.
  • deb__ubuntu_universe - Enable the universe section of Ubuntu repositories. Default: true.
  • deb__ubuntu_multiverse - Enable the multiverse section of Ubuntu repositories. Default: true.
  • deb__clean_sources - Remove existing sources. Default is false, options are ["distribution", "all"]. "distribution" clean /etc/apt/sources.list whereas "all" clean all *.list found files.
  • deb__extra_repositories - List of other repositories to add. Default: [].

Dependencies

  • None

Extra

Callable tasks:

  • update: Retrieve new list of packages (apt-get update)
  • dist-upgrade: Perform a distribution upgrade (apt-get dist-upgrade)
  • autoremove: Remove automatically all unused packages (apt-get autoremove)

Usage

Clone this repo into your roles directory:

$ git clone https://github.com/enix/ansible-deb.git roles/enix.deb

Or use Ansible galaxy requirements.yml

# deb from enix
- src: enix.deb

And add it to your play's roles:

- hosts: all
  roles:
    - role enix.deb:
        deb__backports: true
        deb__updates: true

You can also use the role as a playbook. You will be asked which hosts to provision, and you can further configure the play by using --extra-vars.

$ ansible-playbook -i inventory --extra-vars='{...}' main.yml

Still to do

  • var to disable recommends installation
  • var to add a proxy configuration
  • Add Devuan support
  • Add option to add src repositories

Changelog

1.5

Add debian 12 Bookworm support Add ubuntu 22.04 jammy support Add ubuntu 24.04 noble support

1.4

Add debian 11 bullseye support Add Ubuntu 20.04 focal support Fix handlers for newer ansible versions

1.3

Change to enix.deb role name

1.2

Change erase of sources.list into empty file installation

1.1

Add handlers flush

1.0

Initial version.

License

GPLv2

Author Information

Laurent Corbes laurent.corbes@enix.fr - http://www.enix.io