Chef 13 Upgrade: `knife-cookbook-doc` gem upgrade
As part of an upgrade from Chef 12 to Chef 13, this is one of the posts in which I've been detailing the issues I've encountered, and how I've resolved them .
I use the gem
knife-cookbook-doc to autogenerate documentation from my Chef cookbooks. It allows me to ensure that documentation is kept right next to source files, which promotes changing of documentation at the same time as code, as well as make it easier to keep updated as it's a task that can be automated.
However, when upgrading to Chef 13, I found that my
dependencies section had:
* #<Logger:0x0000000004397548> () (Recommended but not required) * #<Logger:0x0000000004397548> () (Suggested but not required) * Conflicts with #<Logger:0x0000000004397548> ()
Digging into the code, I found this was triggered by the
conflicting methods, which read from the corresponding
conflicts fields within the cookbook's metadata. As those fields no longer existed, a
Logger was returned, instead of the valid metadata.
chef gem install knife-cookbook-doc -v 0.25.0