已安装kubernetes模块，Ansible k8s任务仍提示导入失败求助

问题描述 #

我在macOS 12.4系统上运行Ansible，执行一个使用kubernetes.core.k8s模块应用MetalLB清单的任务。已按照官方文档安装kubernetes.core:2.3.2集合，本地pip3也已安装kubernetes、PyYAML、jsonpatch等依赖，但任务仍报错，提示目标节点node1的/usr/bin/python3找不到kubernetes模块。即使显式指定ansible_python_interpreter为/usr/bin/python3，问题依旧。

相关任务代码：

- name: "apply {{ downloaded_metallb_manifest }}"
  kubernetes.core.k8s:
    src: "{{ downloaded_metallb_manifest }}"
    state: present
    wait: yes

Ansible版本信息：

ansible [core 2.13.1]
  config file = None
  configured module search path = ['/Users/user/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/local/Cellar/ansible/6.1.0/libexec/lib/python3.10/site-packages/ansible
  ansible collection location = /Users/user/.ansible/collections:/usr/share/ansible/collections
  executable location = /usr/local/bin/ansible
  python version = 3.10.5 (main, Jun 23 2022, 17:15:25) [Clang 13.1.6 (clang-1316.0.21.2.5)]
  jinja version = 3.1.2
  libyaml = True

本地依赖安装情况：

% pip3 list | egrep -i 'kubernetes|pyyaml|jsonpatch'
jsonpatch           1.32
kubernetes          24.2.0
PyYAML              6.0

问题原因 #

你混淆了Ansible控制节点和目标节点的依赖安装位置。kubernetes.core.k8s模块默认会在目标节点（这里是node1）上执行相关逻辑，因此需要的Python依赖（kubernetes、PyYAML等）必须安装在目标节点的对应Python环境中，而不是只在本地控制节点安装。

你当前只在本地macOS（控制节点）装了依赖，但目标节点node1的/usr/bin/python3环境里没有这些模块，所以报错。

解决步骤 #

1. 在目标节点node1上安装所需依赖 #

可以通过Ansible任务先在目标节点安装依赖，再执行k8s模块任务：

- name: 安装k8s模块所需Python依赖
  pip:
    name:
      - kubernetes>=21.0.0
      - PyYAML
      - jsonpatch
    executable: /usr/bin/pip3
    state: present
  delegate_to: node1

- name: "apply {{ downloaded_metallb_manifest }}"
  kubernetes.core.k8s:
    src: "{{ downloaded_metallb_manifest }}"
    state: present
    wait: yes

注意：如果目标节点没有pip3，需要先通过包管理器（比如apt、yum）安装python3-pip。

2. 确认目标节点Python环境路径 #

显式指定ansible_python_interpreter时，要确保路径是目标节点上实际可用的Python3路径，并且该路径对应的环境已经安装了依赖。可以先在目标节点执行which python3确认路径，再在Ansible inventory或任务中指定：

# inventory文件中指定
node1 ansible_host=xxx.xxx.xxx.xxx ansible_python_interpreter=/usr/bin/python3

3. 可选：切换k8s模块执行模式为本地 #

如果不需要在目标节点执行，也可以通过delegate_to: localhost让k8s模块在控制节点执行，但需要确保控制节点能访问目标K8S集群的API（配置好kubeconfig）：

- name: "apply {{ downloaded_metallb_manifest }}"
  kubernetes.core.k8s:
    src: "{{ downloaded_metallb_manifest }}"
    state: present
    wait: yes
  delegate_to: localhost
  environment:
    KUBECONFIG: "/path/to/your/kubeconfig"

这种方式下，依赖只需要在控制节点安装即可，但要保证控制节点能正常连接到K8S集群。

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