如何将Ansible Collection中的角色标记为已弃用？

官方目前没有针对Collection中角色的标准化弃用流程，但可以参考模块的弃用思路，结合角色的特性实现类似效果，具体操作如下：

1. 角色README醒目标注 #

直接在目标角色的README.md最上方加醒目的弃用提示，明确告知用户该角色不再维护，并给出替代方案：

⚠️ 已弃用
本角色不再接受更新与维护，推荐使用同Collection内的new_backup_role角色替代。

2. 执行角色时抛出警告 #

在角色的tasks/main.yml开头添加debug任务，强制输出弃用警告，确保用户在使用时能及时看到：

- name: 提示角色已弃用
  debug:
    msg: "[警告] 此角色已弃用，请切换至new_backup_role角色"
    verbosity: 0

设置verbosity: 0能让这条警告在任何日志级别下都显示出来。

3. Collection全局文档统一声明 #

在Collection根目录的README.md或CHANGELOG.md里，专门新增一个「已弃用角色」板块，列出所有废弃角色、弃用版本和替代选项，方便用户快速查阅。

4. 自定义角色元数据标记 #

虽然官方没有为角色定义弃用元数据规范，但可以在角色的meta/main.yml中添加自定义字段，标记弃用状态，方便自己维护和让查看元数据的用户知晓：

galaxy_info:
  author: 你的名字
  description: 用于旧版本备份的角色（已弃用）
  # 自定义弃用相关字段
  deprecated: true
  deprecation_note: "请使用本Collection的new_backup_role替代"
  replacement: "your_namespace.your_collection.new_backup_role"

关于官方模块弃用方案的适配性 #

官方针对模块的弃用流程（比如代码内的弃用装饰器、Galaxy元数据标记等）无法直接适配角色，因为Ansible目前没有为角色设计对应的识别逻辑。但上面的几种方法，已经能实现「告知用户角色弃用、引导替代方案」的核心目的。

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