Chef中tar命令-C参数执行失败问题排查

我来帮你排查这个问题——这种情况在Chef食谱里挺常见的，看似文件和目录都在，但命令就是找不到，通常是几个容易忽略的细节导致的。先把你的代码贴出来方便参考：

execute "#{node['ffmpeg']['yasm']}.tar.gz" do
  command "tar -xzvf /tmp/#{node['ffmpeg']['yasm']}.tar.gz -C #{node['ffmpeg']['source_files']}"
end

可能的问题原因及解决方法 #

1. Chef属性插值出错，导致文件名/路径不符 #

这是最常见的原因：node['ffmpeg']['yasm']这个属性的值可能不是你预期的文件名——比如拼写错误、属性没正确加载，或者属性值里包含了多余的字符（比如路径前缀），导致拼接后的文件名和实际文件不匹配。

解决方法：

• 先验证属性值是否正确，在食谱里加个日志输出排查：

  log "Debug: yasm filename from attribute is #{node['ffmpeg']['yasm']}" do
    level :info
  end
  

  运行Chef后查看日志，确认输出的文件名和/tmp下的实际文件名完全一致。
• 检查你的属性文件（比如attributes/default.rb），确保default['ffmpeg']['yasm']的设置正确，没有拼写错误或者多余的路径。

2. Execute资源执行时机过早，文件还未下载到/tmp #

如果这个tar.gz文件是通过remote_file或cookbook_file在后续步骤才下载到/tmp的，那execute资源会先于下载步骤执行，自然找不到文件——Chef默认按资源定义顺序执行，但如果依赖关系没处理好就会出问题。

解决方法：

• 给execute资源添加依赖，确保它在文件下载完成后再执行。比如你用remote_file下载文件：

  # 先定义下载文件的资源
  remote_file "/tmp/#{node['ffmpeg']['yasm']}.tar.gz" do
    source "http://your-source-url/#{node['ffmpeg']['yasm']}.tar.gz"
    action :create
  end
  
  # 定义解压的execute资源，依赖上面的remote_file
  execute "extract_yasm_tarball" do
    command "tar -xzvf /tmp/#{node['ffmpeg']['yasm']}.tar.gz -C #{node['ffmpeg']['source_files']}"
    # 当remote_file更新时触发执行
    subscribes :run, "remote_file[/tmp/#{node['ffmpeg']['yasm']}.tar.gz]", :immediately
    # 只有文件存在时才执行，避免无意义报错
    only_if { ::File.exist?("/tmp/#{node['ffmpeg']['yasm']}.tar.gz") }
  end
  

3. 路径包含特殊字符/空格，命令解析出错 #

如果node['ffmpeg']['yasm']或者目标目录路径里有空格、特殊字符，tar命令会把路径拆分成多个参数，导致无法识别完整的文件路径。

解决方法：

• 给命令里的路径加上引号，确保shell正确解析完整路径：

  execute "extract_yasm_tarball" do
    command "tar -xzvf \"/tmp/#{node['ffmpeg']['yasm']}.tar.gz\" -C \"#{node['ffmpeg']['source_files']}\""
  end
  

4. 权限或目录存在性细节问题 #

虽然你说文件和目录都存在，但还是可以再确认这两个点：

• 文件权限：检查/tmp下的tar.gz文件权限，确保Chef运行的用户（通常是root）有读取权限。如果文件是其他用户下载的，权限过于严格（比如0600），非root用户运行Chef就会报错。
• 目标目录：用Chef的directory资源确保目标目录存在并拥有正确权限，避免因目录创建时机问题导致报错：

  directory node['ffmpeg']['source_files'] do
    recursive true
    mode '0755'
    action :create
  end
  

更推荐的替代方案：用Chef原生的archive_file资源 #

比起用execute调用tar命令，Chef提供的archive_file资源更可靠——它会自动处理各种压缩格式，还会帮你处理依赖和错误检查：

archive_file "/tmp/#{node['ffmpeg']['yasm']}.tar.gz" do
  destination node['ffmpeg']['source_files']
  action :extract
  only_if { ::File.exist?("/tmp/#{node['ffmpeg']['yasm']}.tar.gz") }
end

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