Ansible hashivault_list模块无法识别问题求助

问题原因 #

旧版ansible-modules-hashivault包和hashivault角色已被弃用，当前Ansible通过Collections维护HashiVault相关模块，你之前的安装方式不符合当前规范，导致模块无法被识别。

解决方案步骤 #

1. 清理旧依赖

   • 卸载pip中的旧模块包：

     pip uninstall -y ansible-modules-hashivault
     

   • 移除已安装的旧角色：

     ansible-galaxy remove hashivault
     

2. 安装官方维护的HashiVault集合
   安装community.hashi_vault集合（Ansible官方维护的HashiVault模块集合）：

   ansible-galaxy collection install community.hashi_vault
   

3. 更新Playbook适配新模块
   根据你使用的HashiVault KV引擎版本，替换对应模块：

   • KV1引擎：使用community.hashi_vault.hashi_vault_kv1_list模块，参数与旧版hashivault_list基本一致

     ---
     - hosts: localhost
       gather_facts: no
       tasks:
         - name: 列出KV1引擎下ansible/路径的密钥
           community.hashi_vault.hashi_vault_kv1_list:
             secret: "ansible/"
           register: secrets
         - debug: 
             var: secrets
     

   • KV2引擎：使用community.hashi_vault.hashi_vault_kv2_list模块，参数调整为path

     ---
     - hosts: localhost
       gather_facts: no
       tasks:
         - name: 列出KV2引擎下ansible/路径的密钥
           community.hashi_vault.hashi_vault_kv2_list:
             path: "ansible/"
           register: secrets
         - debug: 
             var: secrets
     

4. 确保依赖环境正确
   更新HashiVault的Python客户端hvac到最新版本：

   pip install --upgrade hvac
   

5. 配置Vault访问凭证
   推荐通过环境变量传递Vault地址和令牌，避免硬编码：

   export VAULT_ADDR="http://your-vault-server:8200"
   export VAULT_TOKEN="your-valid-vault-token"
   

验证执行 #

重新运行Playbook，配置正确即可正常获取密钥列表。

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