server_maint 0.0.2 → 0.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (76) hide show
  1. data/.gitmodules +12 -0
  2. data/lib/cookbooks/apt/.gitignore +4 -0
  3. data/lib/cookbooks/apt/CHANGELOG.md +25 -0
  4. data/lib/cookbooks/apt/CONTRIBUTING +29 -0
  5. data/lib/cookbooks/apt/Gemfile +3 -0
  6. data/lib/cookbooks/apt/LICENSE +201 -0
  7. data/lib/cookbooks/apt/README.md +193 -0
  8. data/lib/cookbooks/apt/files/default/apt-proxy-v2.conf +50 -0
  9. data/lib/cookbooks/apt/metadata.rb +13 -0
  10. data/lib/cookbooks/apt/providers/preference.rb +52 -0
  11. data/lib/cookbooks/apt/providers/repository.rb +128 -0
  12. data/lib/cookbooks/apt/recipes/cacher-client.rb +54 -0
  13. data/lib/cookbooks/apt/recipes/cacher-ng.rb +30 -0
  14. data/lib/cookbooks/apt/recipes/default.rb +68 -0
  15. data/lib/cookbooks/apt/resources/preference.rb +29 -0
  16. data/lib/cookbooks/apt/resources/repository.rb +39 -0
  17. data/lib/cookbooks/apt/test/kitchen/Kitchenfile +3 -0
  18. data/lib/cookbooks/php/.gitignore +4 -0
  19. data/lib/cookbooks/php/CHANGELOG.md +14 -0
  20. data/lib/cookbooks/php/CONTRIBUTING +29 -0
  21. data/lib/cookbooks/php/Gemfile +3 -0
  22. data/lib/cookbooks/php/LICENSE +201 -0
  23. data/lib/cookbooks/php/README.md +253 -0
  24. data/lib/cookbooks/php/attributes/default.rb +86 -0
  25. data/lib/cookbooks/php/metadata.rb +27 -0
  26. data/lib/cookbooks/php/providers/pear.rb +261 -0
  27. data/lib/cookbooks/php/providers/pear_channel.rb +90 -0
  28. data/lib/cookbooks/php/recipes/default.rb +31 -0
  29. data/lib/cookbooks/php/recipes/module_apc.rb +37 -0
  30. data/lib/cookbooks/php/recipes/module_curl.rb +29 -0
  31. data/lib/cookbooks/php/recipes/module_fileinfo.rb +29 -0
  32. data/lib/cookbooks/php/recipes/module_fpdf.rb +35 -0
  33. data/lib/cookbooks/php/recipes/module_gd.rb +32 -0
  34. data/lib/cookbooks/php/recipes/module_ldap.rb +32 -0
  35. data/lib/cookbooks/php/recipes/module_memcache.rb +37 -0
  36. data/lib/cookbooks/php/recipes/module_mysql.rb +32 -0
  37. data/lib/cookbooks/php/recipes/module_pgsql.rb +32 -0
  38. data/lib/cookbooks/php/recipes/module_sqlite3.rb +30 -0
  39. data/lib/cookbooks/php/recipes/package.rb +43 -0
  40. data/lib/cookbooks/php/recipes/source.rb +79 -0
  41. data/lib/cookbooks/php/resources/pear.rb +30 -0
  42. data/lib/cookbooks/php/resources/pear_channel.rb +29 -0
  43. data/lib/cookbooks/php/templates/centos/php.ini.erb +1225 -0
  44. data/lib/cookbooks/php/templates/debian/php.ini.erb +1857 -0
  45. data/lib/cookbooks/php/templates/default/extension.ini.erb +7 -0
  46. data/lib/cookbooks/php/templates/default/php.ini.erb +1900 -0
  47. data/lib/cookbooks/php/templates/redhat/php.ini.erb +1225 -0
  48. data/lib/cookbooks/php/templates/ubuntu/php.ini.erb +1857 -0
  49. data/lib/cookbooks/php/test/kitchen/Kitchenfile +3 -0
  50. data/lib/cookbooks/php-fpm/.gitignore +1 -0
  51. data/lib/cookbooks/php-fpm/README.md +65 -0
  52. data/lib/cookbooks/php-fpm/metadata.rb +14 -0
  53. data/lib/cookbooks/php-fpm/recipes/default.rb +98 -0
  54. data/lib/cookbooks/yum/.gitignore +1 -0
  55. data/lib/cookbooks/yum/CHANGELOG.md +48 -0
  56. data/lib/cookbooks/yum/CONTRIBUTING +29 -0
  57. data/lib/cookbooks/yum/Gemfile +3 -0
  58. data/lib/cookbooks/yum/LICENSE +201 -0
  59. data/lib/cookbooks/yum/README.md +197 -0
  60. data/lib/cookbooks/yum/attributes/default.rb +37 -0
  61. data/lib/cookbooks/yum/metadata.rb +36 -0
  62. data/lib/cookbooks/yum/providers/key.rb +74 -0
  63. data/lib/cookbooks/yum/providers/repository.rb +111 -0
  64. data/lib/cookbooks/yum/recipes/default.rb +18 -0
  65. data/lib/cookbooks/yum/recipes/epel.rb +55 -0
  66. data/lib/cookbooks/yum/recipes/ius.rb +40 -0
  67. data/lib/cookbooks/yum/recipes/repoforge.rb +48 -0
  68. data/lib/cookbooks/yum/recipes/yum.rb +23 -0
  69. data/lib/cookbooks/yum/resources/key.rb +24 -0
  70. data/lib/cookbooks/yum/resources/repository.rb +38 -0
  71. data/lib/cookbooks/yum/templates/default/repo.erb +29 -0
  72. data/lib/cookbooks/yum/templates/default/yum-rhel5.conf.erb +33 -0
  73. data/lib/cookbooks/yum/templates/default/yum-rhel6.conf.erb +36 -0
  74. data/lib/cookbooks/yum/test/kitchen/Kitchenfile +23 -0
  75. data/lib/server_maint/version.rb +1 -1
  76. metadata +77 -4
@@ -0,0 +1,3 @@
1
+ cookbook "php" do
2
+ runtimes []
3
+ end
@@ -0,0 +1 @@
1
+ metadata.json
@@ -0,0 +1,65 @@
1
+ Description
2
+ ===========
3
+
4
+ Installs and configures PHP-FPM (FastCGI Process Manager), an alternative PHP FastCGI implementation with some additional features useful for sites of any size, especially busier sites. It's like the `unicorn` of the PHP world dawg.
5
+
6
+ Requirements
7
+ ============
8
+
9
+ Platform
10
+ --------
11
+
12
+ * Debian, Ubuntu
13
+ * CentOS, Red Hat, Fedora
14
+
15
+ Cookbooks
16
+ ---------
17
+
18
+ * php
19
+ * apt (leverages apt_repository LWRP)
20
+ * yum (leverages yum_repository LWRP)
21
+
22
+ The `apt_repository` and `yum_repository` LWRPs are used from these cookbooks to create the proper repository entries so the php-fpm package downloaded and installed.
23
+
24
+ Attributes
25
+ ==========
26
+
27
+ TODO: FINISH THIS LWRP
28
+
29
+ This cookbook includes LWRPs for managing PHP-FPM config files.
30
+
31
+ `php-fpm_config`
32
+ -----------------
33
+
34
+ Creates a PHP-FPM configuration file at the path specified. Meant to be deployed with a service init scheme/supervisor such as runit. Please see the `appliation::php-fpm` recipe for a complete working example. In depth information about PHP-FPM's configuration values can be [found in the PHP-FPM documentation](http://php-fpm.org/wiki/Configuration_File).
35
+
36
+ # Actions
37
+
38
+ - :create: create a PHP-FPM configuration file.
39
+ - :delete: delete an existing PHP-FPM configuration file.
40
+
41
+ # Attributes
42
+
43
+ Usage
44
+ =====
45
+
46
+ Simply include the recipe where you want PHP-FPM installed.
47
+
48
+ License and Author
49
+ ==================
50
+
51
+ Author:: Seth Chisamore (<schisamo@opscode.com>)
52
+
53
+ Copyright:: 2011, Opscode, Inc
54
+
55
+ Licensed under the Apache License, Version 2.0 (the "License");
56
+ you may not use this file except in compliance with the License.
57
+ You may obtain a copy of the License at
58
+
59
+ http://www.apache.org/licenses/LICENSE-2.0
60
+
61
+ Unless required by applicable law or agreed to in writing, software
62
+ distributed under the License is distributed on an "AS IS" BASIS,
63
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
64
+ See the License for the specific language governing permissions and
65
+ limitations under the License.
@@ -0,0 +1,14 @@
1
+ maintainer "Opscode, Inc."
2
+ maintainer_email "cookbooks@opscode.com"
3
+ license "Apache 2.0"
4
+ description "Installs/Configures php-fpm"
5
+ long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
6
+ version "0.2.4"
7
+
8
+ depends "php"
9
+ depends "apt"
10
+ depends "yum"
11
+
12
+ %w{ debian ubuntu centos redhat fedora }.each do |os|
13
+ supports os
14
+ end
@@ -0,0 +1,98 @@
1
+ #
2
+ # Author:: Seth Chisamore (<schisamo@opscode.com>)
3
+ # Cookbook Name:: php-fpm
4
+ # Recipe:: default
5
+ #
6
+ # Copyright 2011, Opscode, Inc.
7
+ #
8
+ # Licensed under the Apache License, Version 2.0 (the "License");
9
+ # you may not use this file except in compliance with the License.
10
+ # You may obtain a copy of the License at
11
+ #
12
+ # http://www.apache.org/licenses/LICENSE-2.0
13
+ #
14
+ # Unless required by applicable law or agreed to in writing, software
15
+ # distributed under the License is distributed on an "AS IS" BASIS,
16
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17
+ # See the License for the specific language governing permissions and
18
+ # limitations under the License.
19
+ #
20
+
21
+ case node['platform']
22
+ when 'ubuntu'
23
+ if node['platform_version'].to_f <= 10.04
24
+ # Configure Brian's PPA
25
+ # We'll install php5-fpm from the Brian's PPA backports
26
+ apt_repository "brianmercer-php" do
27
+ uri "http://ppa.launchpad.net/brianmercer/php5/ubuntu"
28
+ distribution node['lsb']['codename']
29
+ components ["main"]
30
+ keyserver "keyserver.ubuntu.com"
31
+ key "8D0DC64F"
32
+ action :add
33
+ end
34
+ # FIXME: apt-get update didn't trigger in above
35
+ execute "apt-get update"
36
+ end
37
+ when 'debian'
38
+ # Configure Dotdeb repos
39
+ # TODO: move this to it's own 'dotdeb' cookbook?
40
+ # http://www.dotdeb.org/instructions/
41
+ if node.platform_version.to_f >= 5.0
42
+ apt_repository "dotdeb" do
43
+ uri "http://packages.dotdeb.org"
44
+ distribution "stable"
45
+ components ['all']
46
+ key "http://www.dotdeb.org/dotdeb.gpg"
47
+ action :add
48
+ end
49
+ else
50
+ apt_repository "dotdeb" do
51
+ uri "http://packages.dotdeb.org"
52
+ distribution "oldstable"
53
+ components ['all']
54
+ key "http://www.dotdeb.org/dotdeb.gpg"
55
+ action :add
56
+ end
57
+ apt_repository "dotdeb-php53" do
58
+ uri "http://php53.dotdeb.org"
59
+ distribution "oldstable"
60
+ components ['all']
61
+ key "http://www.dotdeb.org/dotdeb.gpg"
62
+ action :add
63
+ end
64
+ end
65
+ when 'centos', 'redhat', 'fedora'
66
+ # Configure IUS repo
67
+ # http://rob.olmos.name/2010/08/centos-5-5-php-5-3-3-php-fpm-nginx-rpms/
68
+ # TODO: verify this is the best repo
69
+ yum_repository "ius" do
70
+ url "http://dl.iuscommunity.org/pub/ius/stable/Redhat/5.5/$basearch"
71
+ action :add
72
+ end
73
+ end
74
+
75
+ pkgs = value_for_platform(
76
+ %w{ centos redhat fedora } => {
77
+ "default" => %w{ php53u-fpm and php53u-pecl-apc }
78
+ },
79
+ %w{ debian ubuntu } => {
80
+ "default" => %w{ php5-cgi php5-fpm }
81
+ },
82
+ "default" => %w{ php5-cgi php5-fpm }
83
+ )
84
+
85
+ unless platform?(%w{ centos redhat fedora })
86
+ # TODO: look into the php53u-*/php53-* conflict
87
+ require_recipe 'php::default'
88
+ end
89
+
90
+ pkgs.each do |pkg|
91
+ package pkg do
92
+ action :upgrade
93
+ end
94
+ end
95
+
96
+ service "php5-fpm" do
97
+ action [ :enable, :start ]
98
+ end
@@ -0,0 +1 @@
1
+ *.sw[op]
@@ -0,0 +1,48 @@
1
+ ## v1.0.0:
2
+
3
+ `mirrorlist` in the `yum_repository` LWRP must be set to the mirror
4
+ list URI to use rather than setting it to true. See README.md.
5
+
6
+ * [COOK-1088] - use dl.fedoraproject.org for EPEL to prevent redirects
7
+ * [COOK-1653] - fix mirrorlist
8
+ * [COOK-1710] - support http proxy
9
+ * [COOK-1722] - update IUS version
10
+
11
+ ## v0.8.2:
12
+
13
+ * [COOK-1521] - add :update action to `yum_repository`
14
+
15
+ ## v0.8.0:
16
+
17
+ * [COOK-1204] - Make 'add' default action for yum_repository
18
+ * [COOK-1351] - option to not make the yum cache (via attribute)
19
+ * [COOK-1353] - x86_64 centos path fixes
20
+ * [COOK-1414] - recipe for repoforge
21
+
22
+
23
+ ## v0.6.2:
24
+
25
+ * Updated README to remove git diff artifacts.
26
+
27
+ ## v0.6.0:
28
+
29
+ * Default action for the yum_repository LWRP is now add.
30
+ * [COOK-1227] - clear Chefs internal cache after adding new yum repo
31
+ * [COOK-1262] - yum::epel should enable existing repo on Amazon Linux
32
+ * [COOK-1272], [COOK-1302] - update RPM file for CentOS / RHEL 6
33
+ * [COOK-1330] - update cookbook documentation on excludes for yum
34
+ * [COOK-1346] - retry remote_file for EPEL in case we get an FTP mirror
35
+
36
+
37
+ ## v0.5.2:
38
+
39
+ * [COOK-825] - epel and ius `remote_file` should notify the `rpm_package` to install
40
+
41
+ ## v0.5.0:
42
+
43
+ * [COOK-675] - add recipe for handling EPEL repository
44
+ * [COOK-722] - add recipe for handling IUS repository
45
+
46
+ ## v.0.1.2:
47
+
48
+ * Remove yum update in default recipe, that doesn't update caches, it updates packages installed.
@@ -0,0 +1,29 @@
1
+ If you would like to contribute, please open a ticket in JIRA:
2
+
3
+ * http://tickets.opscode.com
4
+
5
+ Create the ticket in the COOK project and use the cookbook name as the
6
+ component.
7
+
8
+ For all code contributions, we ask that contributors sign a
9
+ contributor license agreement (CLA). Instructions may be found here:
10
+
11
+ * http://wiki.opscode.com/display/chef/How+to+Contribute
12
+
13
+ When contributing changes to individual cookbooks, please do not
14
+ modify the version number in the metadata.rb. Also please do not
15
+ update the CHANGELOG.md for a new version. Not all changes to a
16
+ cookbook may be merged and released in the same versions. Opscode will
17
+ handle the version updates during the release process. You are welcome
18
+ to correct typos or otherwise make updates to documentation in the
19
+ README.
20
+
21
+ If a contribution adds new platforms or platform versions, indicate
22
+ such in the body of the commit message(s), and update the relevant
23
+ COOK ticket. When writing commit messages, it is helpful for others if
24
+ you indicate the COOK ticket. For example:
25
+
26
+ git commit -m '[COOK-1041] Updated pool resource to correctly delete.'
27
+
28
+ In the ticket itself, it is also helpful if you include log output of
29
+ a successful Chef run, but this is not absolutely required.
@@ -0,0 +1,3 @@
1
+ source :rubygems
2
+
3
+ gem 'test-kitchen'
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright [yyyy] [name of copyright owner]
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
@@ -0,0 +1,197 @@
1
+ # Description
2
+
3
+ Configures various YUM components on Red Hat-like systems. Includes
4
+ LWRP for managing repositories and their GPG keys.
5
+
6
+ Based on the work done by Eric Wolfe and Charles Duffy on the
7
+ [yumrepo](https://github.com/atomic-penguin/cookbook-yumrepo) cookbook.
8
+
9
+ # Requirements
10
+
11
+ RedHat Enterprise Linux 5, and 6 distributions within this platform family.
12
+
13
+ # Attributes
14
+
15
+ * `yum['exclude']`
16
+ - An array containing a list of packages to exclude from updates or
17
+ installs. Wildcards and shell globs are supported.
18
+ - Defaults to an empty exclude list.
19
+
20
+ * `yum['installonlypkgs']`
21
+ - An array containing a list of packages which should only be
22
+ installed, never updated.
23
+ - Defaults to an empty install-only list.
24
+
25
+ * `yum['epel_release']`
26
+ - Set the epel release version based on `node['platform_version']`.
27
+ - Defaults to the most current release of EPEL, based on the major
28
+ version of your platform release.
29
+
30
+ * `yum['ius_release']`
31
+ - Set the IUS release to install.
32
+ - Defaults to the current release of the IUS repo.
33
+
34
+ Proxy settings used in yum.conf on RHEL family 5 and 6:
35
+
36
+ * `yum['proxy']`
37
+ - Set the URL for an HTTP proxy
38
+ - None of the proxy settings are used if this is an empty string (default)
39
+
40
+ * `yum['proxy_username']`
41
+ - Set the username for the proxy
42
+ - not used if `yum['proxy']` above is an empty string
43
+
44
+ * `yum['proxy_password']`
45
+ - Set the password for the proxy
46
+ - not used if `yum['proxy']` above is an empty string
47
+
48
+ # Recipes
49
+
50
+ ## default
51
+
52
+ The default recipe does nothing.
53
+
54
+ ## yum
55
+
56
+ Manages the configuration of the `/etc/yum.conf` via attributes. See
57
+ the aforementioned Array attributes `yum['exclude']` and
58
+ `yum['installonlypkgs']`.
59
+
60
+ ## epel
61
+
62
+ Installs the EPEL repository via RPM. Uses the `yum['epel_release']`
63
+ attribute to select the right version of the repository package to
64
+ install. Also uses the node's platform version (as an integer) for the
65
+ major release of EL.
66
+
67
+ On Amazon Linux, the built-in EPEL repository is activated using
68
+ `yum-config-manager --quiet --enable epel`. This ignores the
69
+ `node['yum']['epel_release']` attribute in favor of the version
70
+ configured in the Amazon Linux AMI.
71
+
72
+ ## ius
73
+
74
+ Installs the [IUS Community repositories](http://iuscommunity.org/Repos)
75
+ via RPM. Uses the `node['yum']['ius_release']` attribute to select the
76
+ right versino of the package to install.
77
+
78
+ The IUS repository requires EPEL, and includes `yum::epel` as a
79
+ dependency.
80
+
81
+ # Resources/Providers
82
+
83
+ ## key
84
+
85
+ This LWRP handles importing GPG keys for YUM repositories. Keys can be
86
+ imported by the `url` parameter or placed in `/etc/pki/rpm-gpg/` by a
87
+ recipe and then installed with the LWRP without passing the URL.
88
+
89
+ ### Actions
90
+
91
+ - :add: installs the GPG key into `/etc/pki/rpm-gpg/`
92
+ - :remove: removes the GPG key from `/etc/pki/rpm-gpg/`
93
+
94
+ #### Attribute Parameters
95
+
96
+ - key: name attribute. The name of the GPG key to install.
97
+ - url: if the key needs to be downloaded, the URL providing the download.
98
+
99
+ #### Example
100
+
101
+ ``` ruby
102
+ # add the Zenoss GPG key
103
+ yum_key "RPM-GPG-KEY-zenoss" do
104
+ url "http://dev.zenoss.com/yum/RPM-GPG-KEY-zenoss"
105
+ action :add
106
+ end
107
+
108
+ # remove Zenoss GPG key
109
+ yum_key "RPM-GPG-KEY-zenoss" do
110
+ action :remove
111
+ end
112
+ ```
113
+
114
+ ### repository
115
+
116
+ This LWRP provides an easy way to manage additional YUM repositories.
117
+ GPG keys can be managed with the `key` LWRP. The LWRP automatically
118
+ updates the package management cache upon the first run, when a new
119
+ repo is added.
120
+
121
+ #### Actions
122
+
123
+ - :add: creates a repository file and builds the repository listing (default)
124
+ - :remove: removes the repository file
125
+ - :update: updates the repository
126
+
127
+ #### Attribute Parameters
128
+
129
+ - repo_name: name attribute. The name of the channel to discover
130
+ - description. The description of the repository
131
+ - url: The URL providing the packages, used for baseurl in the config
132
+ - mirrorlist: Set this as a string containing the URI to the
133
+ mirrorlist, start with "http://", "ftp://", "file://"; use "file://"
134
+ if the mirrorlist is a text file on the system.
135
+ - key: Optional, the name of the GPG key file installed by the `key`
136
+ LWRP.
137
+ - enabled: Default is `1`, set to `0` if the repository is disabled.
138
+ - type: Optional, alternate type of repository
139
+ - failovermethod: Optional, failovermethod
140
+ - bootstrapurl: Optional, bootstrapurl
141
+ - make_cache: Optional, Default is `true`, if `false` then `yum -q
142
+ makecache` will not be ran
143
+
144
+ *Note*: When using both url (to set baseurl) and mirrorlist, it is probably a
145
+ good idea to also install the fastestmirror plugin, and use
146
+ failovermethod "priority".
147
+
148
+ ### Example
149
+
150
+ ``` ruby
151
+ # add the Zenoss repository
152
+ yum_repository "zenoss" do
153
+ description "Zenoss Stable repo"
154
+ url "http://dev.zenoss.com/yum/stable/"
155
+ key "RPM-GPG-KEY-zenoss"
156
+ action :add
157
+ end
158
+
159
+ # remove Zenoss repo
160
+ yum_repository "zenoss" do
161
+ action :remove
162
+ end
163
+ ```
164
+
165
+ # Usage
166
+
167
+ Put `recipe[yum::yum]` in the run list to ensure yum is configured
168
+ correctly for your environment within your Chef run.
169
+
170
+ Use the `yum::epel` recipe to enable EPEL, or the `yum::ius` recipe to
171
+ enable IUS, per __Recipes__ section above.
172
+
173
+ You can manage GPG keys either with cookbook_file in a recipe if you
174
+ want to package it with a cookbook or use the `url` parameter of the
175
+ `key` LWRP.
176
+
177
+ # License and Author
178
+
179
+ Author:: Eric G. Wolfe
180
+ Author:: Matt Ray (<matt@opscode.com>)
181
+ Author:: Joshua Timberman (<joshua@opscode.com>)
182
+
183
+ Copyright:: 2010 Tippr Inc.
184
+ Copyright:: 2011 Eric G. Wolfe
185
+ Copyright:: 2011 Opscode, Inc.
186
+
187
+ Licensed under the Apache License, Version 2.0 (the "License");
188
+ you may not use this file except in compliance with the License.
189
+ You may obtain a copy of the License at
190
+
191
+ http://www.apache.org/licenses/LICENSE-2.0
192
+
193
+ Unless required by applicable law or agreed to in writing, software
194
+ distributed under the License is distributed on an "AS IS" BASIS,
195
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
196
+ See the License for the specific language governing permissions and
197
+ limitations under the License.