kubernetes-官方的api文档在哪里说matchLabels是否是强制性的

Question

今天，我正在阅读一些有关matchLabels语句的文档和讨论，该语句是Kubernetes中Deployment（或其他对象）的一部分。 下面的例子：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
  labels:
    app: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.7.9
        ports:
        - containerPort: 80

在一些讨论中，我看到根据API的版本，使用此选择器可能是可选的或强制性的。

参考：

https://github.com/helm/charts/issues/7680

kubernetes部署容器选择器的目的是什么？

但是，对于特定版本的Kubernetes API，是否强制使用此选择器，我看不到任何明确说明的官方文档。 您是否知道在官方文档中注明是否必须使用matchLabels选择器？

我已经检查了这些链接，但没有遇到官方声明： https : //kubernetes.io/docs/reference/produced/kubernetes-api/v1.10/#deploymentspec-v1beta2-apps

https://kubernetes.io/docs/concepts/workloads/controllers/deployment/

Answer 1

kubectl explain deploy.spec.selector --api-version=apps/v1

吊舱标签选择器。 被其选择的吊舱的现有副本集将受到此部署的影响。 它必须与窗格模板的标签匹配。

https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/api/apps/v1/types.go#L276-L279

 Selector *metav1.LabelSelector `json:"selector" protobuf:"bytes,2,opt,name=selector"` 

此行上方缺少+optional ，告诉您它是强制性的。 如果尝试不进行部署，它将与错误消息匹配。

cat <<EOF | kubectl apply -f -
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
 spec:
   replicas: 1
   template:
     spec:
       containers:
       - image: nginx
         imagePullPolicy: Always
         name: nginx
       dnsPolicy: ClusterFirst
       restartPolicy: Always
EOF

错误：验证io.k8s.api.apps.v1.DeploymentSpec中的“ STDIN”时出错； 如果您选择忽略这些错误，请使用--validate = false关闭验证。 验证数据时出错：ValidationError（Deployment.spec）：缺少必填字段“选择器”

https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/apis/meta/v1/types.go#L1076-L1085

type LabelSelector struct {
    // matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
    // map is equivalent to an element of matchExpressions, whose key field is "key", the
    // operator is "In", and the values array contains only "value". The requirements are ANDed.
    // +optional
    MatchLabels map[string]string `json:"matchLabels,omitempty" protobuf:"bytes,1,rep,name=matchLabels"`
    // matchExpressions is a list of label selector requirements. The requirements are ANDed.
    // +optional
    MatchExpressions []LabelSelectorRequirement `json:"matchExpressions,omitempty" protobuf:"bytes,2,rep,name=matchExpressions"`
}