feat(vm): add uptime printable column

Signed-off-by: Daniil Antoshin <daniil.antoshin@flant.com>

Author: danilrwx

api/core/v1alpha2/virtual_machine.go

@@ -42,6 +42,7 @@ const (
 // +kubebuilder:resource:categories={all,virtualization},scope=Namespaced,shortName={vm},singular=virtualmachine
 // +kubebuilder:printcolumn:name="Phase",type="string",JSONPath=".status.phase",description="The phase of the virtual machine."
 // +kubebuilder:printcolumn:name="PhaseAge",type="date",JSONPath=".status.stats.phasesTransitions[-1].timestamp",description="Time since the virtual machine entered the current phase."
+// +kubebuilder:printcolumn:name="Uptime",type="date",JSONPath=".status.runningSince",description="Time since the virtual machine started running."
 // +kubebuilder:printcolumn:name="Cores",priority=1,type="string",JSONPath=".spec.cpu.cores",description="The number of cores of the virtual machine."
 // +kubebuilder:printcolumn:name="CoreFraction",priority=1,type="string",JSONPath=".spec.cpu.coreFraction",description="Virtual machine core fraction. The range of available values is set in the `sizePolicy` parameter of the VirtualMachineClass; if it is not set, use values within the 1–100% range."
 // +kubebuilder:printcolumn:name="Memory",priority=1,type="string",JSONPath=".spec.memory.size",description="The amount of memory of the virtual machine."
@@ -299,6 +300,8 @@ type VirtualMachineStatus struct {
 	Stats *VirtualMachineStats `json:"stats,omitempty"`
 	// Migration info.
 	MigrationState *VirtualMachineMigrationState `json:"migrationState,omitempty"`
+	// RunningSince is the timestamp when the virtual machine entered the running state.
+	RunningSince *metav1.Time `json:"runningSince,omitempty"`
 	// Generating a resource that was last processed by the controller.
 	ObservedGeneration int64 `json:"observedGeneration,omitempty"`
 

api/core/v1alpha2/zz_generated.deepcopy.go

@@ -684,6 +684,9 @@ spec:
                     result:
                       description: |
                         Результат миграции: `Succeeded` или `Failed`.
+                runningSince:
+                  description: |
+                    Время перехода виртуальной машины в состояние running.
                 stats:
                   description: Статистика по виртуальной машине.
                   properties:

crds/doc-ru-virtualmachines.yaml

@@ -1153,6 +1153,11 @@ spec:
                         - ""
                         - "Succeeded"
                         - "Failed"
+                runningSince:
+                  description: Time when the virtual machine entered the running state.
+                  format: date-time
+                  nullable: true
+                  type: string
                 stats:
                   type: object
                   description: Virtual machine statistics.
@@ -1426,6 +1431,10 @@ spec:
           jsonPath: .status.stats.phasesTransitions[-1].timestamp
           name: PhaseAge
           type: date
+        - description: Time since the virtual machine started running.
+          jsonPath: .status.runningSince
+          name: Uptime
+          type: date
         - description: Real number of the virtual machine cores.
           jsonPath: .status.resources.cpu.cores
           name: Cores

crds/virtualmachines.yaml

@@ -122,6 +122,7 @@ func (h *LifeCycleHandler) Name() string {
 
 func (h *LifeCycleHandler) syncRunning(ctx context.Context, vm *v1alpha2.VirtualMachine, kvvm *virtv1.VirtualMachine, kvvmi *virtv1.VirtualMachineInstance, pod *corev1.Pod, log *slog.Logger) error {
 	cb := conditions.NewConditionBuilder(vmcondition.TypeRunning).Generation(vm.GetGeneration())
+	defer syncRunningSince(vm)
 
 	if pod != nil && pod.Status.Message != "" {
 		cb.Status(metav1.ConditionFalse).
@@ -229,6 +230,16 @@ func (h *LifeCycleHandler) syncRunning(ctx context.Context, vm *v1alpha2.Virtual
 	return nil
 }
 
+func syncRunningSince(vm *v1alpha2.VirtualMachine) {
+	running, found := conditions.GetCondition(vmcondition.TypeRunning, vm.Status.Conditions)
+	if !found || running.Status != metav1.ConditionTrue {
+		vm.Status.RunningSince = nil
+		return
+	}
+
+	vm.Status.RunningSince = running.LastTransitionTime.DeepCopy()
+}
+
 func (h *LifeCycleHandler) checkVMPodVolumeErrors(ctx context.Context, vm *v1alpha2.VirtualMachine, log *slog.Logger) error {
 	var podList corev1.PodList
 	err := h.client.List(ctx, &podList, &client.ListOptions{

images/virtualization-artifact/pkg/controller/vm/internal/lifecycle.go

@@ -0,0 +1,76 @@
+/*
+Copyright 2026 Flant JSC
+
+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.
+*/
+
+package internal
+
+import (
+	"time"
+
+	. "github.com/onsi/ginkgo/v2"
+	. "github.com/onsi/gomega"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+
+	"github.com/deckhouse/virtualization/api/core/v1alpha2"
+	"github.com/deckhouse/virtualization/api/core/v1alpha2/vmcondition"
+)
+
+var _ = Describe("LifeCycleHandler", func() {
+	Describe("syncRunningSince", func() {
+		It("sets runningSince from the Running condition last transition time", func() {
+			transitionTime := metav1.NewTime(time.Date(2026, 4, 24, 12, 0, 0, 0, time.UTC))
+			vm := &v1alpha2.VirtualMachine{
+				Status: v1alpha2.VirtualMachineStatus{
+					Conditions: []metav1.Condition{
+						{
+							Type:               vmcondition.TypeRunning.String(),
+							Status:             metav1.ConditionTrue,
+							LastTransitionTime: transitionTime,
+						},
+					},
+				},
+			}
+
+			syncRunningSince(vm)
+
+			Expect(vm.Status.RunningSince).NotTo(BeNil())
+			Expect(vm.Status.RunningSince.Time).To(Equal(transitionTime.Time))
+		})
+
+		DescribeTable("clears runningSince when the VM is not running",
+			func(conditions []metav1.Condition) {
+				transitionTime := metav1.NewTime(time.Date(2026, 4, 24, 12, 0, 0, 0, time.UTC))
+				vm := &v1alpha2.VirtualMachine{
+					Status: v1alpha2.VirtualMachineStatus{
+						RunningSince: &transitionTime,
+						Conditions:   conditions,
+					},
+				}
+
+				syncRunningSince(vm)
+
+				Expect(vm.Status.RunningSince).To(BeNil())
+			},
+			Entry("without the Running condition", nil),
+			Entry("with the Running condition set to False", []metav1.Condition{
+				{
+					Type:               vmcondition.TypeRunning.String(),
+					Status:             metav1.ConditionFalse,
+					LastTransitionTime: metav1.NewTime(time.Date(2026, 4, 24, 12, 0, 0, 0, time.UTC)),
+				},
+			}),
+		)
+	})
+})