Default variable details
Some of debops.extrepo
default variables have more extensive configuration
than simple strings or lists, here you can find documentation and examples for
them.
extrepo__configuration
These variables define the contents of the /etc/extrepo/config.yaml
configuration file. The original file is diverted to preserve its contents and
avoid configuration changes during package upgrades.
Examples
Override the selection of the repository components via Ansible inventory (the default is based on the debops.apt local facts):
extrepo__configuration:
- name: 'policies'
config:
enabled_policies: [ 'main', 'contrib', 'non-free' ]
Syntax
The variables are defined as lists of YAML dictionaries. Each dictionary defines a part of the final configuration file; configuration entries are merged together and rendered as a YAML document. Each configuration entry is defined using specific parameters:
name
Required. An identifier for a particular configuration entry, not used in the configuration file itself. Entries with the same
name
parameter can be overridden by subsequent entries.config
Required. YAML dictionary with the extrepo configuration options.
state
Optional. If not specified or
present
, a given configuration entry will be included in the generated configuration file. Ifabsent
, the configuration entry will be removed from the generated configuration file. Ifignore
, a given configuration entry will not be considered during template generation. This can be used to conditionally enable or disable configuration options.
extrepo__sources
These lists define the names of the external APT sources available using the
extrepo command, which should be configured on a host or a group of
hosts. You can see the list of available APT sources by running the
extrepo search command on the remote host after the extrepo
package is installed.
Examples
Configure access to the Debian FastTrack repositories (the official Debian Backports repository might also be needed, see debops.apt role for details). In this example we use a simple syntax to specify a list of APT sources.
extrepo__sources:
- 'fasttrack'
- 'fasttrack_backports'
Enable the Elastic APT repository to get access to Elasticsearch, Kibana, Filebeat and other packages.
extrepo__sources:
- 'elastic'
Make sure that the upstream Docker APT repository is disabled and enable the upstream Kubernetes repository.
extrepo__sources:
- name: 'kubernetes'
state: 'present'
- name: 'docker-ce'
state: 'absent'
Syntax
You can specify a list of strings which define the names of the APT sources available via extrepo. To see the available APT sources, you can run the extrepo search command.
Alternatively, each list entry can be a YAML dictionary with specific parameters:
name
Required. Name of the APT source to manage.
state
Optional. If not specified or
present
, the specified APT source will be enabled via the extrepo command. Ifabsent
, the source file located in/etc/apt/sources.list.d/extrepo_name.sources
will be removed.