1 line
10 KiB
JSON
Raw Normal View History

{"name":"yum","description":"A fabulous new cookbook","long_description":"# Description\n\nConfigures various YUM components on Red Hat-like systems. Includes\nLWRP for managing repositories and their GPG keys.\n\nBased on the work done by Eric Wolfe and Charles Duffy on the\n[yumrepo](https://github.com/atomic-penguin/cookbook-yumrepo) cookbook.\n\n# Requirements\n\nRed Hat Enterprise Linux 5, and 6 distributions within this platform\nfamily.\n\n# Attributes\n\n* `yum['exclude']`\n - An array containing a list of packages to exclude from updates or\n installs. Wildcards and shell globs are supported.\n - Defaults to an empty exclude list.\n\n* `yum['installonlypkgs']`\n - An array containing a list of packages which should only be\n installed, never updated.\n - Defaults to an empty install-only list.\n\n* `yum['ius_release']`\n - Set the IUS release to install.\n - Defaults to the current release of the IUS repo.\n\n* `yum['repoforge_release']`\n - Set the RepoForge release to install.\n - Defaults to the current release of the repoforge repo.\n\nEPEL attributes used in the `yum::epel` recipe, see\n`attributes/epel.rb` for default values:\n\n* `yum['epel']['key']`\n - Name of the GPG key used for the repo.\n\n* `yum['epel']['baseurl']`\n - Base URL to an EPEL mirror.\n\n* `yum['epel']['url']`\n - URL to the EPEL mirrorlist.\n\n* `yum['epel']['key_url']`\n - URL to the GPG key for the repo.\n\n* `yum['epel']['includepkgs']`\n - list of packages you want to use for the repo.\n\n* `yum['epel']['exclude']`\n - list of packages you do NOT want to use for the repo.\n\nThe `node['yum']['epel_release']` attribute is removed, see the __epel__\nrecipe information below.\n\nremi attributes used in the `yum::remi` recipe, see\n`attributes/remi.rb` for default values:\n\n* `yum['remi']['key']`\n - Name of the GPG key used for the repo.\n\n* `yum['remi']['url']`\n - URL to the remi mirrorlist.\n\n* `yum['remi']['key_url']`\n - URL to the GPG key for the repo.\n\n* `yum['remi']['includepkgs']`\n - list of packages you want to use for the repo.\n\n* `yum['remi']['exclude']`\n - list of packages you do NOT want to use for the repo.\n\nProxy settings used in yum.conf on RHEL family 5 and 6:\n\n* `yum['proxy']`\n - Set the URL for an HTTP proxy\n - None of the proxy settings are used if this is an empty string\n (default)\n\n* `yum['proxy_username']`\n - Set the username for the proxy\n - not used if `yum['proxy']` above is an empty string\n\n* `yum['proxy_password']`\n - Set the password for the proxy\n - not used if `yum['proxy']` above is an empty string\n\n# Recipes\n\n## default\n\nThe default recipe does nothing.\n\n## yum\n\nManages the configuration of the `/etc/yum.conf` via attributes. See\nthe aforementioned Array attributes `yum['exclude']` and\n`yum['installonlypkgs']`.\n\n## epel\n\nUses the `yum_key` and `yum_repository` resources from this cookbook\nare used to manage the main EPEL repository. If you need other EPEL\nrepositories (source, debug-info), use the `yum_repository` LWRP in\nyour own cookbook where those packages are required. The recipe will\nuse the `yum['epel']` attributes (see above) to configure the key, url\nand download the GPG key for the repo. The defaults are detected by\nplatform and version and should just work without modification in most\nuse cases.\n\nOn all platforms except Amazon, the action is to add the repository.\nOn Amazon, the action is add and update.\n\nAmazon Linux has the EPEL repositories already added in the AMI. In\nprevious versions of this cookbook, they were enabled with\n`yum-config-manager`, however in the current version, we manage the\nrepository using the LWRP. The main difference is that the source and\ndebuginfo repositories are not available, but if they're needed, add\nthem using the `yum_repository` LWRP in your own cookbook(s).\n\n## ius\n\nInstalls the [IUS Community repositories](http://iuscommunity.org/Repos)\nvia RPM. Uses the `node['yum']['ius_release']` attribute to sele