Assign Pods to Nodes using Node Affinity
Kubernetes Docs · نسخهٔ f284a9e7c87f · CC BY 4.0 برای مستندات و مجوزهای همراه
<!-- overview --> This page shows how to assign a Kubernetes Pod to a particular node using Node Affinity in a Kubernetes cluster.
{{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
<!-- steps -->
Add a label to a node
- List the nodes in your cluster, along with their labels:
kubectl get nodes --show-labelsThe output is similar to this:
NAME STATUS ROLES AGE VERSION LABELS
worker0 Ready <none> 1d v1.13.0 ...,kubernetes.io/hostname=worker0
worker1 Ready <none> 1d v1.13.0 ...,kubernetes.io/hostname=worker1
worker2 Ready <none> 1d v1.13.0 ...,kubernetes.io/hostname=worker2- Choose one of your nodes, and add a label to it:
kubectl label nodes <your-node-name> disktype=ssdwhere <your-node-name> is the name of your chosen node.
- Verify that your chosen node has a
disktype=ssdlabel:
kubectl get nodes --show-labelsThe output is similar to this:
NAME STATUS ROLES AGE VERSION LABELS
worker0 Ready <none> 1d v1.13.0 ...,disktype=ssd,kubernetes.io/hostname=worker0
worker1 Ready <none> 1d v1.13.0 ...,kubernetes.io/hostname=worker1
worker2 Ready <none> 1d v1.13.0 ...,kubernetes.io/hostname=worker2In the preceding output, you can see that the worker0 node has a disktype=ssd label.
Schedule a Pod using required node affinity
This manifest describes a Pod that has a requiredDuringSchedulingIgnoredDuringExecution node affinity,disktype: ssd. This means that the pod will get scheduled only on a node that has a disktype=ssd label.
{{% code_sample file="pods/pod-nginx-required-affinity.yaml" %}}
- Apply the manifest to create a Pod that is scheduled onto your
chosen node:
kubectl apply -f https://k8s.io/examples/pods/pod-nginx-required-affinity.yaml- Verify that the pod is running on your chosen node:
kubectl get pods --output=wideThe output is similar to this:
NAME READY STATUS RESTARTS AGE IP NODE
nginx 1/1 Running 0 13s 10.200.0.4 worker0Schedule a Pod using preferred node affinity
This manifest describes a Pod that has a preferredDuringSchedulingIgnoredDuringExecution node affinity,disktype: ssd. This means that the pod will prefer a node that has a disktype=ssd label.
{{% code_sample file="pods/pod-nginx-preferred-affinity.yaml" %}}
- Apply the manifest to create a Pod that is scheduled onto your
chosen node:
kubectl apply -f https://k8s.io/examples/pods/pod-nginx-preferred-affinity.yaml- Verify that the pod is running on your chosen node:
kubectl get pods --output=wideThe output is similar to this:
NAME READY STATUS RESTARTS AGE IP NODE
nginx 1/1 Running 0 13s 10.200.0.4 worker0{{% heading "whatsnext" %}}
Learn more about Node Affinity.