ReplicaSet

创建 ReplicaSet

apiVersion: apps/v1  #版本号
kind: ReplicaSet  #类型
metadata:    #元数据
  name:    #rs名称
  namespace:   #所属命名空间
  labels:   #标签
    controller: rs
spec:   #详情描述
  replicas:  #副本数量
  selector:  #选择器,通过它指定该控制器管理哪些pod
    matchLabels:   #Labels匹配规则
       app: nginx-pod
    matchExpressions:   #Expression匹配规则
      - {key: app, operator: In, values: [nginx-pod]}
  template:  #模板,当副本数量不足时,会根据下面的模板创建pod副本
    metadata:
        labels:
          app: nginx-pod
    spec:
      containers:
      - name: nginx
        image: nginx:1.17.1
        ports:
        - containerPort: 80

在这里面,需要新了解的配置项就是spec下面几个选项:

删除 ReplicaSet 和它的 Pod

要删除 ReplicaSet 和它的所有 Pod,使用 kubectl delete 命令。 默认情况下,垃圾收集器 自动删除所有依赖的 Pod。

当使用 REST API 或 client-go 库时,你必须在 -d 选项中将 propagationPolicy 设置为 Background 或 Foreground。例如:

kubectl proxy --port=8080
curl -X DELETE  'localhost:8080/apis/apps/v1/namespaces/default/replicasets/frontend' \\
  -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Foreground"}' \\
  -H "Content-Type: application/json"

只删除 ReplicaSet

你可以只删除 ReplicaSet 而不影响它的各个 Pod,方法是使用 kubectl delete 命令并设置 --cascade=orphan 选项。

当使用 REST API 或 client-go 库时,你必须将 propagationPolicy 设置为 Orphan。 例如:

kubectl proxy --port=8080
curl -X DELETE  'localhost:8080/apis/apps/v1/namespaces/default/replicasets/frontend' \\
  -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Orphan"}' \\
  -H "Content-Type: application/json"

注意

ReplicaSet 只负责维护 Pod 数量,在数量没有变化的情况下,Pod 不会被更新。只有将旧的 Pod 杀死,ReplicaSet 才会在重新创建 Pod 的时候使用新的镜像版本。

比如,先将下面的内容保存为 ReplicaSet.yaml

apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: frontend
  labels:
    app: frontend
spec:
  replicas: 3   # 3 个副本数
  selector:
    matchLabels:
      app: frontend
  template:
    metadata:
      labels:
        app: frontend
    spec:
      containers:
      - name: frontend
        image: lyzhang1999/frontend:v1

使用 kubectl apply 创建 ReplicaSet 工作负载:

$ kubectl apply -f ReplicaSet.yaml
replicaset.apps/frontend created

现在,我们尝试修改 ReplicaSet.yaml 的内容,将镜像版本从 v1 修改到 v2:

apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: frontend
  ......
spec:
  ......
  template:
    ......
    spec:
      containers:
      - name: frontend
        image: lyzhang1999/frontend:v2 # 修改镜像版本

再次运行 kubectl apply -f 使修改生效:

$ kubectl apply -f ReplicaSet.yaml
replicaset.apps/frontend configured

然后,我们使用 kubectl get pods 来查看所有 Pod 的镜像版本信息:

$ kubectl get pods --selector=app=frontend -o jsonpath='{.items[*].spec.containers[0].image}'
lyzhang1999/frontend:v1 lyzhang1999/frontend:v1 lyzhang1999/frontend:v1

从返回结果可以看出, Pod 的镜像版本并没有被更新为 v2。

要验证这个过程,你可以使用 kubectl delete pod 来删除某一个 Pod:

$ kubectl get pods
NAME             READY   STATUS    RESTARTS   AGE
frontend-25kf4   1/1     Running   0          28s
frontend-j94fv   1/1     Running   0          28s
frontend-mbst5   1/1     Running   0          28s

$ kubectl delete pods frontend-25kf4
pod "frontend-25kf4" deleted

删除其中一个 Pod 之后,ReplicaSet 会发现 Pod 数量和预期数量相差 1 个 Pod,所以会重新创建一个 Pod 以满足预期要求。此时,我们再次查看所有 Pod 的镜像版本信息:

$ kubectl get pods --selector=app=frontend -o jsonpath='{.items[*].spec.containers[0].image}'
lyzhang1999/frontend:v2 lyzhang1999/frontend:v1 lyzhang1999/frontend:v1

就可以从返回结果看出,Pod 重新创建后,镜像版本也随之更新了。

通过这个实验我们得出结论,ReplicaSet 只能确保 Pod 数量,在我们需要更新 Pod 的时候,并不能帮我们自动进行更新,这意味着无法实现期望状态和实际的状态的一致性。所以,在实际项目中,我们不会直接使用 ReplicaSet 工作负载,而是会使用更上层的 Deployment 工作负载。