starlingx/docs
Code Issues Proposed changes
Files
b88b09404afeed43cd6ac9ea06962c4f6bee15ab
docs/doc/source/node_management/kubernetes/install-node-feature-discovery-nfd-starlingx-application-70f6f940bb4a.rst
Elisamara Aoki Gonçalves 12ff073b8e Maintain Platform App - node-feature-discovery 
Add details about the update interval of NFD

Change-Id: I8c415fbdb3139253fa6c4bf26a0185b18efd80b6
Signed-off-by: Elisamara Aoki Gonçalves <elisamaraaoki.goncalves@windriver.com>
2025-07-17 13:01:46 +00:00

3.1 KiB
Raw Blame History

Install Node Feature Discovery Application

Node Feature Discovery (NFD) detects hardware features available on each node in a kubernetes cluster and advertises those features using kubernetes node labels. Use the following procedure to install the application.

Before attempting to install the application, ensure that your system meets the following requirements:

  1. Ensure that you have at least kubernetes version v1.24.4 installed. If kubernetes v1.24.4 is not installed, see manual-kubernetes-components-upgrade for more details.

  2. If you have previously installed the Helm chart, you need to uninstall it before proceeding with the new installation. To uninstall, use the following command:

    ~(keystone_admin)]$ helm uninstall node-feature-discovery -n <namespace>

    <namespace> is the location, where you installed the Helm chart.

Use the following steps to install the application:

  1. Locate the tarball in the /usr/local/share/applications/helm directory.

    For example:

    /usr/local/share/applications/helm/node-feature-discovery-<version>.tgz

    Replace <version> with the latest version number.

  2. Upload the application using the following command.

    ~(keystone_admin)]$ system application-upload /usr/local/share/applications/helm/node-feature-discovery-<version>.tgz

    Replace <version> with the latest version number.

  3. Verify that the application has been uploaded successfully.

    ~(keystone_admin)]$ system application-list

  4. Apply the updates using the following command.

    ~(keystone_admin)]$ system application-apply node-feature-discovery

  5. Monitor the status of the installation using one of the following commands.

    ~(keystone_admin)]$ watch system application-list

or

~(keystone_admin)]$ watch kubectl get pods -n node-feature-discovery

  • A worker pod is created for each node in the kubernetes cluster. These worker pods gather information about node features periodically (default is 1 hour) and updates the labels associated with the nodes.
  • Additionally, there is one master pod that gathers all the updated data from worker pods and reports it for efficient feature management and a garbage collection of stale node feature objects pod.

The application is now installed on your system, and the hardware features available on each node in the kubernetes cluster will be detected and advertised using kubernetes node labels. To check the label for any configuration, use the following command:

~(keystone_admin)]$ kubectl label node/<node's name> --list | grep "feature.node.kubernetes.io"

Where <node's name> is name of the node.