yumrepo

Description

The client-side description of a yum repository. Repository
configurations are found by parsing /etc/yum.conf and
the files indicated by the reposdir option in that file
(see yum.conf(5) for details).

Most parameters are identical to the ones documented
in the yum.conf(5) man page.

Continuation lines that yum supports (for the baseurl, for example)
are not supported. This type does not attempt to read or verify the
existence of files listed in the include attribute.

Attributes

yumrepo { 'resource title':
name => # (namevar) The name of the repository. This corresponds to ensure => # The basic property that the resource should be...assumeyes => # Determines if yum prompts for confirmation of...bandwidth => # Use to specify the maximum available network...baseurl => # The URL for this repository. Set this to...cost => # Cost of this repository. Set this to `absent` to deltarpm_metadata_percentage => # Percentage value that determines when to...deltarpm_percentage => # Percentage value that determines when to use...descr => # A human-readable description of the repository...enabled => # Whether this repository is enabled. Valid values enablegroups => # Whether yum will allow the use of package groups exclude => # List of shell globs. Matching packages will...failovermethod => # The failover method for this repository; should...gpgcakey => # The URL for the GPG CA key for this repository...gpgcheck => # Whether to check the GPG signature on packages...gpgkey => # The URL for the GPG key with which packages from http_caching => # What to cache from this repository. Set this to...include => # The URL of a remote file containing additional...includepkgs => # List of shell globs. If this is set, only...keepalive => # Whether HTTP/1.1 keepalive should be used with...metadata_expire => # Number of seconds after which the metadata will...metalink => # Metalink for mirrors. Set this to `absent` to...mirrorlist => # The URL that holds the list of mirrors for this...mirrorlist_expire => # Time (in seconds) after which the mirrorlist...priority => # Priority of this repository from 1-99. Requires...protect => # Enable or disable protection for this...provider => # The specific backend to use for this `yumrepo...proxy => # URL of a proxy server that Yum should use when...proxy_password => # Password for this proxy. Set this to `absent` to proxy_username => # Username for this proxy. Set this to `absent` to repo_gpgcheck => # Whether to check the GPG signature on repodata...retries => # Set the number of times any attempt to retrieve...s3_enabled => # Access the repository via S3. Valid values are...skip_if_unavailable => # Should yum skip this repository if unable to...sslcacert => # Path to the directory containing the databases...sslclientcert => # Path to the SSL client certificate yum should...sslclientkey => # Path to the SSL client key yum should use to...sslverify => # Should yum verify SSL certificates/hosts at all. target => # The filename to write the yum repository...throttle => # Enable bandwidth throttling for downloads. This...timeout => # Number of seconds to wait for a connection...
# ...plus any applicable metaparameters.
}

name

(Namevar: If omitted, this attribute’s value defaults to the resource’s title.)

The name of the repository. This corresponds to the
repositoryid parameter in yum.conf(5).

bandwidth

(Property: This attribute represents concrete state on the target system.)

Use to specify the maximum available network bandwidth
in bytes/second. Used with the throttle option. If throttle
is a percentage and bandwidth is 0 then bandwidth throttling
will be disabled. If throttle is expressed as a data rate then
this option is ignored.
Set this to absent to remove it from the file completely.

deltarpm_metadata_percentage

(Property: This attribute represents concrete state on the target system.)

Percentage value that determines when to download deltarpm metadata.
When the deltarpm metadata is larger than this percentage value of the
package, deltarpm metadata is not downloaded.
Set this to absent to remove it from the file completely.

deltarpm_percentage

(Property: This attribute represents concrete state on the target system.)

Percentage value that determines when to use deltas for this repository.
When the delta is larger than this percentage value of the package, the
delta is not used.
Set this to absent to remove it from the file completely.

protect

(Property: This attribute represents concrete state on the target system.)

Enable or disable protection for this repository. Requires
that the protectbase plugin is installed and enabled.
Valid values are: false/0/no or true/1/yes.
Set this to absent to remove it from the file completely.

proxy

(Property: This attribute represents concrete state on the target system.)

URL of a proxy server that Yum should use when accessing this repository.
This attribute can also be set to '_none_', which will make Yum bypass any
global proxy settings when accessing this repository.
Set this to absent to remove it from the file completely.

target

throttle

(Property: This attribute represents concrete state on the target system.)

Enable bandwidth throttling for downloads. This option
can be expressed as a absolute data rate in bytes/sec or a
percentage 60%. An SI prefix (k, M or G) may be appended
to the data rate values.
Set this to absent to remove it from the file completely.

Providers

inifile

Fetching instances

When fetching repo instances, directory entries in ‘/etc/yum/repos.d’,
‘/etc/yum.repos.d’, and the directory optionally specified by the reposdir
key in ‘/etc/yum.conf’ will be checked. If a given directory does not exist it
will be ignored. In addition, all sections in ‘/etc/yum.conf’ aside from
‘main’ will be created as sections.

Storing instances

When creating a new repository, a new section will be added in the first
yum repo directory that exists. The custom directory specified by the
‘/etc/yum.conf’ reposdir property is checked first, followed by
‘/etc/yum/repos.d’, and then ‘/etc/yum.repos.d’. If none of these exist, the
section will be created in ‘/etc/yum.conf’.

NOTE: This page was generated from the Puppet source code on 2017-06-27 17:23:02 -0500