community.general.apt_repo module – Manage APT repositories via apt-repo

Note

This module is part of the community.general collection (version 5.4.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.apt_repo.

Synopsis

Parameters

Parameter

Comments

remove_others

boolean

Remove other then added repositories

Used if state=present

Choices:

  • no ← (default)

  • yes

repo

string / required

Name of the repository to add or remove.

state

string

Indicates the desired repository state.

Choices:

  • absent

  • present ← (default)

update

boolean

Update the package database after changing repositories.

Choices:

  • no ← (default)

  • yes

Notes

Note

  • This module works on ALT based distros.

  • Does NOT support checkmode, due to a limitation in apt-repo tool.

Examples

- name: Remove all repositories
  community.general.apt_repo:
    repo: all
    state: absent

- name: Add repository `Sisysphus` and remove other repositories
  community.general.apt_repo:
    repo: Sisysphus
    state: present
    remove_others: yes

- name: Add local repository `/space/ALT/Sisyphus` and update package cache
  community.general.apt_repo:
    repo: copy:///space/ALT/Sisyphus
    state: present
    update: yes

Authors

  • Mikhail Gordeev (@obirvalger)