如何用Ansible修改本地.kube/config文件？含替换追加及问题排查

一、你的replace任务未生效的原因 #

你写的Ansible任务存在语法错误：replace模块中不能重复定义regexp参数，替换的目标值需要用replace参数指定。你重复写了两个regexp，第二个会覆盖第一个，且未指定实际要替换成的内容，导致任务没有执行任何有效操作。

正确的任务写法如下：

- name: Update value to foo
  replace:
    path: ~/.kube/config
    regexp: 'yyy'
    replace: 'foo'  # 用replace参数指定替换后的内容
  delegate_to: localhost

二、有没有专门的Kubernetes模块可用？ #

有！Ansible官方的kubernetes.core.kubeconfig模块就是专门用来管理~/.kube/config文件的，完全满足你的两个核心需求：修改现有条目、在条目不存在时追加新内容。

模块用法示例 #

1. 修改现有集群、用户、上下文条目

比如修改名为xxx的集群地址，调整名为yyy的上下文关联的集群和用户：

- name: Modify existing kubeconfig entries
  kubernetes.core.kubeconfig:
    path: ~/.kube/config
    # 修改现有集群配置
    clusters:
      - name: xxx
        cluster:
          server: https://new-k8s-server.example.com
    # 修改现有上下文配置
    contexts:
      - name: yyy
        context:
          cluster: updated-cluster-name
          user: updated-user-name
    # 修改现有用户配置
    users:
      - name: xxx
        user:
          token: new-valid-user-token
  delegate_to: localhost

2. 追加新的集群、用户、上下文条目

如果指定的名称在对应段中不存在，模块会自动追加新条目：

- name: Add new entries to kubeconfig
  kubernetes.core.kubeconfig:
    path: ~/.kube/config
    # 追加新集群
    clusters:
      - name: new-cluster
        cluster:
          server: https://new-cluster.example.com
          certificate-authority-data: <base64-encoded-ca-cert>
    # 追加新用户
    users:
      - name: new-user
        user:
          token: <valid-user-token>
    # 追加新上下文
    contexts:
      - name: new-context
        context:
          cluster: new-cluster
          user: new-user
    # 可选：将新上下文设为默认
    context: new-context
  delegate_to: localhost

三、不用专用模块的替代实现方法 #

如果受环境限制无法使用kubernetes.core集合，也可以通过读取-修改-写入的方式手动处理YAML文件：

1. 读取~/.kube/config内容到变量
2. 解析YAML并修改/追加对应字段
3. 将修改后的内容写回文件

示例任务：

- name: Read kubeconfig file
  slurp:
    src: ~/.kube/config
  register: kubeconfig_raw
  delegate_to: localhost

- name: Parse kubeconfig content to YAML
  set_fact:
    kubeconfig: "{{ kubeconfig_raw.content | b64decode | from_yaml }}"
  delegate_to: localhost

- name: Modify existing cluster 'xxx'
  set_fact:
    kubeconfig: "{{ kubeconfig | combine({'clusters': kubeconfig.clusters | map('combine', {'cluster': {'server': 'https://new-server.example.com'}}) | list}, recursive=True) }}"
  when: "'xxx' in kubeconfig.clusters | map(attribute='name') | list"
  delegate_to: localhost

- name: Add new cluster if not exists
  set_fact:
    kubeconfig: "{{ kubeconfig | combine({'clusters': kubeconfig.clusters + [{'name': 'new-cluster', 'cluster': {'server': 'https://new-cluster.example.com'}}]}) }}"
  when: "'new-cluster' not in kubeconfig.clusters | map(attribute='name') | list"
  delegate_to: localhost

- name: Write modified kubeconfig back to file
  copy:
    content: "{{ kubeconfig | to_yaml }}"
    dest: ~/.kube/config
  delegate_to: localhost

这种方法需要自行处理大量逻辑判断，不如专用模块简洁，优先推荐使用kubernetes.core.kubeconfig模块。

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