cookbook 'compat_resource', '= 12.14.0'
The compat_resource cookbook has been deprecated
Author provided reason for deprecation:
The compat_resource cookbook has been deprecated and is no longer being maintained by its authors. Use of the compat_resource cookbook is no longer recommended.
compat_resource
(56) Versions
12.14.0
-
-
12.19.1
-
12.19.0
-
12.16.3
-
12.16.2
-
12.16.1
-
12.16.0
-
12.14.7
-
12.14.6
-
12.14.5
-
12.14.4
-
12.14.3
-
12.14.2
-
12.14.1
-
12.14.0
-
12.13.38
-
12.13.37
-
12.10.7
-
12.10.6
-
12.10.5
-
12.10.4
-
12.10.3
-
12.10.2
-
12.10.1
-
12.9.1
-
12.9.0
-
12.8.0
-
12.7.3
-
12.7.1
-
12.7.0
-
12.5.26
-
12.5.25
-
12.5.24
-
12.5.23
-
12.5.22
-
12.5.21
-
12.5.20
-
12.5.19
-
12.5.18
-
12.5.17
-
12.5.16
-
12.5.15
-
12.5.14
-
12.5.13
-
12.5.12
-
12.5.11
-
12.5.10
-
12.5.9
-
12.5.8
-
12.5.7
-
12.5.6
-
12.5.5
-
12.5.4
-
12.5.3
-
12.5.2
-
12.5.1
-
12.5.0
Follow30
- 12.19.1
- 12.19.0
- 12.16.3
- 12.16.2
- 12.16.1
- 12.16.0
- 12.14.7
- 12.14.6
- 12.14.5
- 12.14.4
- 12.14.3
- 12.14.2
- 12.14.1
- 12.14.0
- 12.13.38
- 12.13.37
- 12.10.7
- 12.10.6
- 12.10.5
- 12.10.4
- 12.10.3
- 12.10.2
- 12.10.1
- 12.9.1
- 12.9.0
- 12.8.0
- 12.7.3
- 12.7.1
- 12.7.0
- 12.5.26
- 12.5.25
- 12.5.24
- 12.5.23
- 12.5.22
- 12.5.21
- 12.5.20
- 12.5.19
- 12.5.18
- 12.5.17
- 12.5.16
- 12.5.15
- 12.5.14
- 12.5.13
- 12.5.12
- 12.5.11
- 12.5.10
- 12.5.9
- 12.5.8
- 12.5.7
- 12.5.6
- 12.5.5
- 12.5.4
- 12.5.3
- 12.5.2
- 12.5.1
- 12.5.0
Backports functionality introduced in the latest chef-client releases to any chef-client from 12.1 onwards
cookbook 'compat_resource', '= 12.14.0', :supermarket
knife supermarket install compat_resource
knife supermarket download compat_resource
compat_resource cookbook
This cookbook brings the custom resource syntax from Chef 12.5 to earlier Chef 12.X releases.
Converting cookbooks from the old resource model to the new
Boilerplate
- Depend on compat_resource
- Descend resources from ChefCompat::Resource
- Set resource_name in the class instead of the constructor
- Convert Attributes to Properties
- Rename attribute -> property
- Move set_or_return -> property
- Take kind_of/equal_to/regexes and make them types
- Use true/false/nil instead of TrueClass/FalseClass/NilClass
- Remove default: nil (it's the default)
- Convert Top-Level Providers to Actions
- Create any resources that don't already exist (for example in multi-provider cases) and descend from the base resource
- Remove allowed_actions / @actions
- @action -> default_action
- Move
provides
andaction :x
to the resource - Remove use_inline_resources and def whyrun_safe?
- Move other methods to
action_class.class_eval do
Now you have everything in a resource, are using properties, and have gotten rid
of a bunch of boilerplate. Of course, this is just getting it moved. Now you
can start to really use the new features. And if you're making resources for
the first time, congrats--you probably didn't have to do very much of this :)
Advanced Concepts
- Resource Inheritance
- Resources That Are Different On Each OS?
- Coercion: Handling User Input
- Lazy Defaults
- Using Load Current Resource
- Using Converge If Changed
- Defaults Are For Creation
- Shared types: using a type multiple places
Requirements
Platforms
- All platforms supported by Chef
Chef
- Chef 12.0+
Cookbooks
- none
Usage
To use this cookbook, put depends 'compat_resource'
in the metadata.rb of your cookbook. Once this is done, you can use all the new custom resource features to define resources. It Just Works.
For example, if you create resources/myresource.rb, myresource can use property
, load_current_value
and action
(no need to create a provider). If you want to create Resource classes directly, extend from ChefCompat::Resource
instead of Chef::Resource
. Properties, current value loading, converge_if_changed, and resource_name will all function the same across versions.
Custom Resources?
Curious about how to use custom resources? Here are the 12.5 docs:
- Docs: https://docs.chef.io/custom_resources.html
- Slides: https://docs.chef.io/decks/custom_resources.html
License & Authors
Author: John Keiser (jkeiser@chef.io)
Copyright: 2015, Chef Software, Inc.
```
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
Collaborator Number Metric
12.14.0 passed this metric
Foodcritic Metric
12.14.0 passed this metric
12.14.0 passed this metric
12.14.0 passed this metric