github.com/tilt-dev/tilt@v0.33.15-0.20240515162809-0a22ed45d8a0/internal/hud/webview/convert.go

package webview

import (
	"context"
	"fmt"
	"sort"
	"strings"

	"github.com/pkg/errors"
	"google.golang.org/protobuf/types/known/timestamppb"
	apierrors "k8s.io/apimachinery/pkg/api/errors"
	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
	"k8s.io/apimachinery/pkg/runtime/schema"
	"k8s.io/apimachinery/pkg/types"
	ctrlclient "sigs.k8s.io/controller-runtime/pkg/client"

	"github.com/tilt-dev/tilt/internal/controllers/apis/uiresource"
	"github.com/tilt-dev/tilt/internal/engine/buildcontrol"
	"github.com/tilt-dev/tilt/internal/k8s"
	"github.com/tilt-dev/tilt/internal/store"
	"github.com/tilt-dev/tilt/internal/store/k8sconv"
	"github.com/tilt-dev/tilt/pkg/apis"
	"github.com/tilt-dev/tilt/pkg/apis/core/v1alpha1"
	"github.com/tilt-dev/tilt/pkg/logger"
	"github.com/tilt-dev/tilt/pkg/model"
	"github.com/tilt-dev/tilt/pkg/model/logstore"
	proto_webview "github.com/tilt-dev/tilt/pkg/webview"
)

// We call the main session the Tiltfile session, for compatibility
// with the other Session API.
const UISessionName = "Tiltfile"

// Create the complete snapshot of the webview.
func CompleteView(ctx context.Context, client ctrlclient.Client, st store.RStore) (*proto_webview.View, error) {
	ret := &proto_webview.View{}
	session := &v1alpha1.UISession{}
	err := client.Get(ctx, types.NamespacedName{Name: UISessionName}, session)
	if err != nil && !apierrors.IsNotFound(err) {
		return nil, err
	}

	if err == nil {
		ret.UiSession = session
	}

	resourceList := &v1alpha1.UIResourceList{}
	err = client.List(ctx, resourceList)
	if err != nil {
		return nil, err
	}

	for _, item := range resourceList.Items {
		item := item
		ret.UiResources = append(ret.UiResources, &item)
	}

	buttonList := &v1alpha1.UIButtonList{}
	err = client.List(ctx, buttonList)
	if err != nil {
		return nil, err
	}

	for _, item := range buttonList.Items {
		item := item
		ret.UiButtons = append(ret.UiButtons, &item)
	}

	clusterList := &v1alpha1.ClusterList{}
	err = client.List(ctx, clusterList)
	if err != nil {
		return nil, err
	}

	for _, item := range clusterList.Items {
		item := item
		ret.Clusters = append(ret.Clusters, &item)
	}

	s := st.RLockState()
	defer st.RUnlockState()
	logList, err := s.LogStore.ToLogList(0)
	if err != nil {
		return nil, err
	}

	ret.LogList = logList

	// We grandfather in TiltStartTime from the old protocol,
	// because it tells the UI to reload.
	start := timestamppb.New(s.TiltStartTime)
	ret.TiltStartTime = start
	ret.IsComplete = true

	sortUIResources(ret.UiResources, s.ManifestDefinitionOrder)

	return ret, nil
}

// Create a view that only contains logs since the given checkpoint.
func LogUpdate(st store.RStore, checkpoint logstore.Checkpoint) (*proto_webview.View, error) {
	ret := &proto_webview.View{}

	s := st.RLockState()
	defer st.RUnlockState()
	logList, err := s.LogStore.ToLogList(checkpoint)
	if err != nil {
		return nil, err
	}

	ret.LogList = logList

	// We grandfather in TiltStartTime from the old protocol,
	// because it tells the UI to reload.
	start := timestamppb.New(s.TiltStartTime)
	ret.TiltStartTime = start

	return ret, nil
}

func sortUIResources(resources []*v1alpha1.UIResource, order []model.ManifestName) {
	resourceOrder := make(map[string]int, len(order))
	for i, name := range order {
		resourceOrder[name.String()] = i
	}
	resourceOrder[store.MainTiltfileManifestName.String()] = -1
	sort.Slice(resources, func(i, j int) bool {
		objI := resources[i]
		objJ := resources[j]
		orderI, hasI := resourceOrder[objI.Name]
		orderJ, hasJ := resourceOrder[objJ.Name]
		if !hasI {
			orderI = 1000
		}
		if !hasJ {
			orderJ = 1000
		}
		if orderI != orderJ {
			return orderI < orderJ
		}
		return objI.Name < objJ.Name
	})
}

// Converts EngineState into the public data model representation, a UISession.
func ToUISession(s store.EngineState) *v1alpha1.UISession {
	ret := &v1alpha1.UISession{
		ObjectMeta: metav1.ObjectMeta{
			Name: UISessionName,
		},
		Status: v1alpha1.UISessionStatus{},
	}

	status := &(ret.Status)
	status.NeedsAnalyticsNudge = NeedsNudge(s)
	status.RunningTiltBuild = v1alpha1.TiltBuild{
		Version:   s.TiltBuildInfo.Version,
		CommitSHA: s.TiltBuildInfo.CommitSHA,
		Dev:       s.TiltBuildInfo.Dev,
		Date:      s.TiltBuildInfo.Date,
	}
	status.SuggestedTiltVersion = s.SuggestedTiltVersion
	status.FeatureFlags = []v1alpha1.UIFeatureFlag{}
	for k, v := range s.Features {
		status.FeatureFlags = append(status.FeatureFlags, v1alpha1.UIFeatureFlag{
			Name:  k,
			Value: v,
		})
	}
	sort.Slice(status.FeatureFlags, func(i, j int) bool {
		return status.FeatureFlags[i].Name < status.FeatureFlags[j].Name
	})
	if s.FatalError != nil {
		status.FatalError = s.FatalError.Error()
	}

	status.VersionSettings = v1alpha1.VersionSettings{
		CheckUpdates: s.VersionSettings.CheckUpdates,
	}

	status.TiltStartTime = metav1.NewTime(s.TiltStartTime)

	status.TiltfileKey = s.MainTiltfilePath()

	return ret
}

// Converts an EngineState into a list of UIResources.
// The order of the list is non-deterministic.
func ToUIResourceList(state store.EngineState, disableSources map[string][]v1alpha1.DisableSource) ([]*v1alpha1.UIResource, error) {
	ret := make([]*v1alpha1.UIResource, 0, len(state.ManifestTargets)+1)

	// All tiltfiles appear earlier than other resources in the same group.
	for _, name := range state.TiltfileDefinitionOrder {
		ms, ok := state.TiltfileStates[name]
		if !ok {
			continue
		}

		if m, ok := state.Manifest(name); ok {
			// TODO(milas): this is a hacky check to prevent creating Tiltfile
			// 	resources with the same name as k8s/dc/local resources, which
			// 	are held independently in the engine state; due to the way that
			// 	extension/Tiltfile loading happens in multiple phases split
			// 	between apiserver reconciler & engine reducer, there's currently
			// 	not a practical way to enforce uniqueness upfront, so we return
			// 	an error here, which will be fatal - the UX here is not great,
			// 	but this is hopefully enough of an edge case that users don't
			// 	hit it super frequently, and it prevents difficult to debug,
			// 	erratic behavior in the Tilt UI
			tfType := "Tiltfile"
			if isExtensionTiltfile(state.Tiltfiles[name.String()]) {
				tfType = "Extension"
			}

			return nil, fmt.Errorf(
				"%s %q has the same name as a %s resource",
				tfType, name, manifestType(m))
		}

		r := TiltfileResource(name, ms, state.LogStore)
		r.Status.Order = int32(len(ret) + 1)
		ret = append(ret, r)
	}

	_, holds := buildcontrol.NextTargetToBuild(state)

	for _, mt := range state.Targets() {
		mn := mt.Manifest.Name
		r, err := toUIResource(mt, state, disableSources[mn.String()], holds[mn])
		if err != nil {
			return nil, err
		}

		r.Status.Order = int32(len(ret) + 1)
		ret = append(ret, r)
	}

	return ret, nil
}

func disableResourceStatus(disableSources []v1alpha1.DisableSource, s store.EngineState) (v1alpha1.DisableResourceStatus, error) {
	getCM := func(name string) (v1alpha1.ConfigMap, error) {
		cm, ok := s.ConfigMaps[name]
		if !ok {
			gr := (&v1alpha1.ConfigMap{}).GetGroupVersionResource().GroupResource()
			return v1alpha1.ConfigMap{}, apierrors.NewNotFound(gr, name)
		}
		return *cm, nil
	}
	return uiresource.DisableResourceStatus(getCM, disableSources)
}

// Converts a ManifestTarget into the public data model representation,
// a UIResource.
func toUIResource(mt *store.ManifestTarget, s store.EngineState, disableSources []v1alpha1.DisableSource, hold store.Hold) (*v1alpha1.UIResource, error) {
	mn := mt.Manifest.Name
	ms := mt.State
	endpoints := store.ManifestTargetEndpoints(mt)

	bh := ToBuildsTerminated(ms.BuildHistory, s.LogStore)
	lastDeploy := metav1.NewMicroTime(ms.LastSuccessfulDeployTime)
	currentBuild := ms.EarliestCurrentBuild()
	cb := ToBuildRunning(currentBuild)

	specs, err := ToAPITargetSpecs(mt.Manifest.TargetSpecs())
	if err != nil {
		return nil, err
	}

	// NOTE(nick): Right now, the UX is designed to show the output exactly one
	// pod. A better UI might summarize the pods in other ways (e.g., show the
	// "most interesting" pod that's crash looping, or show logs from all pods
	// at once).
	hasPendingChanges, pendingBuildSince := ms.HasPendingChanges()

	drs, err := disableResourceStatus(disableSources, s)
	if err != nil {
		return nil, errors.Wrap(err, "error determining disable resource status")
	}

	r := &v1alpha1.UIResource{
		ObjectMeta: metav1.ObjectMeta{
			Name:   mn.String(),
			Labels: mt.Manifest.Labels,
		},
		Status: v1alpha1.UIResourceStatus{
			LastDeployTime:    lastDeploy,
			BuildHistory:      bh,
			PendingBuildSince: metav1.NewMicroTime(pendingBuildSince),
			CurrentBuild:      cb,
			EndpointLinks:     ToAPILinks(endpoints),
			Specs:             specs,
			TriggerMode:       int32(mt.Manifest.TriggerMode),
			HasPendingChanges: hasPendingChanges,
			Queued:            s.ManifestInTriggerQueue(mn),
			DisableStatus:     drs,
			Waiting:           holdToWaiting(hold),
		},
	}

	populateResourceInfoView(mt, r)

	r.Status.Conditions = []v1alpha1.UIResourceCondition{
		UIResourceUpToDateCondition(r.Status),
		UIResourceReadyCondition(r.Status),
	}
	return r, nil
}

// The "Ready" condition is a cross-resource status report that's synthesized
// from the more type-specific fields of UIResource.
func UIResourceReadyCondition(r v1alpha1.UIResourceStatus) v1alpha1.UIResourceCondition {
	c := v1alpha1.UIResourceCondition{
		Type:   v1alpha1.UIResourceReady,
		Status: metav1.ConditionUnknown,

		// LastTransitionTime will be computed by diffing against the current
		// Condition. This doesn't really fit into the usual reconciler pattern,
		// but is considered a worthwhile trade-off for the semantics we want, see discussion here:
		// https://maelvls.dev/kubernetes-conditions/
		LastTransitionTime: apis.NowMicro(),
	}

	if r.RuntimeStatus == v1alpha1.RuntimeStatusOK {
		c.Status = metav1.ConditionTrue
		return c
	}

	if r.RuntimeStatus == v1alpha1.RuntimeStatusNotApplicable && r.UpdateStatus == v1alpha1.UpdateStatusOK {
		c.Status = metav1.ConditionTrue
		return c
	}

	c.Status = metav1.ConditionFalse
	if r.DisableStatus.State == v1alpha1.DisableStateDisabled {
		c.Reason = "Disabled"
	} else if r.RuntimeStatus == v1alpha1.RuntimeStatusError {
		c.Reason = "RuntimeError"
	} else if r.UpdateStatus == v1alpha1.UpdateStatusError {
		c.Reason = "UpdateError"
	} else if r.UpdateStatus == v1alpha1.UpdateStatusOK && r.RuntimeStatus == v1alpha1.RuntimeStatusPending {
		c.Reason = "RuntimePending"
	} else if r.UpdateStatus == v1alpha1.UpdateStatusPending {
		c.Reason = "UpdatePending"
	} else {
		c.Reason = "Unknown"
	}
	return c
}

// The "UpToDate" condition is a cross-resource status report that's synthesized
// from the more type-specific fields of UIResource.
func UIResourceUpToDateCondition(r v1alpha1.UIResourceStatus) v1alpha1.UIResourceCondition {
	c := v1alpha1.UIResourceCondition{
		Type:               v1alpha1.UIResourceUpToDate,
		Status:             metav1.ConditionUnknown,
		LastTransitionTime: apis.NowMicro(),
	}

	if r.UpdateStatus == v1alpha1.UpdateStatusOK || r.UpdateStatus == v1alpha1.UpdateStatusNotApplicable {
		c.Status = metav1.ConditionTrue
		return c
	}

	c.Status = metav1.ConditionFalse
	if r.DisableStatus.State == v1alpha1.DisableStateDisabled {
		c.Reason = "Disabled"
	} else if r.UpdateStatus == v1alpha1.UpdateStatusError {
		c.Reason = "UpdateError"
	} else if r.UpdateStatus == v1alpha1.UpdateStatusPending {
		c.Reason = "UpdatePending"
	} else {
		c.Reason = "Unknown"
	}
	return c
}

// TODO(nick): We should build this from the Tiltfile in the apiserver,
// not the Tiltfile state in EngineState.
func TiltfileResource(name model.ManifestName, ms *store.ManifestState, logStore *logstore.LogStore) *v1alpha1.UIResource {
	ltfb := ms.LastBuild()
	ctfb := ms.EarliestCurrentBuild()

	pctfb := ToBuildRunning(ctfb)
	history := []v1alpha1.UIBuildTerminated{}
	if !ltfb.Empty() {
		history = append(history, ToBuildTerminated(ltfb, logStore))
	}
	tr := &v1alpha1.UIResource{
		ObjectMeta: metav1.ObjectMeta{
			Name: string(name),
		},
		Status: v1alpha1.UIResourceStatus{
			CurrentBuild:  pctfb,
			BuildHistory:  history,
			RuntimeStatus: v1alpha1.RuntimeStatusNotApplicable,
			UpdateStatus:  ms.UpdateStatus(model.TriggerModeAuto),
		},
	}
	start := metav1.NewMicroTime(ctfb.StartTime)
	finish := metav1.NewMicroTime(ltfb.FinishTime)
	if !ctfb.Empty() {
		tr.Status.PendingBuildSince = start
	} else {
		tr.Status.LastDeployTime = finish
	}

	tr.Status.Conditions = []v1alpha1.UIResourceCondition{
		UIResourceUpToDateCondition(tr.Status),
		UIResourceReadyCondition(tr.Status),
	}

	return tr
}

func populateResourceInfoView(mt *store.ManifestTarget, r *v1alpha1.UIResource) {
	r.Status.UpdateStatus = mt.UpdateStatus()
	r.Status.RuntimeStatus = mt.RuntimeStatus()

	if r.Status.DisableStatus.State == v1alpha1.DisableStateDisabled {
		r.Status.UpdateStatus = v1alpha1.UpdateStatusNone
		r.Status.RuntimeStatus = v1alpha1.RuntimeStatusNone
	}

	if mt.Manifest.IsLocal() {
		lState := mt.State.LocalRuntimeState()
		r.Status.LocalResourceInfo = &v1alpha1.UIResourceLocal{PID: int64(lState.PID)}
	}
	if mt.Manifest.IsK8s() {
		kState := mt.State.K8sRuntimeState()
		pod := kState.MostRecentPod()
		podID := k8s.PodID(pod.Name)
		rK8s := &v1alpha1.UIResourceKubernetes{
			PodName:            pod.Name,
			PodCreationTime:    pod.CreatedAt,
			PodUpdateStartTime: apis.NewTime(kState.UpdateStartTime[k8s.PodID(pod.Name)]),
			PodStatus:          pod.Status,
			PodStatusMessage:   strings.Join(pod.Errors, "\n"),
			AllContainersReady: store.AllPodContainersReady(pod),
			PodRestarts:        kState.VisiblePodContainerRestarts(podID),
			DisplayNames:       kState.EntityDisplayNames(),
		}
		if podID != "" {
			rK8s.SpanID = string(k8sconv.SpanIDForPod(mt.Manifest.Name, podID))
		}
		r.Status.K8sResourceInfo = rK8s
	}
}

func LogSegmentToEvent(seg *proto_webview.LogSegment, spans map[string]*proto_webview.LogSpan) store.LogAction {
	span, ok := spans[seg.SpanId]
	if !ok {
		// nonexistent span, ignore
		return store.LogAction{}
	}

	// TODO(maia): actually get level (just spoofing for now)
	spoofedLevel := logger.InfoLvl
	return store.NewLogAction(model.ManifestName(span.ManifestName), logstore.SpanID(seg.SpanId), spoofedLevel, seg.Fields, []byte(seg.Text))
}

func holdToWaiting(hold store.Hold) *v1alpha1.UIResourceStateWaiting {
	if hold.Reason == store.HoldReasonNone ||
		// "Reconciling" just means the live update is handling the update (rather
		// than the BuildController) and isn't indicative of a real waiting status.
		hold.Reason == store.HoldReasonReconciling {
		return nil
	}
	waiting := &v1alpha1.UIResourceStateWaiting{
		Reason: string(hold.Reason),
	}

	if hold.OnRefs != nil {
		waiting.On = hold.OnRefs
		return waiting
	}

	for _, targetID := range hold.HoldOn {
		var gvk schema.GroupVersionKind
		switch targetID.Type {
		case model.TargetTypeManifest:
			gvk = v1alpha1.SchemeGroupVersion.WithKind("UIResource")
		case model.TargetTypeImage:
			gvk = v1alpha1.SchemeGroupVersion.WithKind("ImageMap")
		default:
			continue
		}

		waiting.On = append(
			waiting.On, v1alpha1.UIResourceStateWaitingOnRef{
				Group:      gvk.Group,
				APIVersion: gvk.Version,
				Kind:       gvk.Kind,
				Name:       targetID.Name.String(),
			},
		)
	}
	return waiting
}

func manifestType(m model.Manifest) string {
	if m.IsK8s() {
		return "Kubernetes"
	}
	if m.IsDC() {
		return "Docker Compose"
	}
	if m.IsLocal() {
		return "local"
	}
	return "unknown"
}

func isExtensionTiltfile(tf *v1alpha1.Tiltfile) bool {
	if tf == nil {
		return false
	}
	ownerRefs := tf.GetOwnerReferences()
	for i := range ownerRefs {
		if ownerRefs[i].Kind == "Extension" {
			return true
		}
	}
	return false
}