为何Ansible无法识别admin.conf，执行kubectl需手动指定KUBECONFIG？

问题分析 #

核心矛盾在于：手动SSH登录服务器后，ubuntu和root用户都能正常执行kubectl，但Ansible直接运行kubectl apply时会报错连接localhost:8080被拒绝——只有显式导出KUBECONFIG才能正常执行。即使复制admin.conf到~/.kube/config并设置权限，问题依然存在，这通常和Ansible执行任务的环境上下文有关：

1. Ansible的shell/command模块默认以非登录、非交互式Shell运行，不会加载用户的.bashrc/.profile等配置文件（手动SSH登录时是登录Shell，会自动加载这些配置）。
2. 如果任务使用了become: yes切换到root用户，复制到/home/{{ ansible_user }}/.kube/config的配置对root用户无效，因为root的家目录是/root而非普通用户的家目录。

解决方案 #

方案1：在Ansible任务中显式设置环境变量 #

直接在任务里指定KUBECONFIG环境变量，这是最直接可靠的方法：

- name: 应用Ingress配置文件
  shell: kubectl apply -f /home/ingress.yaml
  environment:
    KUBECONFIG: /etc/kubernetes/admin.conf

如果需要全局生效，也可以在Playbook级别设置环境变量：

- hosts: your_k8s_nodes
  environment:
    KUBECONFIG: /etc/kubernetes/admin.conf
  tasks:
    - name: 应用Ingress配置文件
      shell: kubectl apply -f /home/ingress.yaml

方案2：确保kubeconfig文件对执行用户可见 #

如果坚持使用~/.kube/config的默认路径，需要根据执行任务的用户调整：

• 以普通用户（比如ubuntu）执行任务：

  - name: 创建普通用户的kube目录并复制配置
    file:
      path: /home/{{ ansible_user }}/.kube
      state: directory
      mode: '0700'
      owner: "{{ ansible_user }}"
      group: "{{ ansible_user }}"
  
  - name: 复制admin.conf到普通用户的kubeconfig
    copy:
      src: /etc/kubernetes/admin.conf
      dest: /home/{{ ansible_user }}/.kube/config
      mode: '0600'
      owner: "{{ ansible_user }}"
      group: "{{ ansible_user }}"
  

• 使用become: yes切换到root用户执行任务：

  - name: 创建root用户的kube目录并复制配置
    file:
      path: /root/.kube
      state: directory
      mode: '0700'
      owner: root
      group: root
    become: yes
  
  - name: 复制admin.conf到root用户的kubeconfig
    copy:
      src: /etc/kubernetes/admin.conf
      dest: /root/.kube/config
      mode: '0600'
      owner: root
      group: root
    become: yes
  

方案3：强制使用登录Shell执行命令 #

让Ansible以登录Shell运行kubectl命令，这样会加载用户的Shell配置文件（比如.bash_profile），如果手动登录环境中配置了kubeconfig相关变量，这个方法会生效：

- name: 应用Ingress配置文件（登录Shell模式）
  shell: bash -l -c 'kubectl apply -f /home/ingress.yaml'

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