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.zypper_repository – Add and remove Zypper repositories

Note

This plugin is part of the community.general collection (version 3.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.zypper_repository.

Synopsis

• Add or remove Zypper repositories on SUSE and openSUSE

Requirements

The below requirements are needed on the host that executes this module.

• zypper >= 1.0 # included in openSUSE >= 11.1 or SUSE Linux Enterprise Server/Desktop >= 11.0

• python-xml

Parameters

Parameter	Comments
auto_import_keys boolean	Automatically import the gpg signing key of the new or changed repository. Has an effect only if state is present. Has no effect on existing (unchanged) repositories or in combination with absent. Implies runrefresh. Only works with .repo files if name is given explicitly. Choices: no ← (default) yes
autorefresh aliases: refresh boolean	Enable autorefresh of the repository. Choices: no yes ← (default)
description string	A description of the repository
disable_gpg_check boolean	Whether to disable GPG signature checking of all packages. Has an effect only if state is present. Needs zypper version >= 1.6.2. Choices: no ← (default) yes
enabled boolean	Set repository to enabled (or disabled). Choices: no yes ← (default)
name string	A name for the repository. Not required when adding repofiles.
overwrite_multiple boolean	Overwrite multiple repository entries, if repositories with both name and URL already exist. Choices: no ← (default) yes
priority integer	Set priority of repository. Packages will always be installed from the repository with the smallest priority number. Needs zypper version >= 1.12.25.
repo string	URI of the repository or .repo file. Required when state=present.
runrefresh boolean	Refresh the package list of the given repository. Can be used with repo=* to refresh all repositories. Choices: no ← (default) yes
state string	A source string state. Choices: absent present ← (default)

Examples

- name: Add NVIDIA repository for graphics drivers
  community.general.zypper_repository:
    name: nvidia-repo
    repo: 'ftp://download.nvidia.com/opensuse/12.2'
    state: present

- name: Remove NVIDIA repository
  community.general.zypper_repository:
    name: nvidia-repo
    repo: 'ftp://download.nvidia.com/opensuse/12.2'
    state: absent

- name: Add python development repository
  community.general.zypper_repository:
    repo: 'http://download.opensuse.org/repositories/devel:/languages:/python/SLE_11_SP3/devel:languages:python.repo'

- name: Refresh all repos
  community.general.zypper_repository:
    repo: '*'
    runrefresh: yes

- name: Add a repo and add its gpg key
  community.general.zypper_repository:
    repo: 'http://download.opensuse.org/repositories/systemsmanagement/openSUSE_Leap_42.1/'
    auto_import_keys: yes

- name: Force refresh of a repository
  community.general.zypper_repository:
    repo: 'http://my_internal_ci_repo/repo'
    name: my_ci_repo
    state: present
    runrefresh: yes

Authors

• Matthias Vogelgesang (@matze)