Chef运行Recipe报错：No such cookbook问题求助

问题重现 #

执行以下命令运行Chef Recipe时触发错误：

[root@ip-17-188 cookbooks]# chef-client -zr recipe\"[test-cookbook::recipe1]\"

核心错误信息：

Error Resolving Cookbooks for Run List:
================================================================================

Missing Cookbooks:
------------------
No such cookbook: test-cookbook

可行解决方案 #

• 确认cookbook路径与Chef本地模式规则匹配
  Chef本地模式（-z/--local-mode）默认从当前目录的cookbooks子目录、上级目录的cookbooks或cookbook_path指定路径加载cookbook。

  • 检查test-cookbook是否直接位于当前工作目录（/root/cookbooks）下，即路径为/root/cookbooks/test-cookbook。
  • 若cookbook在其他路径，使用-o参数指定路径：

    chef-client -z -o /absolute/path/to/test-cookbook -r recipe[test-cookbook::recipe1]
    

• 修正命令的引号格式
  原命令的转义引号会导致run list解析异常，改为以下两种正确写法之一：

  chef-client -zr 'recipe[test-cookbook::recipe1]'
  # 或无需引号
  chef-client -zr recipe[test-cookbook::recipe1]
  

• 验证cookbook的metadata.rb文件
  Chef通过metadata.rb识别cookbook，进入test-cookbook目录，确保文件存在且包含正确的name属性：

  name 'test-cookbook'
  

  若文件名缺失或name与目录名不匹配，Chef无法识别该cookbook。

• 清理Chef本地缓存
  缓存损坏可能导致加载异常，执行以下命令清理缓存：

  rm -rf /root/.chef/local-mode-cache
  

• 检查环境变量干扰
  本地模式下无需设置CHEF_SERVER_URL，检查并取消该变量：

  echo $CHEF_SERVER_URL
  unset CHEF_SERVER_URL
  

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