使用Ansible实现Azure Storage queues的方案咨询

目前Ansible官方维护的azure.azcollection模块集合未单独封装Azure Storage Queues的专用操作模块，官方文档中队列相关的操作指引仅覆盖Service Bus Queue资源，可通过以下三种稳定方案实现需求，均适配Ansible的幂等性要求：

方案1：调用通用Azure RM资源模块（生产环境推荐） #

该方案无需额外安装依赖，直接复用Ansible Azure集合内置的通用资源操作能力，调用Azure官方Resource Manager接口操作存储队列，和现有Azure认证体系完全打通：

• 前置准备
  • 控制节点已安装最新版azure.azcollection集合
  • 使用的Azure认证主体已授予目标存储账户的队列读写、配置权限
• 核心实现示例（创建队列+配置元数据）

- name: 配置Azure Storage Queue
  hosts: localhost
  connection: local
  tasks:
    - name: 创建业务存储队列
      azure.azcollection.azure_rm_resource:
        api_version: "2023-01-01"
        resource_group: "替换为你的资源组名"
        provider: "storage"
        resource_type: "storageAccounts"
        resource_name: "替换为你的存储账户名"
        subresource:
          - type: "queueServices"
            name: "default"
          - type: "queues"
            name: "替换为目标队列名"
        state: present
        body:
          properties:
            metadata:
              business_line: "trade"
              deploy_env: "prod"

• 扩展操作：调整参数即可实现全生命周期管理
  • 查询队列详情：将state参数设置为info
  • 删除队列：将state参数设置为absent
  • 更新队列元数据：修改body内的properties字段重新执行即可

方案2：封装Azure CLI命令 #

如果团队已经熟悉Azure CLI的存储队列操作语法，可直接通过Ansible的命令模块调用az cli指令，手动做幂等性判断即可：

• 前置准备：控制节点已安装Azure CLI及storage-queue扩展，完成认证授权
• 实现示例

- name: 通过az cli创建存储队列
  ansible.builtin.command: >
    az storage queue create
    --account-name "替换为存储账户名"
    --name "替换为队列名"
    --auth-mode login
  register: queue_cli_result
  changed_when: queue_cli_result.rc == 0 and '"created": true' in queue_cli_result.stdout
  failed_when: queue_cli_result.rc != 0 and 'The specified queue already exists' not in queue_cli_result.stderr

方案3：自定义轻量模块 #

如果日常有大量存储队列的批量配置需求，可以基于Azure Python for Storage SDK编写轻量自定义Ansible模块，代码量通常在100行以内，放到项目根目录的library文件夹下即可像原生模块一样调用，支持自动幂等判断、结构化结果返回，适配团队的标准化配置流程。

注意：不建议使用来源不明的第三方开源Storage Queue Ansible模块，这类模块大多依赖过时版本的Azure SDK，普遍存在认证逻辑不兼容、幂等性失效的问题，上述两种基于官方内置能力的方案兼容性和稳定性更有保障。

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