在tj-actions/changed-files中实现基于目录特性的文件过滤

在持续集成和持续部署(CI/CD)流程中，精确识别变更文件是自动化工作流的关键环节。当项目结构包含多种技术栈时，如何针对特定技术类型的目录进行精准过滤成为一个常见需求。

技术背景

现代项目往往采用混合技术栈，例如同时包含Helm图表和Kustomize配置的Kubernetes项目。Helm图表通常包含Chart.yaml文件作为标识，而Kustomize项目则使用kustomization.yaml。在自动化流程中，我们需要区分这些不同类型的变更。

解决方案

tj-actions/changed-files动作提供了files_yaml输入参数，支持基于YAML格式的复杂文件过滤规则。通过这个功能，我们可以：

1. 定义多个文件组别
2. 为每个组别指定包含和排除模式
3. 实现基于目录特性的精确匹配

实际应用示例

以下是一个典型配置示例，展示了如何区分不同技术类型的目录：

- name: 获取变更的Helm图表文件
  id: changed-files
  uses: tj-actions/changed-files@v44
  with:
    files_yaml: |
      helm:
        - '**/Chart.yaml'
        - 'charts/**'
      kustomize:
        - '**/kustomization.yaml'
        - 'kustomize/**'

高级用法

对于更复杂的场景，我们可以结合包含和排除模式：

1. 匹配所有包含Chart.yaml的目录
2. 排除特定测试目录
3. 只关注src目录下的特定文件类型

files_yaml: |
  production_helm:
    - '**/Chart.yaml'
    - '!test/**'
    - 'src/**/values.prod.yaml'

技术实现原理

该功能底层使用glob模式匹配，支持：

• 递归匹配(**)
• 单级匹配(*)
• 字符集匹配([abc])
• 范围匹配([a-z])
• 取反匹配(!pattern)

最佳实践建议

1. 为每种技术类型创建独立的文件组
2. 使用明确的排除规则减少误匹配
3. 在复杂项目中分层组织匹配规则
4. 定期审查匹配规则确保准确性

通过合理配置tj-actions/changed-files的过滤规则，可以显著提升CI/CD流程的精确度和效率，特别是在混合技术栈的项目环境中。