You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

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

Note

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

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

• Manages APT repositories using apt-repo tool.

• See https://www.altlinux.org/Apt-repo for details about apt-repo

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)

Collection links

Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication