Label TMM nodes

Introduction

The data-plane component of a CNE instance is the F5 Traffic Management Microkernel (TMM) workload. You can restrict TMM pods to specific nodes (for example, to ensure those nodes have the appropriate resources for the TMM pods scheduled on them). When installing using F5 Lifecycle Operator, restricting TMM pods to specific nodes is required when a CNE instance’s TMM workload is a daemon set and optional when it’s a deployment.

Note

Regardless of whether you restrict TMM pods to specific nodes, nodes that don’t otherwise prevent TMM from being scheduled must meet additional requirements. For example, the combined total of those nodes must have enough 2 mebibyte hugepages (hugepages-2Mi) to accommodate the needs of all TMM pods that will be scheduled.

How you restrict TMM pods for a BNK instance configured for daemon-set mode (required)

Restricting TMM pods to specific nodes for a BNK instance configured for daemon-set mode requires that you do the following:

  • Label each node on which you want Kubernetes to be able to schedule TMM pods.

    Note

    If you don’t label any nodes, Kubernetes won’t schedule any TMM pods.

  • When you later install the BNK instance configured for daemon-set mode, eliminate the node selector, which has no effect. (The node selector is fixed in daemon-set mode.)

How you restrict TMM pods for a BNK instance configured for deployment mode (optional)

Restricting TMM pods to specific nodes for a BNK instance configured for deployment mode requires that you do the following:

  • Label each node on which you want Kubernetes to be able to schedule TMM pods.

  • When you later install the BNK instance configured for deployment mode, specify that same label as the node selector.

Note

If you don’t want to restrict TMM pods for a BNK instance configured for deployment mode, don’t label TMM nodes, and eliminate the node selector, so Kubernetes may schedule TMM pods on any node that doesn’t otherwise prevent TMM from being scheduled.

For more information, see Assigning Pods to Nodes.

Label TMM nodes

Note

If you plan to install a BNK instance configured for daemon-set mode, perform this task. If you plan to install a BNK instance configured for deployment mode, perform this task only if you want to restrict TMM pods to specific nodes.

  1. List all the nodes in your cluster:

    kubectl get nodes

  2. Choose the node you want to label.

  3. Label the node so Kubernetes can schedule TMM pods on it:

    kkubectl label node <NODE> app=f5-tmm

  4. If you want to label another node, go to step 2.

  5. Verify that the label was applied to all the nodes you labeled:

    kubectl get nodes -l app=f5-tmm

Next steps