seaweedfs/weed/admin/plugin/registry.go

package plugin

import (
	"fmt"
	"sort"
	"strings"
	"sync"
	"time"

	"github.com/seaweedfs/seaweedfs/weed/pb/plugin_pb"
	"google.golang.org/protobuf/proto"
)

const defaultWorkerStaleTimeout = 2 * time.Minute

// WorkerSession contains tracked worker metadata and plugin status.
type WorkerSession struct {
	WorkerID        string
	WorkerInstance  string
	Address         string
	WorkerVersion   string
	ProtocolVersion string
	ConnectedAt     time.Time
	LastSeenAt      time.Time
	Capabilities    map[string]*plugin_pb.JobTypeCapability
	Heartbeat       *plugin_pb.WorkerHeartbeat
}

// Registry tracks connected plugin workers and capability-based selection.
type Registry struct {
	mu             sync.RWMutex
	sessions       map[string]*WorkerSession
	staleAfter     time.Duration
	detectorCursor map[string]int
	executorCursor map[string]int
}

func NewRegistry() *Registry {
	return &Registry{
		sessions:       make(map[string]*WorkerSession),
		staleAfter:     defaultWorkerStaleTimeout,
		detectorCursor: make(map[string]int),
		executorCursor: make(map[string]int),
	}
}

func (r *Registry) UpsertFromHello(hello *plugin_pb.WorkerHello) *WorkerSession {
	now := time.Now()
	caps := make(map[string]*plugin_pb.JobTypeCapability, len(hello.Capabilities))
	for _, c := range hello.Capabilities {
		if c == nil || c.JobType == "" {
			continue
		}
		caps[c.JobType] = cloneJobTypeCapability(c)
	}

	r.mu.Lock()
	defer r.mu.Unlock()

	session, ok := r.sessions[hello.WorkerId]
	if !ok {
		session = &WorkerSession{
			WorkerID:    hello.WorkerId,
			ConnectedAt: now,
		}
		r.sessions[hello.WorkerId] = session
	}

	session.WorkerInstance = hello.WorkerInstanceId
	session.Address = hello.Address
	session.WorkerVersion = hello.WorkerVersion
	session.ProtocolVersion = hello.ProtocolVersion
	session.LastSeenAt = now
	session.Capabilities = caps

	return cloneWorkerSession(session)
}

func (r *Registry) Remove(workerID string) {
	r.mu.Lock()
	defer r.mu.Unlock()
	delete(r.sessions, workerID)
}

func (r *Registry) UpdateHeartbeat(workerID string, heartbeat *plugin_pb.WorkerHeartbeat) {
	r.mu.Lock()
	defer r.mu.Unlock()

	session, ok := r.sessions[workerID]
	if !ok {
		return
	}
	session.Heartbeat = cloneWorkerHeartbeat(heartbeat)
	session.LastSeenAt = time.Now()
}

func (r *Registry) Get(workerID string) (*WorkerSession, bool) {
	r.mu.RLock()
	defer r.mu.RUnlock()
	session, ok := r.sessions[workerID]
	if !ok || r.isSessionStaleLocked(session, time.Now()) {
		return nil, false
	}
	return cloneWorkerSession(session), true
}

func (r *Registry) List() []*WorkerSession {
	r.mu.RLock()
	defer r.mu.RUnlock()
	out := make([]*WorkerSession, 0, len(r.sessions))
	now := time.Now()
	for _, s := range r.sessions {
		if r.isSessionStaleLocked(s, now) {
			continue
		}
		out = append(out, cloneWorkerSession(s))
	}
	sort.Slice(out, func(i, j int) bool {
		return out[i].WorkerID < out[j].WorkerID
	})
	return out
}

// HasCapableWorker checks if any non-stale worker session has a capability for the given job type.
// A worker is capable if its capabilities include the job type with CanDetect or CanExecute true.
func (r *Registry) HasCapableWorker(jobType string) bool {
	r.mu.RLock()
	defer r.mu.RUnlock()

	now := time.Now()
	for _, session := range r.sessions {
		if r.isSessionStaleLocked(session, now) {
			continue
		}
		capability := session.Capabilities[jobType]
		if capability == nil {
			continue
		}
		if capability.CanDetect || capability.CanExecute {
			return true
		}
	}
	return false
}

// CountCapableExecutors returns the number of non-stale workers that
// can EXECUTE the given job type. Used by per-job-type cluster
// allocators (e.g. the s3_lifecycle delete-rate divider) to compute a
// per-worker share at dispatch time. Returns 0 when no executor is
// available — callers should treat that as "skip allocation" rather
// than dividing by zero.
func (r *Registry) CountCapableExecutors(jobType string) int {
	r.mu.RLock()
	defer r.mu.RUnlock()

	now := time.Now()
	n := 0
	for _, session := range r.sessions {
		if r.isSessionStaleLocked(session, now) {
			continue
		}
		capability := session.Capabilities[jobType]
		if capability == nil || !capability.CanExecute {
			continue
		}
		n++
	}
	return n
}

// DetectableJobTypes returns sorted job types that currently have at least one detect-capable worker.
func (r *Registry) DetectableJobTypes() []string {
	r.mu.RLock()
	defer r.mu.RUnlock()

	jobTypes := make(map[string]struct{})
	now := time.Now()
	for _, session := range r.sessions {
		if r.isSessionStaleLocked(session, now) {
			continue
		}
		for jobType, capability := range session.Capabilities {
			if capability == nil || !capability.CanDetect {
				continue
			}
			jobTypes[jobType] = struct{}{}
		}
	}

	out := make([]string, 0, len(jobTypes))
	for jobType := range jobTypes {
		out = append(out, jobType)
	}
	sort.Strings(out)
	return out
}

// JobTypes returns sorted job types known by connected workers regardless of capability kind.
func (r *Registry) JobTypes() []string {
	r.mu.RLock()
	defer r.mu.RUnlock()

	jobTypes := make(map[string]struct{})
	now := time.Now()
	for _, session := range r.sessions {
		if r.isSessionStaleLocked(session, now) {
			continue
		}
		for jobType := range session.Capabilities {
			if jobType == "" {
				continue
			}
			jobTypes[jobType] = struct{}{}
		}
	}

	out := make([]string, 0, len(jobTypes))
	for jobType := range jobTypes {
		out = append(out, jobType)
	}
	sort.Strings(out)
	return out
}

// PickSchemaProvider picks one worker for schema requests.
// Preference order:
// 1) workers that can detect this job type
// 2) workers that can execute this job type
// tie-break: more free slots, then lexical worker ID.
func (r *Registry) PickSchemaProvider(jobType string) (*WorkerSession, error) {
	r.mu.RLock()
	defer r.mu.RUnlock()

	var candidates []*WorkerSession
	now := time.Now()
	for _, s := range r.sessions {
		if r.isSessionStaleLocked(s, now) {
			continue
		}
		capability := s.Capabilities[jobType]
		if capability == nil {
			continue
		}
		if capability.CanDetect || capability.CanExecute {
			candidates = append(candidates, s)
		}
	}

	if len(candidates) == 0 {
		return nil, fmt.Errorf("no worker available for schema job_type=%s", jobType)
	}

	sort.Slice(candidates, func(i, j int) bool {
		a := candidates[i]
		b := candidates[j]
		ac := a.Capabilities[jobType]
		bc := b.Capabilities[jobType]

		// Prefer detect-capable providers first.
		if ac.CanDetect != bc.CanDetect {
			return ac.CanDetect
		}

		aSlots := availableDetectionSlots(a, ac) + availableExecutionSlots(a, ac)
		bSlots := availableDetectionSlots(b, bc) + availableExecutionSlots(b, bc)
		if aSlots != bSlots {
			return aSlots > bSlots
		}
		return a.WorkerID < b.WorkerID
	})

	return cloneWorkerSession(candidates[0]), nil
}

// PickDetector picks one detector worker for a job type, skipping any
// worker IDs in excluded.
func (r *Registry) PickDetector(jobType string, excluded ...string) (*WorkerSession, error) {
	return r.pickByKind(jobType, true, excluded)
}

// PickExecutor picks one executor worker for a job type.
// preferredHosts, when set, ranks workers whose Hello Address host matches a
// replica/source host ahead of others (same-machine EC pull). Empty means the
// previous slots+round-robin order.
func (r *Registry) PickExecutor(jobType string, preferredHosts ...string) (*WorkerSession, error) {
	list, err := r.ListExecutors(jobType, preferredHosts...)
	if err != nil {
		return nil, err
	}
	return list[0], nil
}

// ListExecutors returns sorted executor candidates for one job type.
// Ordering is by most available execution slots, then lexical worker ID.
// The top tie group is rotated round-robin to prevent sticky assignment.
// preferredHosts, when any worker matches, are listed first (then the rest);
// rotation applies only inside the preferred group so a local worker is not
// rotated away in favor of a remote one.
func (r *Registry) ListExecutors(jobType string, preferredHosts ...string) ([]*WorkerSession, error) {
	r.mu.Lock()
	defer r.mu.Unlock()

	candidates := r.collectByKindLocked(jobType, false, time.Now())
	if len(candidates) == 0 {
		return nil, fmt.Errorf("no executor worker available for job_type=%s", jobType)
	}

	pref, rest := partitionByPreferredHost(candidates, preferredHosts)
	if len(pref) > 0 {
		sortByKind(pref, jobType, false)
		r.rotateTopCandidatesLocked(pref, jobType, false)
		sortByKind(rest, jobType, false)
		candidates = append(pref, rest...)
	} else {
		sortByKind(candidates, jobType, false)
		r.rotateTopCandidatesLocked(candidates, jobType, false)
	}

	out := make([]*WorkerSession, 0, len(candidates))
	for _, candidate := range candidates {
		out = append(out, cloneWorkerSession(candidate))
	}
	return out, nil
}

func (r *Registry) pickByKind(jobType string, detect bool, excluded []string) (*WorkerSession, error) {
	r.mu.Lock()
	defer r.mu.Unlock()

	candidates := r.collectByKindLocked(jobType, detect, time.Now())
	if len(excluded) > 0 {
		skip := make(map[string]struct{}, len(excluded))
		for _, workerID := range excluded {
			skip[workerID] = struct{}{}
		}
		kept := candidates[:0]
		for _, candidate := range candidates {
			if _, found := skip[candidate.WorkerID]; !found {
				kept = append(kept, candidate)
			}
		}
		candidates = kept
	}

	if len(candidates) == 0 {
		kind := "executor"
		if detect {
			kind = "detector"
		}
		return nil, fmt.Errorf("no %s worker available for job_type=%s", kind, jobType)
	}

	sortByKind(candidates, jobType, detect)
	r.rotateTopCandidatesLocked(candidates, jobType, detect)

	return cloneWorkerSession(candidates[0]), nil
}

func (r *Registry) collectByKindLocked(jobType string, detect bool, now time.Time) []*WorkerSession {
	var candidates []*WorkerSession
	for _, session := range r.sessions {
		if r.isSessionStaleLocked(session, now) {
			continue
		}
		capability := session.Capabilities[jobType]
		if capability == nil {
			continue
		}
		if detect && capability.CanDetect {
			candidates = append(candidates, session)
		}
		if !detect && capability.CanExecute {
			candidates = append(candidates, session)
		}
	}
	return candidates
}

func (r *Registry) isSessionStaleLocked(session *WorkerSession, now time.Time) bool {
	if session == nil {
		return true
	}
	if r.staleAfter <= 0 {
		return false
	}

	lastSeen := session.LastSeenAt
	if lastSeen.IsZero() {
		lastSeen = session.ConnectedAt
	}
	if lastSeen.IsZero() {
		return false
	}
	return now.Sub(lastSeen) > r.staleAfter
}

func sortByKind(candidates []*WorkerSession, jobType string, detect bool) {
	sort.Slice(candidates, func(i, j int) bool {
		a := candidates[i]
		b := candidates[j]
		ac := a.Capabilities[jobType]
		bc := b.Capabilities[jobType]

		aSlots := availableSlotsByKind(a, ac, detect)
		bSlots := availableSlotsByKind(b, bc, detect)

		if aSlots != bSlots {
			return aSlots > bSlots
		}
		return a.WorkerID < b.WorkerID
	})
}

func (r *Registry) rotateTopCandidatesLocked(candidates []*WorkerSession, jobType string, detect bool) {
	if len(candidates) < 2 {
		return
	}

	capability := candidates[0].Capabilities[jobType]
	topSlots := availableSlotsByKind(candidates[0], capability, detect)
	tieEnd := 1
	for tieEnd < len(candidates) {
		nextCapability := candidates[tieEnd].Capabilities[jobType]
		if availableSlotsByKind(candidates[tieEnd], nextCapability, detect) != topSlots {
			break
		}
		tieEnd++
	}
	if tieEnd <= 1 {
		return
	}

	cursorKey := strings.TrimSpace(jobType)
	if cursorKey == "" {
		cursorKey = "*"
	}

	var offset int
	if detect {
		offset = r.detectorCursor[cursorKey] % tieEnd
		r.detectorCursor[cursorKey] = (offset + 1) % tieEnd
	} else {
		offset = r.executorCursor[cursorKey] % tieEnd
		r.executorCursor[cursorKey] = (offset + 1) % tieEnd
	}

	if offset == 0 {
		return
	}

	prefix := append([]*WorkerSession(nil), candidates[:tieEnd]...)
	for i := 0; i < tieEnd; i++ {
		candidates[i] = prefix[(i+offset)%tieEnd]
	}
}

func availableSlotsByKind(
	session *WorkerSession,
	capability *plugin_pb.JobTypeCapability,
	detect bool,
) int {
	if detect {
		return availableDetectionSlots(session, capability)
	}
	return availableExecutionSlots(session, capability)
}

func availableDetectionSlots(session *WorkerSession, capability *plugin_pb.JobTypeCapability) int {
	if session.Heartbeat != nil && session.Heartbeat.DetectionSlotsTotal > 0 {
		free := int(session.Heartbeat.DetectionSlotsTotal - session.Heartbeat.DetectionSlotsUsed)
		if free < 0 {
			return 0
		}
		return free
	}
	if capability.MaxDetectionConcurrency > 0 {
		return int(capability.MaxDetectionConcurrency)
	}
	return 1
}

func availableExecutionSlots(session *WorkerSession, capability *plugin_pb.JobTypeCapability) int {
	if session.Heartbeat != nil && session.Heartbeat.ExecutionSlotsTotal > 0 {
		free := int(session.Heartbeat.ExecutionSlotsTotal - session.Heartbeat.ExecutionSlotsUsed)
		if free < 0 {
			return 0
		}
		return free
	}
	if capability.MaxExecutionConcurrency > 0 {
		return int(capability.MaxExecutionConcurrency)
	}
	return 1
}

func cloneWorkerSession(in *WorkerSession) *WorkerSession {
	if in == nil {
		return nil
	}
	out := *in
	out.Capabilities = make(map[string]*plugin_pb.JobTypeCapability, len(in.Capabilities))
	for jobType, cap := range in.Capabilities {
		out.Capabilities[jobType] = cloneJobTypeCapability(cap)
	}
	out.Heartbeat = cloneWorkerHeartbeat(in.Heartbeat)
	return &out
}

func cloneJobTypeCapability(in *plugin_pb.JobTypeCapability) *plugin_pb.JobTypeCapability {
	if in == nil {
		return nil
	}
	return proto.Clone(in).(*plugin_pb.JobTypeCapability)
}

func cloneWorkerHeartbeat(in *plugin_pb.WorkerHeartbeat) *plugin_pb.WorkerHeartbeat {
	if in == nil {
		return nil
	}
	out := proto.Clone(in).(*plugin_pb.WorkerHeartbeat)
	if in.RunningWork != nil {
		running := out.RunningWork[:0]
		// Clone can turn nil messages into empty messages, so filter using
		// their original positions while reusing the cloned entries.
		for i, work := range in.RunningWork {
			if work != nil {
				running = append(running, out.RunningWork[i])
			}
		}
		clear(out.RunningWork[len(running):])
		if running == nil {
			running = []*plugin_pb.RunningWork{}
		}
		out.RunningWork = running
	}
	// Preserve writable empty maps without rebuilding populated clones.
	if in.QueuedJobsByType != nil && out.QueuedJobsByType == nil {
		out.QueuedJobsByType = make(map[string]int32)
	}
	if in.Metadata != nil && out.Metadata == nil {
		out.Metadata = make(map[string]string)
	}
	return out
}