cloud-toaster 1.1.2

data/chef/cookbooks/yum/README.md

@@ -0,0 +1,268 @@
+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.
+
+#### Example
+``` ruby
+# 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
+```
+
+``` ruby
+# delete CentOS-Media repo
+yum_repository 'CentOS-Media' do
+  action :delete
+end
+```
+
+#### 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.
+* `source` - Use a custom template source instead of the default one
+  in the yum cookbook
+* `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.
+
+### 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`. 
+
+#### Example
+``` ruby
+yum_globalconfig '/my/chroot/etc/yum.conf' do
+  cachedir '/my/chroot/etc/yum.conf'
+  keepcache 'yes'
+  debuglevel '2'
+  installroot '/my/chroot'
+  action :create
+end
+```
+
+#### 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.
+ 
+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
+
+``` ruby
+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
+```
+
+Related Cookbooks
+-----------------
+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
+-----------------
+- Author:: Eric G. Wolfe
+- Author:: Matt Ray (<matt@getchef.com>)
+- Author:: Joshua Timberman (<joshua@getchef.com>)
+- Author:: Sean OMeara (<someara@getchef.com>)
+
+```text
+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.
+```

data/chef/cookbooks/yum/attributes/main.rb

@@ -0,0 +1,97 @@
+# http://linux.die.net/man/5/yum.conf
+case node['platform_version'].to_i
+when 5
+  default['yum']['main']['cachedir'] = '/var/cache/yum'
+else
+  default['yum']['main']['cachedir'] = '/var/cache/yum/$basearch/$releasever'
+end
+
+case node['platform']
+when 'amazon'
+  default['yum']['main']['distroverpkg'] = 'system-release'
+when 'scientific'
+  default['yum']['main']['distroverpkg'] = 'sl-release'
+else
+  default['yum']['main']['distroverpkg'] = "#{node['platform']}-release"
+end
+
+default['yum']['main']['alwaysprompt'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['assumeyes'] = nil  # [TrueClass, FalseClass]
+default['yum']['main']['bandwidth'] = nil # /^\d+$/
+default['yum']['main']['bugtracker_url'] = nil # /.*/
+default['yum']['main']['clean_requirements_on_remove'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['color'] = nil # %w{ always never }
+default['yum']['main']['color_list_available_downgrade'] = nil #  /.*/
+default['yum']['main']['color_list_available_install'] = nil #  /.*/
+default['yum']['main']['color_list_available_reinstall'] = nil #  /.*/
+default['yum']['main']['color_list_available_upgrade'] = nil #  /.*/
+default['yum']['main']['color_list_installed_extra'] = nil #  /.*/
+default['yum']['main']['color_list_installed_newer'] = nil #  /.*/
+default['yum']['main']['color_list_installed_older'] = nil #  /.*/
+default['yum']['main']['color_list_installed_reinstall'] = nil #  /.*/
+default['yum']['main']['color_search_match'] = nil #  /.*/
+default['yum']['main']['color_update_installed'] = nil #  /.*/
+default['yum']['main']['color_update_local'] = nil #  /.*/
+default['yum']['main']['color_update_remote'] = nil #  /.*/
+default['yum']['main']['commands'] = nil #  /.*/
+default['yum']['main']['debuglevel'] = nil # /^\d+$/
+default['yum']['main']['diskspacecheck'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['enable_group_conditionals'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['errorlevel'] = nil # /^\d+$/
+default['yum']['main']['exactarch'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['exclude'] = nil # /.*/
+default['yum']['main']['gpgcheck'] = true # [TrueClass, FalseClass]
+default['yum']['main']['group_package_types'] = nil # /.*/
+default['yum']['main']['groupremove_leaf_only'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['history_list_view'] = nil #  /.*/
+default['yum']['main']['history_record'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['history_record_packages'] = nil #  /.*/
+default['yum']['main']['http_caching'] = nil # %w{ packages all none }
+default['yum']['main']['installonly_limit'] = nil # /\d+/, /keep/
+default['yum']['main']['installonlypkgs'] = nil # /.*/
+default['yum']['main']['installroot'] = nil # /.*/
+default['yum']['main']['keepalive'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['keepcache'] = false # [TrueClass, FalseClass]
+default['yum']['main']['kernelpkgnames'] = nil # /.*/
+default['yum']['main']['localpkg_gpgcheck'] = nil # [TrueClass,# FalseClass]
+default['yum']['main']['logfile'] = '/var/log/yum.log' # /.*/
+default['yum']['main']['max_retries'] = nil # /^\d+$/
+default['yum']['main']['mdpolicy'] = nil # %w{ packages all none }
+default['yum']['main']['metadata_expire'] = nil # /^\d+$/
+default['yum']['main']['mirrorlist_expire'] = nil # /^\d+$/
+default['yum']['main']['multilib_policy'] = nil # %w{ all best }
+default['yum']['main']['obsoletes'] = nil  # [TrueClass, FalseClass]
+default['yum']['main']['overwrite_groups'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['password'] = nil #  /.*/
+default['yum']['main']['path'] = '/etc/yum.conf' #  /.*/
+default['yum']['main']['persistdir'] = nil # /.*/
+default['yum']['main']['pluginconfpath'] = nil #  /.*/
+default['yum']['main']['pluginpath'] = nil #  /.*/
+default['yum']['main']['plugins'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['protected_multilib'] = nil # /.*/
+default['yum']['main']['protected_packages'] = nil # /.*/
+default['yum']['main']['proxy'] = nil #  /.*/
+default['yum']['main']['proxy_password'] = nil #  /.*/
+default['yum']['main']['proxy_username'] = nil #  /.*/
+default['yum']['main']['username'] = nil #  /.*/
+default['yum']['main']['password'] = nil #  /.*/
+default['yum']['main']['recent'] = nil # /^\d+$/
+default['yum']['main']['releasever'] = nil #  /.*/
+default['yum']['main']['repo_gpgcheck'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['reset_nice'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['rpmverbosity'] = nil # %w{ info critical# emergency error warn debug }
+default['yum']['main']['showdupesfromrepos'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['skip_broken'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['ssl_check_cert_permissions'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['sslcacert'] = nil # /.*/
+default['yum']['main']['sslclientcert'] = nil # /.*/
+default['yum']['main']['sslclientkey'] = nil #  /.*/
+default['yum']['main']['sslverify'] = nil # [TrueClass, FalseClass]
+default['yum']['main']['syslog_device'] = nil #  /.*/
+default['yum']['main']['syslog_facility'] = nil #  /.*/
+default['yum']['main']['syslog_ident'] = nil #  /.*/
+default['yum']['main']['throttle'] = nil # [/\d+k/, /\d+M/, /\d+G/]
+default['yum']['main']['timeout'] = nil # /\d+/
+default['yum']['main']['tolerant'] = false
+default['yum']['main']['tsflags'] = nil # /.*/
+default['yum']['main']['username'] = nil #  /.*/

data/chef/cookbooks/yum/libraries/matchers.rb

@@ -0,0 +1,27 @@
+# Matchers for chefspec 3
+
+if defined?(ChefSpec)
+  def create_yum_repository(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_repository, :create, resource_name)
+  end
+
+  def add_yum_repository(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_repository, :add, resource_name)
+  end
+
+  def delete_yum_repository(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_repository, :delete, resource_name)
+  end
+
+  def remove_yum_repository(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_repository, :remove, resource_name)
+  end
+
+  def create_yum_globalconfig(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_globalconfig, :create, resource_name)
+  end
+
+  def delete_yum_globalconfig(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:yum_globalconfig, :delete, resource_name)
+  end
+end

data/chef/cookbooks/yum/metadata.json

@@ -0,0 +1,34 @@
+{
+  "name": "yum",
+  "version": "3.2.2",
+  "description": "Configures various yum components on Red Hat-like systems",
+  "long_description": "yum Cookbook\n============\n\nThe Yum cookbook exposes the `yum_globalconfig` and `yum_repository`\nresources that allows a user to both control global behavior and make\nindividual Yum repositories available for use. These resources aim to\nallow the user to configure all options listed in the `yum.conf` man\npage, found at http://linux.die.net/man/5/yum.conf\n\nNOTES\n-----\nWARNING: Yum cookbook version 3.0.0 and above contain non-backwards\ncompatible breaking changes and will not work with cookbooks written\nagainst the 2.x and 1.x series. Changes have been made to the\nyum_repository resource, and the yum_key resource has been eliminated\nentirely. Recipes have been eliminated and moved into their own\ncookbooks. Please lock yum to the 2.x series in your Chef environments\nuntil all dependent cookbooks have been ported.\n\nRequirements\n------------\n* Chef 11 or higher\n* Ruby 1.9 (preferably from the Chef full-stack installer)\n* RHEL5, RHEL6, or other platforms within the family\n\nResources/Providers\n-------------------\n### yum_repository\nThis resource manages a yum repository configuration file at\n/etc/yum.repos.d/`repositoryid`.repo. When the file needs to be\nrepaired, it calls yum-makecache so packages in the repo become\navailable to the next resource.\n\n#### Example\n``` ruby\n# add the Zenoss repository\nyum_repository 'zenoss' do\n  description \"Zenoss Stable repo\"\n  baseurl \"http://dev.zenoss.com/yum/stable/\"\n  gpgkey 'http://dev.zenoss.com/yum/RPM-GPG-KEY-zenoss'\n  action :create\nend\n\n# add the EPEL repo\nyum_repository 'epel' do\n  description 'Extra Packages for Enterprise Linux'\n  mirrorlist 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-6&arch=$basearch'\n  gpgkey 'http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL-6'\n  action :create\nend\n```\n\n``` ruby\n# delete CentOS-Media repo\nyum_repository 'CentOS-Media' do\n  action :delete\nend\n```\n\n#### Actions\n- `:create` - creates a repository file and builds the repository listing\n- `:delete` - deletes the repository file\n\n#### Parameters\n* `baseurl` -  Must be a URL to the directory where the yum repository's\n  'repodata' directory lives. Can be an http://, ftp:// or file://\n  URL. You can specify multiple URLs in one baseurl statement.\n* `cost` - relative cost of accessing this repository. Useful for\n  weighing one repo's packages as greater/less than any other.\n  defaults to 1000\n* `description` - Maps to the 'name' parameter in a repository .conf.\n  Descriptive name for the repository channel. This directive must be\n  specified.\n* `enabled` - Either `true` or `false`. This tells yum whether or not use this repository.\n* `enablegroups` -  Either `true` or `false`. Determines whether yum\n  will allow the use of package groups for this repository. Default is\n  `true` (package groups are allowed).\n* `exclude` - List of packages to exclude from updates or installs. This\n  should be a space separated list in a single string. Shell globs using wildcards (eg. *\n  and ?) are allowed.\n* `failovermethod` - Either 'roundrobin' or 'priority'.\n* `fastestmirror_enabled` - Either `true` or `false`\n* `gpgcheck` - Either `true` or `false`. This tells yum whether or not\n  it should perform a GPG signature check on packages. When this is\n  set in the [main] section it sets the default for all repositories.\n  The default is `true`.\n* `gpgkey` - A URL pointing to the ASCII-armored GPG key file for the\n  repository. This option is used if yum needs a public key to verify\n  a package and the required key hasn't been imported into the RPM\n  database. If this option is set, yum will automatically import the\n  key from the specified URL.\n* `http_caching` - Either 'all', 'packages', or 'none'. Determines how\n  upstream HTTP caches are instructed to handle any HTTP downloads\n  that Yum does. Defaults to 'all'\n* `includepkgs` -  Inverse of exclude. This is a list of packages you\n  want to use from a repository. If this option lists only one package\n  then that is all yum will ever see from the repository. Defaults to\n  an empty list.\n* `keepalive` - Either `true` or `false`. This tells yum whether or not\n  HTTP/1.1 keepalive should be used with this repository.  \n* `max_retries` - Set the number of times any attempt to retrieve a file\n  should retry before returning an error. Setting this to '0' makes\n  yum try forever. Default is '10'.\n* `metadata_expire` - Time (in seconds) after which the metadata will\n  expire. So that if the current metadata downloaded is less than this\n  many seconds old then yum will not update the metadata against the\n  repository. If you find that yum is not downloading information on\n  updates as often as you would like lower the value of this option.\n  You can also change from the default of using seconds to using days,\n  hours or minutes by appending a d, h or m respectively. The default\n  is 6 hours, to compliment yum-updatesd running once an hour. It's\n  also possible to use the word \"never\", meaning that the metadata\n  will never expire. Note that when using a metalink file the metalink\n  must always be newer than the metadata for the repository, due to\n  the validation, so this timeout also applies to the metalink file.\n* `mirrorlist` - Specifies a URL to a file containing a list of\n  baseurls. This can be used instead of or with the baseurl option.\n  Substitution variables, described below, can be used with this\n  option. As a special hack is the mirrorlist URL contains the word\n  \"metalink\" then the value of mirrorlist is copied to metalink (if\n  metalink is not set)\n* `mirror_expire` - Time (in seconds) after which the mirrorlist locally\n  cached will expire. If the current mirrorlist is less than this many\n  seconds old then yum will not download another copy of the\n  mirrorlist, it has the same extra format as metadata_expire. If you\n  find that yum is not downloading the mirrorlists as often as you\n  would like lower the value of this option.\n* `mirrorlist_expire` - alias for mirror_expire\n* `priority` - When the yum-priorities plug-in is enabled, you set\n  priorities on repository entries, where N is an integer from 1 to 99. The\n  default priority for repositories is 99.\n* `proxy` - URL to the proxy server that yum should use.\n* `proxy_username` -  username to use for proxy\n* `proxy_password` - password for this proxy\n* `report_instanceid` - Report instance ID when using Amazon Linux AMIs\n  and repositories\n* `repositoryid` - Must be a unique name for each repository, one word.\n  Defaults to name attribute.\n* `source` - Use a custom template source instead of the default one\n  in the yum cookbook\n* `sslcacert` - Path to the directory containing the databases of the\n  certificate authorities yum should use to verify SSL certificates.\n  Defaults to none - uses system default\n* `sslclientcert` - Path to the SSL client certificate yum should use to\n  connect to repos/remote sites Defaults to none.  \n* `sslclientkey` - Path to the SSL client key yum should use to connect\n  to repos/remote sites Defaults to none.\n* `sslverify` - Either `true` or `false`. Determines if yum will verify SSL certificates/hosts. Defaults to `true`\n* `timeout` - Number of seconds to wait for a connection before timing\n  out. Defaults to 30 seconds. This may be too short of a time for\n  extremely overloaded sites.\n\n### yum_globalconfig\nThis renders a template with global yum configuration parameters. The\ndefault recipe uses it to render `/etc/yum.conf`. It is flexible\nenough to be used in other scenarios, such as building RPMs in\nisolation by modifying `installroot`. \n\n#### Example\n``` ruby\nyum_globalconfig '/my/chroot/etc/yum.conf' do\n  cachedir '/my/chroot/etc/yum.conf'\n  keepcache 'yes'\n  debuglevel '2'\n  installroot '/my/chroot'\n  action :create\nend\n```\n\n#### Parameters\n`yum_globalconfig` can take most of the same parameters as a\n`yum_repository`, plus more, too numerous to describe here. Below are\na few of the more commonly used ones. For a complete list, please\nconsult the `yum.conf` man page, found here:\nhttp://linux.die.net/man/5/yum.conf\n\n* `cachedir` - Directory where yum should store its cache and db\n  files. The default is '/var/cache/yum'.  \n* `keepcache` - Either `true` or `false`. Determines whether or not\n  yum keeps the cache of headers and packages after successful\n  installation. Default is `true` (keep files)\n* `debuglevel` - Debug message output level. Practical range is 0-10.\n  Default is '2'.  \n* `exclude` - List of packages to exclude from updates or installs.\n  This should be a space separated list. Shell globs using wildcards\n  (eg. * and ?) are allowed.  \n* `installonlypkgs` = List of package provides that should only ever\n  be installed, never updated. Kernels in particular fall into this\n  category. Defaults to kernel, kernel-bigmem, kernel-enterprise,\n  kernel-smp, kernel-debug, kernel-unsupported, kernel-source,\n  kernel-devel, kernel-PAE, kernel-PAE-debug.\n* `logfile` - Full directory and file name for where yum should write\n  its log file.\n* `exactarch` -  Either `true` or `false`. Set to `true` to make 'yum update' only\n  update the architectures of packages that you have installed. ie:\n  with this enabled yum will not install an i686 package to update an\n  x86_64 package. Default is `true`\n* `gpgcheck` - Either `true` or `false`. This tells yum whether or not\n  it should perform a GPG signature check on the packages gotten from\n  this repository.\n \nRecipes\n-------\n* `default` - Configures `yum_globalconfig[/etc/yum.conf]` with values\n  found in node attributes at `node['yum']['main']`\n\nAttributes\n----------\nThe following attributes are set by default\n\n``` ruby\ndefault['yum']['main']['cachedir'] = '/var/cache/yum/$basearch/$releasever'\ndefault['yum']['main']['keepcache'] = false\ndefault['yum']['main']['debuglevel'] = nil\ndefault['yum']['main']['exclude'] = nil\ndefault['yum']['main']['logfile'] = '/var/log/yum.log'\ndefault['yum']['main']['exactarch'] = nil\ndefault['yum']['main']['obsoletes'] = nil\ndefault['yum']['main']['installonly_limit'] = nil\ndefault['yum']['main']['installonlypkgs'] = nil\ndefault['yum']['main']['installroot'] = nil\n```\n\nRelated Cookbooks\n-----------------\nRecipes from older versions of this cookbook have been moved\nindividual cookbooks. Recipes for managing platform yum configurations\nand installing specific repositories can be found in one (or more!) of\nthe following cookbook.\n\n* yum-centos\n* yum-fedora\n* yum-amazon\n* yum-epel\n* yum-elrepo\n* yum-repoforge\n* yum-ius\n* yum-percona\n* yum-pgdg\n\nUsage\n-----\nPut `depends 'yum'` in your metadata.rb to gain access to the\nyum_repository resource.\n\nLicense & Authors\n-----------------\n- Author:: Eric G. Wolfe\n- Author:: Matt Ray (<matt@getchef.com>)\n- Author:: Joshua Timberman (<joshua@getchef.com>)\n- Author:: Sean OMeara (<someara@getchef.com>)\n\n```text\nCopyright:: 2011 Eric G. Wolfe\nCopyright:: 2013 Chef\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n",
+  "maintainer": "Chef",
+  "maintainer_email": "cookbooks@getchef.com",
+  "license": "Apache 2.0",
+  "platforms": {
+    "redhat": ">= 0.0.0",
+    "centos": ">= 0.0.0",
+    "scientific": ">= 0.0.0",
+    "amazon": ">= 0.0.0",
+    "fedora": ">= 0.0.0"
+  },
+  "dependencies": {
+  },
+  "recommendations": {
+  },
+  "suggestions": {
+  },
+  "conflicting": {
+  },
+  "providing": {
+  },
+  "replacing": {
+  },
+  "attributes": {
+  },
+  "groupings": {
+  },
+  "recipes": {
+  }
+}

data/chef/cookbooks/yum/metadata.rb

@@ -0,0 +1,13 @@
+name 'yum'
+maintainer 'Chef'
+maintainer_email 'cookbooks@getchef.com'
+license 'Apache 2.0'
+description 'Configures various yum components on Red Hat-like systems'
+long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
+version '3.2.2'
+
+supports 'redhat'
+supports 'centos'
+supports 'scientific'
+supports 'amazon'
+supports 'fedora'

data/chef/cookbooks/yum/providers/globalconfig.rb

@@ -0,0 +1,37 @@
+#
+# Cookbook Name:: yum
+# Provider:: repository
+#
+# Author:: Sean OMeara <someara@getchef.com>
+# 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.
+#
+
+# Allow for Chef 10 support
+use_inline_resources if defined?(use_inline_resources)
+
+action :create  do
+  template new_resource.path do
+    source 'main.erb'
+    cookbook 'yum'
+    mode '0644'
+    variables(:config => new_resource)
+  end
+end
+
+action :delete do
+  file new_resource.path do
+    action :delete
+  end
+end

data/chef/cookbooks/yum/providers/repository.rb

@@ -0,0 +1,85 @@
+#
+# Cookbook Name:: yum
+# Provider:: repository
+#
+# Author:: Sean OMeara <someara@getchef.com>
+# 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.
+#
+
+# In Chef 11 and above, calling the use_inline_resources method will
+# make Chef create a new "run_context". When an action is called, any
+# nested resources are compiled and converged in isolation from the
+# recipe that calls it.
+
+# Allow for Chef 10 support
+use_inline_resources if defined?(use_inline_resources)
+
+def whyrun_supported?
+  true
+end
+
+action :create  do
+  # Hack around the lack of "use_inline_resources" before Chef 11 by
+  # uniquely naming the execute[yum-makecache] resources. Set the
+  # notifies timing to :immediately for the same reasons. Remove both
+  # of these when dropping Chef 10 support.
+
+  template "/etc/yum.repos.d/#{new_resource.repositoryid}.repo" do
+    if new_resource.source.nil?
+      source 'repo.erb'
+      cookbook 'yum'
+    else
+      source new_resource.source
+    end
+    mode '0644'
+    variables(:config => new_resource)
+    notifies :run, "execute[yum-makecache-#{new_resource.repositoryid}]", :immediately
+    notifies :create, "ruby_block[yum-cache-reload-#{new_resource.repositoryid}]", :immediately
+  end
+
+  # get the metadata for this repo only
+  execute "yum-makecache-#{new_resource.repositoryid}" do
+    command "yum -q makecache --disablerepo=* --enablerepo=#{new_resource.repositoryid}"
+    action :nothing
+  end
+
+  # reload internal Chef yum cache
+  ruby_block "yum-cache-reload-#{new_resource.repositoryid}" do
+    block { Chef::Provider::Package::Yum::YumCache.instance.reload }
+    action :nothing
+  end
+end
+
+action :delete do
+  file "/etc/yum.repos.d/#{new_resource.repositoryid}.repo" do
+    action :delete
+    notifies :run, "execute[yum clean #{new_resource.repositoryid}]", :immediately
+    notifies :create, "ruby_block[yum-cache-reload-#{new_resource.repositoryid}]", :immediately
+  end
+
+  execute "yum clean #{new_resource.repositoryid}" do
+    command "yum clean all --disablerepo=* --enablerepo=#{new_resource.repositoryid}"
+    only_if "yum repolist | grep -P '^#{new_resource.repositoryid}([ \t]|$)'"
+    action :nothing
+  end
+
+  ruby_block "yum-cache-reload-#{new_resource.repositoryid}" do
+    block { Chef::Provider::Package::Yum::YumCache.instance.reload }
+    action :nothing
+  end
+end
+
+alias_method :action_add, :action_create
+alias_method :action_remove, :action_delete

data/chef/cookbooks/yum/recipes/default.rb

@@ -0,0 +1,34 @@
+#
+# Author:: Sean OMeara (<someara@getchef.com>)
+# Recipe:: yum::default
+#
+# 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.
+
+yum_globalconfig '/etc/yum.conf' do
+  cachedir node['yum']['main']['cachedir']
+  keepcache node['yum']['main']['keepcache']
+  debuglevel node['yum']['main']['debuglevel']
+  exclude node['yum']['main']['exclude']
+  logfile node['yum']['main']['logfile']
+  exactarch node['yum']['main']['exactarch']
+  obsoletes node['yum']['main']['obsoletes']
+  proxy node['yum']['main']['proxy']
+  installonly_limit node['yum']['main']['installonly_limit']
+  installonlypkgs node['yum']['main']['installonlypkgs']
+  installroot node['yum']['main']['installroot']
+  distroverpkg node['yum']['main']['distroverpkg']
+  releasever node['yum']['main']['releasever']
+  action :create
+end