From f8de3964d2001b122570794d6aedbf1d7ba247b8 Mon Sep 17 00:00:00 2001 From: Eric Renfro Date: Mon, 18 Jul 2016 22:18:31 -0400 Subject: [PATCH] Initial commit --- .gitignore | 20 +++++++ Berksfile | 7 +++ CHANGELOG.md | 5 ++ README.md | 108 ++++++++++++++++++++++++++++++++++++ attributes/default.rb | 1 + attributes/rsyslog-devel.rb | 10 ++++ attributes/rsyslog.rb | 10 ++++ metadata.rb | 18 ++++++ recipes/default.rb | 51 +++++++++++++++++ 9 files changed, 230 insertions(+) create mode 100644 .gitignore create mode 100644 Berksfile create mode 100644 CHANGELOG.md create mode 100644 README.md create mode 100644 attributes/default.rb create mode 100644 attributes/rsyslog-devel.rb create mode 100644 attributes/rsyslog.rb create mode 100644 metadata.rb create mode 100644 recipes/default.rb diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..cbccf1e --- /dev/null +++ b/.gitignore @@ -0,0 +1,20 @@ +*~ +*# +.#* +\#*# +.*.sw[a-z] +*.un~ +pkg/ + +# Berkshelf +.vagrant +/cookbooks +Berksfile.lock + +# Bundler +Gemfile.lock +bin/* +.bundle/* + +.kitchen/ +.kitchen.local.yml diff --git a/Berksfile b/Berksfile new file mode 100644 index 0000000..db75d7b --- /dev/null +++ b/Berksfile @@ -0,0 +1,7 @@ +source "https://supermarket.chef.io" + +metadata + +cookbook "yum", "~> 3.10.0" +cookbook "yum-epel", "~> 0.6.6" + diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..e0a034b --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,5 @@ +# yum-rsyslog Cookbook CHANGELOG +This file is used to list changes made in each version of the yum-rsyslog cookbook. + +## v0.1.0 +initial release diff --git a/README.md b/README.md new file mode 100644 index 0000000..cfddafd --- /dev/null +++ b/README.md @@ -0,0 +1,108 @@ +# yum-rsyslog Cookbook + +The yum-rsyslog cookbook takes over management of the default repositoryids that ship with CentOS systems. It allows attribute manipulation of `rsyslog`, `rsyslog-devel` + +## Requirements +### Platforms +- RHEL/CentOS and derivatives + +### Chef +- Chef 11+ + +### Cookbooks +- yum version 3.2.0 or higher +- yum-epel + +## Attributes +The following attributes are set by default + +```ruby +default['yum']['rsyslog']['repositoryid'] = 'rsyslog' +default['yum']['rsyslog']['enabled'] = true +default['yum']['rsyslog']['managed'] = true +default['yum']['rsyslog']['gpgkey'] = 'http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon' +default['yum']['rsyslog']['gpgcheck'] = true +default['yum']['rsyslog']['release_repo'] = 8 +default['yum']['rsyslog']['description'] = 'Adiscon Rsyslog v8-stable for CentOS-$releasever-$basearch' +default['yum']['rsyslog']['baseurl'] = 'http://rpms.adiscon.com/v8-stable/epel-$releasever/$basearch' +``` + +```ruby +default['yum']['rsyslog-devel']['repositoryid'] = 'rsyslog-devel' +default['yum']['rsyslog-devel']['enabled'] = false +default['yum']['rsyslog-devel']['managed'] = false +default['yum']['rsyslog-devel']['gpgkey'] = 'http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon' +default['yum']['rsyslog-devel']['gpgcheck'] = true +default['yum']['rsyslog-devel']['release_repo'] = 8 +default['yum']['rsyslog-devel']['description'] = 'Adiscon Rsyslog v8-stable for CentOS-$releasever-$basearch' +default['yum']['rsyslog-devel']['baseurl'] = 'http://rpms.adiscon.com/v8-stable/epel-$releasever/$basearch' +``` + +## Recipes +- default - Walks through node attributes and feeds a yum_resource +- parameters. The following is an example a resource generated by the +- recipe during compilation. + +```ruby + yum_repository 'rsyslog' do + baseurl 'http://rpms.adiscon.com/v8-stable/epel-$releasever/$basearch' + description 'Adiscon Rsyslog v8-stable for CentOS-$releasever-$basearch' + enabled true + gpgcheck true + gpgkey 'http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon' + end +``` + +## Usage Example +To disable the `rsyslog` repository through a Role or Environment definition + +``` +default_attributes( + 'yum' => { + 'rsyslog' => { + 'enabled' => false + } + } +) +``` + +Uncommonly used repositoryids are not managed by default. This is speeds up integration testing pipelines by avoiding yum-cache builds that nobody cares about. To enable the `rsyslog-devel` repository with a wrapper cookbook, place the following in a recipe: + +``` +node.default['yum']['rsyslog-devel']['managed'] = true +node.default['yum']['rsyslog-devel']['enabled'] = true +include_recipe 'yum-rsyslog' +``` + +## More Examples +Point the base and debuginfo repositories at an internally hosted server. + +``` +node.default['yum']['rsyslog']['enabled'] = true +node.default['yum']['rsyslog']['baseurl'] = 'https://internal.example.com/centos/6/os/x86_64' +node.default['yum']['rsyslog']['sslverify'] = false +node.default['yum']['rsyslog-devel']['enabled'] = true +node.default['yum']['rsyslog-devel']['baseurl'] = 'https://internal.example.com/centos/6/updates/x86_64' +node.default['yum']['rsyslog-devel']['sslverify'] = false + +include_recipe 'yum-rsyslog' +``` + +## License & Authors +**Author:** Eric Renfro () + +**Copyright:** 2016, Linux-Help.org. + +``` +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. +``` diff --git a/attributes/default.rb b/attributes/default.rb new file mode 100644 index 0000000..deec917 --- /dev/null +++ b/attributes/default.rb @@ -0,0 +1 @@ +default['yum-rsyslog']['repositories'] = %w(rsyslog rsyslog-devel) diff --git a/attributes/rsyslog-devel.rb b/attributes/rsyslog-devel.rb new file mode 100644 index 0000000..cbfe88e --- /dev/null +++ b/attributes/rsyslog-devel.rb @@ -0,0 +1,10 @@ +default['yum']['rsyslog-devel']['repositoryid'] = 'rsyslog-devel' +default['yum']['rsyslog-devel']['enabled'] = false +default['yum']['rsyslog-devel']['managed'] = false +default['yum']['rsyslog-devel']['gpgkey'] = 'http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon' +default['yum']['rsyslog-devel']['gpgcheck'] = true +default['yum']['rsyslog-devel']['release_repo'] = '8' + +default['yum']['rsyslog-devel']['description'] = "Adiscon Rsyslog v#{node['yum']['rsyslog-devel']['release_repo']}-devel for CentOS-$releasever-$basearch" +default['yum']['rsyslog-devel']['baseurl'] = "http://rpms.adiscon.com/v#{node['yum']['rsyslog-devel']['release_repo']}-devel/epel-$releasever/$basearch" + diff --git a/attributes/rsyslog.rb b/attributes/rsyslog.rb new file mode 100644 index 0000000..40e04d2 --- /dev/null +++ b/attributes/rsyslog.rb @@ -0,0 +1,10 @@ +default['yum']['rsyslog']['repositoryid'] = 'rsyslog' +default['yum']['rsyslog']['enabled'] = true +default['yum']['rsyslog']['managed'] = true +default['yum']['rsyslog']['gpgkey'] = 'http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon' +default['yum']['rsyslog']['gpgcheck'] = true +default['yum']['rsyslog']['release_repo'] = '8' + +default['yum']['rsyslog']['description'] = "Adiscon Rsyslog v#{node['yum']['rsyslog']['release_repo']}-stable for CentOS-$releasever-$basearch" +default['yum']['rsyslog']['baseurl'] = "http://rpms.adiscon.com/v#{node['yum']['rsyslog']['release_repo']}-stable/epel-$releasever/$basearch" + diff --git a/metadata.rb b/metadata.rb new file mode 100644 index 0000000..bca31cd --- /dev/null +++ b/metadata.rb @@ -0,0 +1,18 @@ +name 'yum-rsyslog' +maintainer 'Eric Renfro' +maintainer_email 'psi-jack@linux-help.org' +license 'Apache 2.0' +description 'Installs and configures the Official Rsyslog Yum Repository' +long_description '' +version '0.1.1' +issues_url 'http://gogs.home.ld/Linux-Help/cookbook-yum-rsyslog/issues' +source_url 'http://gogs.home.ld/Linux-Help/cookbook-yum-rsyslog' + + +%w{ centos redhat oracle scientific }.each do |os| + supports os, '>= 5.0.0' +end + +depends 'yum', '>= 3.2' +depends 'yum-epel', '>= 0.0.0' + diff --git a/recipes/default.rb b/recipes/default.rb new file mode 100644 index 0000000..8ae0b35 --- /dev/null +++ b/recipes/default.rb @@ -0,0 +1,51 @@ +# +# Author:: Eric Renfro () +# Recipe:: yum-rsyslog::default +# +# 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. + +node['yum-rsyslog']['repositories'].each do |repo| + next unless node['yum'][repo]['managed'] + include_recipe 'yum-epel' unless run_context.loaded_recipe?('yum-epel') + + yum_repository repo do + description node['yum'][repo]['description'] unless node['yum'][repo]['description'].nil? + baseurl node['yum'][repo]['baseurl'] unless node['yum'][repo]['baseurl'].nil? + mirrorlist node['yum'][repo]['mirrorlist'] unless node['yum'][repo]['mirrorlist'].nil? + gpgcheck node['yum'][repo]['gpgcheck'] unless node['yum'][repo]['gpgcheck'].nil? + gpgkey node['yum'][repo]['gpgkey'] unless node['yum'][repo]['gpgkey'].nil? + enabled node['yum'][repo]['enabled'] unless node['yum'][repo]['enabled'].nil? + cost node['yum'][repo]['cost'] unless node['yum'][repo]['cost'].nil? + exclude node['yum'][repo]['exclude'] unless node['yum'][repo]['exclude'].nil? + enablegroups node['yum'][repo]['enablegroups'] unless node['yum'][repo]['enablegroups'].nil? + failovermethod node['yum'][repo]['failovermethod'] unless node['yum'][repo]['failovermethod'].nil? + http_caching node['yum'][repo]['http_caching'] unless node['yum'][repo]['http_caching'].nil? + include_config node['yum'][repo]['include_config'] unless node['yum'][repo]['include_config'].nil? + includepkgs node['yum'][repo]['includepkgs'] unless node['yum'][repo]['includepkgs'].nil? + keepalive node['yum'][repo]['keepalive'] unless node['yum'][repo]['keepalive'].nil? + max_retries node['yum'][repo]['max_retries'] unless node['yum'][repo]['max_retries'].nil? + metadata_expire node['yum'][repo]['metadata_expire'] unless node['yum'][repo]['metadata_expire'].nil? + mirror_expire node['yum'][repo]['mirror_expire'] unless node['yum'][repo]['mirror_expire'].nil? + priority node['yum'][repo]['priority'] unless node['yum'][repo]['priority'].nil? + proxy node['yum'][repo]['proxy'] unless node['yum'][repo]['proxy'].nil? + proxy_username node['yum'][repo]['proxy_username'] unless node['yum'][repo]['proxy_username'].nil? + proxy_password node['yum'][repo]['proxy_password'] unless node['yum'][repo]['proxy_password'].nil? + repositoryid node['yum'][repo]['repositoryid'] unless node['yum'][repo]['repositoryid'].nil? + sslcacert node['yum'][repo]['sslcacert'] unless node['yum'][repo]['sslcacert'].nil? + sslclientcert node['yum'][repo]['sslclientcert'] unless node['yum'][repo]['sslclientcert'].nil? + sslclientkey node['yum'][repo]['sslclientkey'] unless node['yum'][repo]['sslclientkey'].nil? + sslverify node['yum'][repo]['sslverify'] unless node['yum'][repo]['sslverify'].nil? + timeout node['yum'][repo]['timeout'] unless node['yum'][repo]['timeout'].nil? + action :create + end +end