feat: add lifecycle-manager component scaffolding (#1610)

Signed-off-by: Nathan Herz <nherz@nvidia.com>

Author: natherz97

.github/dependabot.yml

@@ -41,6 +41,7 @@ updates:
       - "/health-monitors/slurm-drain-monitor"
       - "/health-monitors/syslog-health-monitor"
       - "/janitor"
+      - "/lifecycle-manager"
       - "/janitor-provider"
       - "/labeler"
       - "/metadata-collector"

.github/workflows/cleanup-untagged-images.yml

@@ -79,6 +79,7 @@ jobs:
           - nvsentinel/log-collector
           - nvsentinel/file-server-cleanup
           - nvsentinel/janitor
+          - nvsentinel/lifecycle-manager
           - nvsentinel/health-events-analyzer
           - nvsentinel/maintenance-notifier
           - nvsentinel/event-exporter

.github/workflows/container-build-test.yml

@@ -145,6 +145,8 @@ jobs:
             path: .
           - module: preflight
             path: .
+          - module: lifecycle-manager
+            path: .
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
 

.github/workflows/lint-test.yml

@@ -179,6 +179,7 @@ jobs:
           - node-drainer
           - fault-remediation
           - janitor
+          - lifecycle-manager
           - preflight
           - tests
     steps:

.ko.yaml

@@ -288,3 +288,20 @@ builds:
       org.opencontainers.image.version: "{{.Env.VERSION}}"
       org.opencontainers.image.revision: "{{.Env.GIT_COMMIT}}"
       org.opencontainers.image.created: "{{.Env.BUILD_DATE}}"
+
+  - id: lifecycle-manager
+    dir: lifecycle-manager
+    main: .
+    ldflags:
+      - "-s -w"
+      - "-X main.version={{.Env.VERSION}} -X main.commit={{.Env.GIT_COMMIT}} -X main.date={{.Env.BUILD_DATE}}"
+    annotations:
+      org.opencontainers.image.description: "Lifecycle manager controller for NVSentinel"
+    labels:
+      org.opencontainers.image.source: "https://github.com/nvidia/nvsentinel"
+      org.opencontainers.image.licenses: "Apache-2.0"
+      org.opencontainers.image.title: "NVSentinel Lifecycle Manager"
+      org.opencontainers.image.description: "Lifecycle manager for GPU node validation and maintenance in NVSentinel"
+      org.opencontainers.image.version: "{{.Env.VERSION}}"
+      org.opencontainers.image.revision: "{{.Env.GIT_COMMIT}}"
+      org.opencontainers.image.created: "{{.Env.BUILD_DATE}}"

Makefile

@@ -51,6 +51,7 @@ GO_MODULES := \
 	node-drainer \
 	fault-remediation \
 	janitor \
+	lifecycle-manager \
 	metadata-collector \
 	event-exporter \
 	store-client \
@@ -79,7 +80,8 @@ PRIVATE_MODULES := \
 # Modules requiring kubebuilder for tests
 KUBEBUILDER_MODULES := \
 	node-drainer \
-	fault-remediation
+	fault-remediation \
+	lifecycle-manager
 
 # Default target
 .PHONY: all
@@ -455,6 +457,11 @@ lint-test-janitor:
 	@echo "Linting and testing janitor (using standardized Makefile)..."
 	$(MAKE) -C janitor lint-test
 
+.PHONY: lint-test-lifecycle-manager
+lint-test-lifecycle-manager:
+	@echo "Linting and testing lifecycle-manager (using standardized Makefile)..."
+	$(MAKE) -C lifecycle-manager lint-test
+
 .PHONY: lint-test-store-client
 lint-test-store-client:
 	@echo "Linting and testing store-client..."

distros/kubernetes/nvsentinel/Chart.lock

@@ -35,6 +35,9 @@ dependencies:
 - name: janitor
   repository: ""
   version: 0.1.0
+- name: lifecycle-manager
+  repository: ""
+  version: 0.1.0
 - name: metadata-collector
   repository: ""
   version: 0.1.0

distros/kubernetes/nvsentinel/Chart.yaml

@@ -55,6 +55,9 @@ dependencies:
   - name: janitor
     version: "0.1.0"
     condition: global.janitor.enabled
+  - name: lifecycle-manager
+    version: "0.1.0"
+    condition: global.lifecycleManager.enabled
   - name: janitor-provider
     version: "0.1.0"
     condition: global.janitorProvider.enabled

distros/kubernetes/nvsentinel/charts/lifecycle-manager/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

distros/kubernetes/nvsentinel/charts/lifecycle-manager/Chart.yaml

@@ -0,0 +1,23 @@
+# Copyright (c) 2025, NVIDIA CORPORATION.  All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+apiVersion: v2
+name: lifecycle-manager
+description: A Helm chart for the NVSentinel node validation controller
+
+type: application
+
+version: 0.1.0
+
+appVersion: "1.16.0"