Ansible shell模块配置自定义凭据连接主机不生效如何解决

问题原因 #

两种方案不生效是两个写法错误导致的：

1. 连接类变量（ansible_user/ansible_password/ansible_connection这类）不能放在task的args块下定义，Ansible建立SSH连接的阶段早于task执行阶段，不会读取args块内的连接参数。
2. 给委托主机传变量不能靠delegate_to+set_fact实现：set_fact默认只会给当前play绑定的执行主机设置事实变量，不会修改委托目标主机的连接变量，后续连接还是会读取全局默认的SSH_User配置。

额外注意：针对IOS这类网络设备，不要使用通用的shell模块，shell模块适配的是普通Linux/Windows主机的paramiko/ssh连接，和network_cli连接类型不兼容，要使用网络设备专用的命令模块。

正确配置方案 #

方案1：单task循环直接传连接变量

直接在task层级用vars块定义连接参数，所有连接变量会在连接建立前被读取，不需要提前设置事实：

- name: Execute whoami on target IOS devices
  ansible.netcommon.cli_command:
    command: whoami
  loop: "{{ lookup('file', '../files/deviceList.txt').splitlines() }}"
  delegate_to: "{{ item.split(';')[0] }}"
  vars:
    ansible_connection: network_cli
    ansible_network_os: cisco.ios.ios
    ansible_user: "{{ cred_ios_r_user }}"
    ansible_password: "{{ cred_ios_r_pass }}"

方案2：动态添加主机到内存清单（适合多任务批量操作设备场景）

如果后续有多个task要操作这批设备，用add_host模块把设备动态加到运行时内存清单里，统一配置连接参数，后续直接对这批动态主机执行任务即可，不需要每次循环加delegate_to：

- name: Load IOS devices to runtime inventory
  ansible.builtin.add_host:
    name: "{{ item.split(';')[0] }}"
    groups: ios_managed_devices
    ansible_connection: network_cli
    ansible_network_os: cisco.ios.ios
    ansible_user: "{{ cred_ios_r_user }}"
    ansible_password: "{{ cred_ios_r_pass }}"
  loop: "{{ lookup('file', '../files/deviceList.txt').splitlines() }}"

- name: Run whoami on all loaded IOS devices
  ansible.netcommon.cli_command:
    command: whoami
  hosts: ios_managed_devices
  gather_facts: false

排查提示 #

如果修改后仍然读取默认SSH_User，检查以下高优先级配置是否覆盖了你的变量：

• ansible.cfg中remote_user配置项
• 全局环境变量中的ANSIBLE_USER/ANSIBLE_REMOTE_USER值
• 项目目录下group_vars/host_vars中硬编码的用户配置
  task级vars的变量优先级高于以上全局配置，写法正确的话会直接覆盖默认值。

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