如何在Ansible角色参数规范中实现IP自定义类型或验证器？

Ansible角色的参数规范（meta/argument_specs.yml）本身不支持直接自定义IP类型，也没有内置的正则验证选项。要实现IP格式校验，以下是几种标准操作方式：

1. 用assert模块手动校验 #

这是最直接的落地方式，在角色的tasks中添加校验任务，结合Ansible内置的IP判断过滤器完成格式验证：

- name: 验证IP变量格式合法性
  ansible.builtin.assert:
    that:
      - target_ip is ansible.utils.ipv4
      - backup_ips | all(ansible.utils.ipv4)
    fail_msg: "输入的IP地址格式不合法，请检查变量值"
    quiet: true

注：这里用到的ansible.utils.ipv4（或ipv6）过滤器来自ansible.utils集合，需要先通过ansible-galaxy collection install ansible.utils安装。

2. 借助schema插件实现结构化校验 #

如果需要更复杂的参数结构验证（比如数组、必填项组合），可以使用community.general.schema模块，通过JSON Schema定义IP规则：

- name: 结构化验证IP参数
  community.general.schema:
    data:
      primary_ip: "{{ target_ip }}"
      secondary_ips: "{{ backup_ips }}"
    schema:
      type: object
      properties:
        primary_ip:
          type: string
          format: ipv4
        secondary_ips:
          type: array
          items:
            type: string
            format: ipv4
      required: [primary_ip]
  register: schema_check
  failed_when: not schema_check.valid

该方式支持灵活的多字段组合校验，需要先安装community.general集合。

3. 自定义过滤器（进阶场景） #

如果多个角色都需要重复的IP校验逻辑，可以编写自定义过滤器封装IP判断逻辑，之后在assert或模板中调用。这种方式适合校验逻辑复杂且需要复用的场景，但需要额外维护过滤器代码。

关于角色参数规范的补充说明 #

Ansible当前的角色参数规范仅支持你列出的内置类型，确实无法直接添加自定义IP类型，也没有内置的正则验证字段。所以上述assert或schema的方式是当前官方认可的标准验证手段。

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