Chef Cookbook升级后报错undefined local variable or method `local_path' 求助

我之前在Chef版本升级时遇到过类似的自定义资源属性报错，结合你的情况来看，这个问题几乎可以确定是Chef 14对自定义资源属性的处理规则发生了向后不兼容的变化，而你的sii_share_share资源没有适配新版本导致的。下面是具体的排查和解决思路：

可能的核心原因 #

Chef 13及更早版本对自定义资源的属性声明要求比较宽松，允许隐式使用未显式声明的属性；但Chef 14开始强制执行严格的属性声明规则——所有在资源块中使用的属性，必须在资源定义里显式声明，否则就会抛出「undefined local variable or method」的错误。

具体排查与修复步骤 #

1. 定位自定义资源的定义文件
   首先找到sii_share_share资源的定义文件，通常在你的Cookbook目录下的resources/share.rb路径（比如cookbooks/sii_share/resources/share.rb）。

2. 检查属性声明是否完整
   查看文件中是否显式声明了所有你在资源块里用到的属性，比如local_path、remote_path、fstype等。正确的属性声明格式应该类似这样：

   property :remote_path, String, required: true
   property :local_path, String, required: true
   property :fstype, String, default: 'cifs'
   property :dir_owner, String, default: 'root'
   property :dir_group, String
   property :dir_mode, String
   property :file_mode, String
   property :cifs_credentials_file, String
   

   如果你的资源定义里缺少local_path这类属性的声明，Chef 14就无法识别它，进而抛出错误。

3. 验证资源action中的属性访问方式
   检查资源的action代码（通常在providers/share.rb或者同文件的action :create块里），确保属性是通过new_resource.local_path这种方式访问的，而不是直接用local_path变量。示例如下：

   action :create do
     # 正确的属性访问方式
     directory new_resource.local_path do
       owner new_resource.dir_owner
       group new_resource.dir_group
       mode new_resource.dir_mode
       recursive true
     end
   
     # 挂载逻辑示例
     mount new_resource.local_path do
       device new_resource.remote_path
       fstype new_resource.fstype
       options "credentials=#{new_resource.cifs_credentials_file}"
       action [:mount, :enable]
     end
   end
   

   旧版本Chef可能允许直接使用变量名，但Chef 14要求必须通过new_resource对象来访问属性。

额外建议 #

• 如果sii_share_share是来自第三方社区Cookbook，先查看该Cookbook的版本说明，确认是否有兼容Chef 14的新版本，直接升级Cookbook可能是最快的解决方法。
• 测试修复后的资源时，可以先用chef-client --local-mode在本地测试，避免直接在Azure扩展中运行导致问题扩大。

内容的提问来源于stack exchange，提问作者Typh