Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

yum (65) Versions 3.0.0

Configures various yum components on Red Hat-like systems

Berkshelf/Librarian
Policyfile
Knife
cookbook 'yum', '= 3.0.0'
cookbook 'yum', '= 3.0.0', :supermarket
knife cookbook site install yum
knife cookbook site download yum
README
Dependencies
Quality -%

yum Cookbook

The Yum cookbook exposes the yum_globalconfig and yum_repository resources that allows a user to both control global behavior and make individual Yum repositories available for use. These resources aim to allow the user to configure all options listed in the yum.conf man page, found at http://linux.die.net/man/5/yum.conf

NOTES

WARNING: Yum cookbook version 3.0.0 and above contain non-backwards compatible breaking changes and will not work with cookbooks written against the 2.x and 1.x series. Changes have been made to the yum_repository resource, and the yum_key resource has been eliminated entirely. Recipes have been eliminated and moved into their own cookbooks. Please lock yum to the 2.x series in your Chef environments until all dependent cookbooks have been ported.

Requirements

  • Chef 11 or higher
  • Ruby 1.9 (preferably from the Chef full-stack installer)
  • RHEL5, RHEL6, or other platforms within the family

Resources/Providers

yum_repository

This resource manages a yum repository configuration file at /etc/yum.repos.d/repositoryid.repo. When the file needs to be repaired, it calls yum-makecache so packages in the repo become available to the next resource.

Actions

  • :create - creates a repository file and builds the repository listing
  • :delete - deletes the repository file

Parameters

  • baseurl - Must be a URL to the directory where the yum repository's 'repodata' directory lives. Can be an http://, ftp:// or file:// URL. You can specify multiple URLs in one baseurl statement.
  • cost - relative cost of accessing this repository. Useful for weighing one repo's packages as greater/less than any other. defaults to 1000
  • description - Maps to the 'name' parameter in a repository .conf. Descriptive name for the repository channel. This directive must be specified.
  • enabled - Either true or false. This tells yum whether or not use this repository.
  • enablegroups - Either true or false. Determines whether yum will allow the use of package groups for this repository. Default is true (package groups are allowed).
  • exclude - List of packages to exclude from updates or installs. This should be a space separated list in a single string. Shell globs using wildcards (eg. * and ?) are allowed.
  • failovermethod - Either 'roundrobin' or 'priority'.
  • fastestmirror_enabled - Either true or false
  • gpgcheck - Either true or false. This tells yum whether or not it should perform a GPG signature check on packages. When this is set in the [main] section it sets the default for all repositories. The default is true.
  • gpgkey - A URL pointing to the ASCII-armored GPG key file for the repository. This option is used if yum needs a public key to verify a package and the required key hasn't been imported into the RPM database. If this option is set, yum will automatically import the key from the specified URL.
  • http_caching - Either 'all', 'packages', or 'none'. Determines how upstream HTTP caches are instructed to handle any HTTP downloads that Yum does. Defaults to 'all'
  • includepkgs - Inverse of exclude. This is a list of packages you want to use from a repository. If this option lists only one package then that is all yum will ever see from the repository. Defaults to an empty list.
  • keepalive - Either true or false. This tells yum whether or not HTTP/1.1 keepalive should be used with this repository.
  • max_retries - Set the number of times any attempt to retrieve a file should retry before returning an error. Setting this to '0' makes yum try forever. Default is '10'.
  • metadata_expire - Time (in seconds) after which the metadata will expire. So that if the current metadata downloaded is less than this many seconds old then yum will not update the metadata against the repository. If you find that yum is not downloading information on updates as often as you would like lower the value of this option. You can also change from the default of using seconds to using days, hours or minutes by appending a d, h or m respectively. The default is 6 hours, to compliment yum-updatesd running once an hour. It's also possible to use the word "never", meaning that the metadata will never expire. Note that when using a metalink file the metalink must always be newer than the metadata for the repository, due to the validation, so this timeout also applies to the metalink file.
  • mirrorlist - Specifies a URL to a file containing a list of baseurls. This can be used instead of or with the baseurl option. Substitution variables, described below, can be used with this option. As a special hack is the mirrorlist URL contains the word "metalink" then the value of mirrorlist is copied to metalink (if metalink is not set)
  • mirror_expire - Time (in seconds) after which the mirrorlist locally cached will expire. If the current mirrorlist is less than this many seconds old then yum will not download another copy of the mirrorlist, it has the same extra format as metadata_expire. If you find that yum is not downloading the mirrorlists as often as you would like lower the value of this option.
  • mirrorlist_expire - alias for mirror_expire
  • priority - When the yum-priorities plug-in is enabled, you set priorities on repository entries, where N is an integer from 1 to 99. The default priority for repositories is 99.
  • proxy - URL to the proxy server that yum should use.
  • proxy_username - username to use for proxy
  • proxy_password - password for this proxy
  • report_instanceid - Report instance ID when using Amazon Linux AMIs and repositories
  • repositoryid - Must be a unique name for each repository, one word. Defaults to name attribute.
  • sslcacert - Path to the directory containing the databases of the certificate authorities yum should use to verify SSL certificates. Defaults to none - uses system default
  • sslclientcert - Path to the SSL client certificate yum should use to connect to repos/remote sites Defaults to none.
  • sslclientkey - Path to the SSL client key yum should use to connect to repos/remote sites Defaults to none.
  • sslverify - Either true or false. Determines if yum will verify SSL certificates/hosts. Defaults to true
  • timeout - Number of seconds to wait for a connection before timing out. Defaults to 30 seconds. This may be too short of a time for extremely overloaded sites.

Example

# add the Zenoss repository
yum_repository 'zenoss' do
  description "Zenoss Stable repo"
  baseurl "http://dev.zenoss.com/yum/stable/"
  gpgkey 'http://dev.zenoss.com/yum/RPM-GPG-KEY-zenoss'
  action :create
end

# add the EPEL repo
yum_repository 'epel' do
  description 'Extra Packages for Enterprise Linux'
  mirrorlist 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-6&arch=$basearch'
  gpgkey 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'
  action :create
end
# delete CentOS-Media repo
yum_repository 'CentOS-Media' do
  action :delete
end

yum_globalconfig

This renders a template with global yum configuration parameters. The default recipe uses it to render /etc/yum.conf. It is flexible enough to be used in other scenarios, such as building RPMs in isolation by modifying installroot.

Parameters

yum_globalconfig can take most of the same parameters as a yum_repository, plus more, too numerous to describe here. Below are a few of the more commonly used ones. For a complete list, please consult the yum.conf man page, found here: http://linux.die.net/man/5/yum.conf

  • cachedir - Directory where yum should store its cache and db files. The default is '/var/cache/yum'.
  • keepcache - Either true or false. Determines whether or not yum keeps the cache of headers and packages after successful installation. Default is true (keep files)
  • debuglevel - Debug message output level. Practical range is 0-10. Default is '2'.
  • exclude - List of packages to exclude from updates or installs. This should be a space separated list. Shell globs using wildcards (eg. * and ?) are allowed.
  • installonlypkgs = List of package provides that should only ever be installed, never updated. Kernels in particular fall into this category. Defaults to kernel, kernel-bigmem, kernel-enterprise, kernel-smp, kernel-debug, kernel-unsupported, kernel-source, kernel-devel, kernel-PAE, kernel-PAE-debug.
  • logfile - Full directory and file name for where yum should write its log file.
  • exactarch - Either true or false. Set to true to make 'yum update' only update the architectures of packages that you have installed. ie: with this enabled yum will not install an i686 package to update an x86_64 package. Default is true
  • gpgcheck - Either true or false. This tells yum whether or not it should perform a GPG signature check on the packages gotten from this repository.

Example

yum_globalconfig '/my/chroot/etc/yum.conf' do
  cachedir '/my/chroot/etc/yum.conf'
  keepcache 'yes'
  debuglevel '2'
  installroot '/my/chroot'
  action :create
end

Recipes

  • default - Configures yum_globalconfig[/etc/yum.conf] with values found in node attributes at node['yum']['main']

Attributes

The following attributes are set by default

default['yum']['main']['cachedir'] = '/var/cache/yum/$basearch/$releasever'
default['yum']['main']['keepcache'] = false
default['yum']['main']['debuglevel'] = nil
default['yum']['main']['exclude'] = nil
default['yum']['main']['logfile'] = '/var/log/yum.log'
default['yum']['main']['exactarch'] = nil
default['yum']['main']['obsoletes'] = nil
default['yum']['main']['installonly_limit'] = nil
default['yum']['main']['installonlypkgs'] = nil
default['yum']['main']['installroot'] = nil

Recipes from older versions of this cookbook have been moved individual cookbooks. Recipes for managing platform yum configurations and installing specific repositories can be found in one (or more!) of the following cookbook.

  • yum-centos
  • yum-fedora
  • yum-amazon
  • yum-epel
  • yum-elrepo
  • yum-repoforge
  • yum-ius
  • yum-percona
  • yum-pgdg

Usage

Put depends 'yum' in your metadata.rb to gain access to the yum_repository resource.

License & Authors

Copyright:: 2011 Eric G. Wolfe
Copyright:: 2013 Chef

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

CVE-2015-0235 Applicable Versions
abiquo Applicable Versions
ajenti Applicable Versions
amazon_s3cmd Applicable Versions
appcanary Applicable Versions
asf Applicable Versions
askbot Applicable Versions
asterisk Applicable Versions
auditbeat Applicable Versions
automatic_updates Applicable Versions
bamboo-agent Applicable Versions
baseserver Applicable Versions
bash-it Applicable Versions
bazaar Applicable Versions
bittorrent Applicable Versions
blackfire Applicable Versions
bosun Applicable Versions
boundary-meter Applicable Versions
boundary_meter Applicable Versions
bprobe Applicable Versions
cassandra-dse Applicable Versions
cdap Applicable Versions
centos-preupg Applicable Versions
centos-test Applicable Versions
ceph Applicable Versions
ceph-chef Applicable Versions
chef-bareos Applicable Versions
chef-grafana Applicable Versions
chef-manageiq Applicable Versions
chef-mongodb Applicable Versions
chef-yum-docker Applicable Versions
chef_nginx Applicable Versions
chrome Applicable Versions
circonus-broker Applicable Versions
clamav Applicable Versions
cloudinsight-agent Applicable Versions
cloudless-box Applicable Versions
cloudpassage Applicable Versions
cloudstack Applicable Versions
confluent-cookbook Applicable Versions
confluent-platform Applicable Versions
conjur Applicable Versions
cookbook-openshift3 Applicable Versions
coopr Applicable Versions
corosync Applicable Versions
couchbase Applicable Versions
couchbase-ng Applicable Versions
couchdb Applicable Versions
crenv Applicable Versions
datadog Applicable Versions
dbench Applicable Versions
diamond Applicable Versions
dirsrv Applicable Versions
docker Applicable Versions
dotnet-core Applicable Versions
dse Applicable Versions
ejabberd Applicable Versions
el2centos Applicable Versions
elastic-heartbeat Applicable Versions
elastic_beats_repo Applicable Versions
elasticsearch Applicable Versions
elasticsearch-cluster Applicable Versions
elasticsearch-curator Applicable Versions
elasticsearch-ng Applicable Versions
elkstack Applicable Versions
embulk Applicable Versions
enstratius_agent_proxy Applicable Versions
erlang Applicable Versions
et_mesos Applicable Versions
eucalyptus Applicable Versions
fabio Applicable Versions
fail2ban Applicable Versions
filebeat Applicable Versions
filezilla Applicable Versions
fish-shell Applicable Versions
fog_gem Applicable Versions
fping Applicable Versions
freeswitch Applicable Versions
frog Applicable Versions
fuse Applicable Versions
galera-platform Applicable Versions
ganeti Applicable Versions
gecode Applicable Versions
gflags Applicable Versions
git Applicable Versions
gitlab Applicable Versions
gitlab-ci-runner Applicable Versions
gitlab-server Applicable Versions
gitlab_runner Applicable Versions
gkrellmd Applicable Versions
gliderlabs_registrator Applicable Versions
gluster Applicable Versions
glusterfs Applicable Versions
goaccess Applicable Versions
gocd Applicable Versions
google-authenticator Applicable Versions
grafana Applicable Versions
grafana2 Applicable Versions
hadoop Applicable Versions
hadoop_cluster_rpm Applicable Versions
hdp-cloud Applicable Versions
hello_world_circleci_deploy_example Applicable Versions
hem Applicable Versions
hhvm Applicable Versions
hipchat_client Applicable Versions
htop Applicable Versions
httpie Applicable Versions
ibm_mq Applicable Versions
icinga-ng Applicable Versions
icinga2 Applicable Versions
icinga2repo Applicable Versions
imply-platform Applicable Versions
incron Applicable Versions
influxdb Applicable Versions
ipynb Applicable Versions
irssi Applicable Versions
jenkins Applicable Versions
jenkins-repo Applicable Versions
jolicode-php Applicable Versions
k8s Applicable Versions
katello Applicable Versions
keycloak Applicable Versions
ldapknife Applicable Versions
letsencrypt-boulder-server Applicable Versions
libffi Applicable Versions
librato Applicable Versions
libxml2 Applicable Versions
libxslt Applicable Versions
logentries_agent Applicable Versions
logentries_ng Applicable Versions
logstash Applicable Versions
logstash-forwarder Applicable Versions
logstash_forwarder Applicable Versions
lshw Applicable Versions
lsyncd Applicable Versions
lumenvox Applicable Versions
mackerel-agent Applicable Versions
magento Applicable Versions
magentostack Applicable Versions
marathon Applicable Versions
mariadb Applicable Versions
mcollective Applicable Versions
memcached Applicable Versions
memcached-cookbook Applicable Versions
mesos Applicable Versions
metricbeat Applicable Versions
minecraft Applicable Versions
mod_security Applicable Versions
mongodb Applicable Versions
mongodb-lib Applicable Versions
mongodb3 Applicable Versions
mono Applicable Versions
mono3 Applicable Versions
mono4 Applicable Versions
mosh Applicable Versions
mssqltools Applicable Versions
my_cookbook Applicable Versions
mysqld Applicable Versions
nagios Applicable Versions
neo4j Applicable Versions
netdevops Applicable Versions
netuitive Applicable Versions
newrelic Applicable Versions
newrelic-sysmond Applicable Versions
newrelic_meetme_plugin Applicable Versions
nexus Applicable Versions
nginx Applicable Versions
nginx-repo Applicable Versions
nodejs Applicable Versions
nodestack Applicable Versions
nsis Applicable Versions
ocserv Applicable Versions
omnibus Applicable Versions
omsa Applicable Versions
oneapm-ci-agent Applicable Versions
openbazaar Applicable Versions
opennms Applicable Versions
openresty Applicable Versions
openstack-clients Applicable Versions
openstack-common Applicable Versions
openvpn Applicable Versions
openvpnas Applicable Versions
opsview Applicable Versions
opsview_client Applicable Versions
os-hardening Applicable Versions
packagecloud Applicable Versions
packetbeat Applicable Versions
papertrail Applicable Versions
paramount Applicable Versions
patchman Applicable Versions
pdns Applicable Versions
percona Applicable Versions
percona-toolkit Applicable Versions
percona-tools Applicable Versions
perforce Applicable Versions
pertino Applicable Versions
pg Applicable Versions
pg-multi Applicable Versions
php-fpm Applicable Versions
phpstack Applicable Versions
pipeline Applicable Versions
pita Applicable Versions
platformstack Applicable Versions
poise-ruby Applicable Versions
postfix-dovecot Applicable Versions
postgis Applicable Versions
prometheus Applicable Versions
prosody Applicable Versions
protobuf Applicable Versions
pxe Applicable Versions
python Applicable Versions
pythonstack Applicable Versions
qpdf Applicable Versions
qpid Applicable Versions
rabbitmq Applicable Versions
rackspace_cloud_monitoring Applicable Versions
rackspace_cloudbackup Applicable Versions
rackspace_gluster Applicable Versions
rackspace_iptables Applicable Versions
rackspace_monitoring Applicable Versions
rackspace_support Applicable Versions
realmd-sssd Applicable Versions
redhat Applicable Versions
repose Applicable Versions
rethinkdb Applicable Versions
riak Applicable Versions
riak-cs Applicable Versions
riemann2 Applicable Versions
rkhunter Applicable Versions
rkt Applicable Versions
ruby-enterprise-install Applicable Versions
ruby-env-cookbook Applicable Versions
ruby_install Applicable Versions
rundeck Applicable Versions
rundeck-alt Applicable Versions
rundeck-server Applicable Versions
runit Applicable Versions
salt Applicable Versions
sc-mongodb Applicable Versions
scipy Applicable Versions
scl Applicable Versions
scout Applicable Versions
search_helpers Applicable Versions
selenium_grid Applicable Versions
selinux_policy Applicable Versions
sensu Applicable Versions
sensu_spec Applicable Versions
serverdensity Applicable Versions
siege Applicable Versions
software-collections Applicable Versions
solr_6 Applicable Versions
sonarqube_server Applicable Versions
spacewalk-server Applicable Versions
sphinx Applicable Versions
ssmtp Applicable Versions
ssmtp2 Applicable Versions
stack_commons Applicable Versions
stackstorm Applicable Versions
stegosoc Applicable Versions
stenographer Applicable Versions
supermarket Applicable Versions
sysdig Applicable Versions
takipi Applicable Versions
taurus Applicable Versions
td-agent Applicable Versions
teamforge Applicable Versions
telegraf Applicable Versions
terraria Applicable Versions
threatstack Applicable Versions
thruk Applicable Versions
tideways Applicable Versions
tizen Applicable Versions
tomoyo Applicable Versions
topbeat Applicable Versions
tor-full Applicable Versions
toran Applicable Versions
tutum Applicable Versions
twindb-repo Applicable Versions
typesafe-stack Applicable Versions
uchiwa Applicable Versions
ut_base Applicable Versions
varnish Applicable Versions
varnish_ng Applicable Versions
virtualbox Applicable Versions
vlc Applicable Versions
vmwaretools Applicable Versions
webmin Applicable Versions
wildfly Applicable Versions
x2go Applicable Versions
xbuild Applicable Versions
xrdp Applicable Versions
xvfb Applicable Versions
yum-amazon Applicable Versions
yum-atomic Applicable Versions
yum-atrpms Applicable Versions
yum-bareos Applicable Versions
yum-centos Applicable Versions
yum-chef Applicable Versions
yum-cloudstack-apt-get Applicable Versions
yum-corporate Applicable Versions
yum-dell Applicable Versions
yum-docker Applicable Versions
yum-duosecurity Applicable Versions
yum-elasticsearch Applicable Versions
yum-elrepo Applicable Versions
yum-epel Applicable Versions
yum-erlang_solutions Applicable Versions
yum-fedora Applicable Versions
yum-gitlab-ce Applicable Versions
yum-grafana Applicable Versions
yum-hp Applicable Versions
yum-influxdb Applicable Versions
yum-ius Applicable Versions
yum-jenkins Applicable Versions
yum-jpackage Applicable Versions
yum-mysql-community Applicable Versions
yum-newrelic Applicable Versions
yum-nginx Applicable Versions
yum-nodesource Applicable Versions
yum-oracle Applicable Versions
yum-osuosl Applicable Versions
yum-passenger Applicable Versions
yum-percona Applicable Versions
yum-pgdg Applicable Versions
yum-plugin-versionlock Applicable Versions
yum-powerdns Applicable Versions
yum-pydio Applicable Versions
yum-rabbitmq Applicable Versions
yum-remi Applicable Versions
yum-remi-chef Applicable Versions
yum-repoforge Applicable Versions
yum-scl Applicable Versions
yum-virtualbox Applicable Versions
yum-vmware-tools Applicable Versions
yum-webtatic Applicable Versions
yum-zabbix Applicable Versions
yum_dag Applicable Versions
yum_mesosphere Applicable Versions
yum_mysql_community Applicable Versions
yum_utils Applicable Versions
yumrepo Applicable Versions
yumserver Applicable Versions
zabbix Applicable Versions
zabbix-agent Applicable Versions
zabbix3 Applicable Versions
zendserver Applicable Versions
zenoss Applicable Versions
zeromq Applicable Versions
zfsonlinux Applicable Versions
zncrypt Applicable Versions
zookeeperd Applicable Versions

No quality metric results found