【k8s】kubectl replace命令

一、命令作用

使用配置文件或stdin来替换资源。

支持JSON和YAML格式。如果替换当前资源，则必须提供完整的资源规范。可以通过以下命令获取：

kubectl get TYPE NAME -o yaml

二、命令语法

replace -f FILENAME

三、使用示例

对于以下示例中，安装了 k8s 的情形下，若出现如下报错：

error: the server doesn't have a resource type "xxxx"

则需要在 kuebctl 命令前面加上 sudo 命令。

使用pod.json中的数据替换pod：

kubectl replace -f ./pod.json

根据传入的JSON替换pod：

cat pod.json | kubectl replace -f -

更新镜像版本(tag)到v3：

kubectl get pod exp_pod -o yaml | sed 's/\(image: exp_image\):.*$/\1:v3/' | kubectl replace -f -

强制替换，删除原有资源，然后重新创建资源：

kubectl replace --force -f ./pod.json

注意： kubectl replace 只接受当前已经存在的pod的全量配置信息，而不能是原始配置信息，否则会报类似如下的错误：

The Pod "kubia-manual-v2" is invalid: spec: Forbidden: pod updates may not change fields other than `spec.containers[*].image`, `spec.initContainers[*].image`, `spec.activeDeadlineSeconds`, `spec.tolerations` (only additions to existing tolerations) or `spec.terminationGracePeriodSeconds` (allow it to be set to 1 if it was previously negative)

原因可能是 replace 仅允许修改特定的字段，而用户使用原始配置信息进行replace时，等价于删去了系统默认加的一些字段，导致校验不通过，因此需要 全量的配置（通过get -o yaml 命令获取当前的配置详情），然后再修改局部参数

#原始配置信息
apiVersion: v1
kind: Pod
metadata:
  name: kubia-manual-v2
  labels:
    creation_method: manual
    env: prod
spec:
  containers:
  - image: kubia:v3
    imagePullPolicy: IfNotPresent
    name: kubia
    ports:
    - containerPort: 8080
      protocol: TCP

而kubecl apply -f 是支持局部修改的，即可以通过原始文件进行修改。例如上面你可以把 镜像版本字段换成其他 版本即可