aboutsummaryrefslogtreecommitdiff
path: root/weed/admin/config/schema.go
diff options
context:
space:
mode:
authorChris Lu <chrislusf@users.noreply.github.com>2025-07-30 12:38:03 -0700
committerGitHub <noreply@github.com>2025-07-30 12:38:03 -0700
commit891a2fb6ebc324329f5330a140b8cacff3899db4 (patch)
treed02aaa80a909e958aea831f206b3240b0237d7b7 /weed/admin/config/schema.go
parent64198dad8346fe284cbef944fe01ff0d062c147d (diff)
downloadseaweedfs-891a2fb6ebc324329f5330a140b8cacff3899db4.tar.xz
seaweedfs-891a2fb6ebc324329f5330a140b8cacff3899db4.zip
Admin: misc improvements on admin server and workers. EC now works. (#7055)
* initial design * added simulation as tests * reorganized the codebase to move the simulation framework and tests into their own dedicated package * integration test. ec worker task * remove "enhanced" reference * start master, volume servers, filer Current Status ✅ Master: Healthy and running (port 9333) ✅ Filer: Healthy and running (port 8888) ✅ Volume Servers: All 6 servers running (ports 8080-8085) 🔄 Admin/Workers: Will start when dependencies are ready * generate write load * tasks are assigned * admin start wtih grpc port. worker has its own working directory * Update .gitignore * working worker and admin. Task detection is not working yet. * compiles, detection uses volumeSizeLimitMB from master * compiles * worker retries connecting to admin * build and restart * rendering pending tasks * skip task ID column * sticky worker id * test canScheduleTaskNow * worker reconnect to admin * clean up logs * worker register itself first * worker can run ec work and report status but: 1. one volume should not be repeatedly worked on. 2. ec shards needs to be distributed and source data should be deleted. * move ec task logic * listing ec shards * local copy, ec. Need to distribute. * ec is mostly working now * distribution of ec shards needs improvement * need configuration to enable ec * show ec volumes * interval field UI component * rename * integration test with vauuming * garbage percentage threshold * fix warning * display ec shard sizes * fix ec volumes list * Update ui.go * show default values * ensure correct default value * MaintenanceConfig use ConfigField * use schema defined defaults * config * reduce duplication * refactor to use BaseUIProvider * each task register its schema * checkECEncodingCandidate use ecDetector * use vacuumDetector * use volumeSizeLimitMB * remove remove * remove unused * refactor * use new framework * remove v2 reference * refactor * left menu can scroll now * The maintenance manager was not being initialized when no data directory was configured for persistent storage. * saving config * Update task_config_schema_templ.go * enable/disable tasks * protobuf encoded task configurations * fix system settings * use ui component * remove logs * interface{} Reduction * reduce interface{} * reduce interface{} * avoid from/to map * reduce interface{} * refactor * keep it DRY * added logging * debug messages * debug level * debug * show the log caller line * use configured task policy * log level * handle admin heartbeat response * Update worker.go * fix EC rack and dc count * Report task status to admin server * fix task logging, simplify interface checking, use erasure_coding constants * factor in empty volume server during task planning * volume.list adds disk id * track disk id also * fix locking scheduled and manual scanning * add active topology * simplify task detector * ec task completed, but shards are not showing up * implement ec in ec_typed.go * adjust log level * dedup * implementing ec copying shards and only ecx files * use disk id when distributing ec shards 🎯 Planning: ActiveTopology creates DestinationPlan with specific TargetDisk 📦 Task Creation: maintenance_integration.go creates ECDestination with DiskId 🚀 Task Execution: EC task passes DiskId in VolumeEcShardsCopyRequest 💾 Volume Server: Receives disk_id and stores shards on specific disk (vs.store.Locations[req.DiskId]) 📂 File System: EC shards and metadata land in the exact disk directory planned * Delete original volume from all locations * clean up existing shard locations * local encoding and distributing * Update docker/admin_integration/EC-TESTING-README.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> * check volume id range * simplify * fix tests * fix types * clean up logs and tests --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Diffstat (limited to 'weed/admin/config/schema.go')
-rw-r--r--weed/admin/config/schema.go360
1 files changed, 360 insertions, 0 deletions
diff --git a/weed/admin/config/schema.go b/weed/admin/config/schema.go
new file mode 100644
index 000000000..54fb615f9
--- /dev/null
+++ b/weed/admin/config/schema.go
@@ -0,0 +1,360 @@
+package config
+
+import (
+ "fmt"
+ "reflect"
+ "strings"
+ "time"
+)
+
+// ConfigWithDefaults defines an interface for configurations that can apply their own defaults
+type ConfigWithDefaults interface {
+ // ApplySchemaDefaults applies default values using the provided schema
+ ApplySchemaDefaults(schema *Schema) error
+ // Validate validates the configuration
+ Validate() error
+}
+
+// FieldType defines the type of a configuration field
+type FieldType string
+
+const (
+ FieldTypeBool FieldType = "bool"
+ FieldTypeInt FieldType = "int"
+ FieldTypeDuration FieldType = "duration"
+ FieldTypeInterval FieldType = "interval"
+ FieldTypeString FieldType = "string"
+ FieldTypeFloat FieldType = "float"
+)
+
+// FieldUnit defines the unit for display purposes
+type FieldUnit string
+
+const (
+ UnitSeconds FieldUnit = "seconds"
+ UnitMinutes FieldUnit = "minutes"
+ UnitHours FieldUnit = "hours"
+ UnitDays FieldUnit = "days"
+ UnitCount FieldUnit = "count"
+ UnitNone FieldUnit = ""
+)
+
+// Field defines a configuration field with all its metadata
+type Field struct {
+ // Field identification
+ Name string `json:"name"`
+ JSONName string `json:"json_name"`
+ Type FieldType `json:"type"`
+
+ // Default value and validation
+ DefaultValue interface{} `json:"default_value"`
+ MinValue interface{} `json:"min_value,omitempty"`
+ MaxValue interface{} `json:"max_value,omitempty"`
+ Required bool `json:"required"`
+
+ // UI display
+ DisplayName string `json:"display_name"`
+ Description string `json:"description"`
+ HelpText string `json:"help_text"`
+ Placeholder string `json:"placeholder"`
+ Unit FieldUnit `json:"unit"`
+
+ // Form rendering
+ InputType string `json:"input_type"` // "checkbox", "number", "text", "interval", etc.
+ CSSClasses string `json:"css_classes,omitempty"`
+}
+
+// GetDisplayValue returns the value formatted for display in the specified unit
+func (f *Field) GetDisplayValue(value interface{}) interface{} {
+ if (f.Type == FieldTypeDuration || f.Type == FieldTypeInterval) && f.Unit != UnitSeconds {
+ if duration, ok := value.(time.Duration); ok {
+ switch f.Unit {
+ case UnitMinutes:
+ return int(duration.Minutes())
+ case UnitHours:
+ return int(duration.Hours())
+ case UnitDays:
+ return int(duration.Hours() / 24)
+ }
+ }
+ if seconds, ok := value.(int); ok {
+ switch f.Unit {
+ case UnitMinutes:
+ return seconds / 60
+ case UnitHours:
+ return seconds / 3600
+ case UnitDays:
+ return seconds / (24 * 3600)
+ }
+ }
+ }
+ return value
+}
+
+// GetIntervalDisplayValue returns the value and unit for interval fields
+func (f *Field) GetIntervalDisplayValue(value interface{}) (int, string) {
+ if f.Type != FieldTypeInterval {
+ return 0, "minutes"
+ }
+
+ seconds := 0
+ if duration, ok := value.(time.Duration); ok {
+ seconds = int(duration.Seconds())
+ } else if s, ok := value.(int); ok {
+ seconds = s
+ }
+
+ return SecondsToIntervalValueUnit(seconds)
+}
+
+// SecondsToIntervalValueUnit converts seconds to the most appropriate interval unit
+func SecondsToIntervalValueUnit(totalSeconds int) (int, string) {
+ if totalSeconds == 0 {
+ return 0, "minutes"
+ }
+
+ // Check if it's evenly divisible by days
+ if totalSeconds%(24*3600) == 0 {
+ return totalSeconds / (24 * 3600), "days"
+ }
+
+ // Check if it's evenly divisible by hours
+ if totalSeconds%3600 == 0 {
+ return totalSeconds / 3600, "hours"
+ }
+
+ // Default to minutes
+ return totalSeconds / 60, "minutes"
+}
+
+// IntervalValueUnitToSeconds converts interval value and unit to seconds
+func IntervalValueUnitToSeconds(value int, unit string) int {
+ switch unit {
+ case "days":
+ return value * 24 * 3600
+ case "hours":
+ return value * 3600
+ case "minutes":
+ return value * 60
+ default:
+ return value * 60 // Default to minutes
+ }
+}
+
+// ParseDisplayValue converts a display value back to the storage format
+func (f *Field) ParseDisplayValue(displayValue interface{}) interface{} {
+ if (f.Type == FieldTypeDuration || f.Type == FieldTypeInterval) && f.Unit != UnitSeconds {
+ if val, ok := displayValue.(int); ok {
+ switch f.Unit {
+ case UnitMinutes:
+ return val * 60
+ case UnitHours:
+ return val * 3600
+ case UnitDays:
+ return val * 24 * 3600
+ }
+ }
+ }
+ return displayValue
+}
+
+// ParseIntervalFormData parses form data for interval fields (value + unit)
+func (f *Field) ParseIntervalFormData(valueStr, unitStr string) (int, error) {
+ if f.Type != FieldTypeInterval {
+ return 0, fmt.Errorf("field %s is not an interval field", f.Name)
+ }
+
+ value := 0
+ if valueStr != "" {
+ var err error
+ value, err = fmt.Sscanf(valueStr, "%d", &value)
+ if err != nil {
+ return 0, fmt.Errorf("invalid interval value: %s", valueStr)
+ }
+ }
+
+ return IntervalValueUnitToSeconds(value, unitStr), nil
+}
+
+// ValidateValue validates a value against the field constraints
+func (f *Field) ValidateValue(value interface{}) error {
+ if f.Required && (value == nil || value == "" || value == 0) {
+ return fmt.Errorf("%s is required", f.DisplayName)
+ }
+
+ if f.MinValue != nil {
+ if !f.compareValues(value, f.MinValue, ">=") {
+ return fmt.Errorf("%s must be >= %v", f.DisplayName, f.MinValue)
+ }
+ }
+
+ if f.MaxValue != nil {
+ if !f.compareValues(value, f.MaxValue, "<=") {
+ return fmt.Errorf("%s must be <= %v", f.DisplayName, f.MaxValue)
+ }
+ }
+
+ return nil
+}
+
+// compareValues compares two values based on the operator
+func (f *Field) compareValues(a, b interface{}, op string) bool {
+ switch f.Type {
+ case FieldTypeInt:
+ aVal, aOk := a.(int)
+ bVal, bOk := b.(int)
+ if !aOk || !bOk {
+ return false
+ }
+ switch op {
+ case ">=":
+ return aVal >= bVal
+ case "<=":
+ return aVal <= bVal
+ }
+ case FieldTypeFloat:
+ aVal, aOk := a.(float64)
+ bVal, bOk := b.(float64)
+ if !aOk || !bOk {
+ return false
+ }
+ switch op {
+ case ">=":
+ return aVal >= bVal
+ case "<=":
+ return aVal <= bVal
+ }
+ }
+ return true
+}
+
+// Schema provides common functionality for configuration schemas
+type Schema struct {
+ Fields []*Field `json:"fields"`
+}
+
+// GetFieldByName returns a field by its JSON name
+func (s *Schema) GetFieldByName(jsonName string) *Field {
+ for _, field := range s.Fields {
+ if field.JSONName == jsonName {
+ return field
+ }
+ }
+ return nil
+}
+
+// ApplyDefaultsToConfig applies defaults to a configuration that implements ConfigWithDefaults
+func (s *Schema) ApplyDefaultsToConfig(config ConfigWithDefaults) error {
+ return config.ApplySchemaDefaults(s)
+}
+
+// ApplyDefaultsToProtobuf applies defaults to protobuf types using reflection
+func (s *Schema) ApplyDefaultsToProtobuf(config interface{}) error {
+ return s.applyDefaultsReflection(config)
+}
+
+// applyDefaultsReflection applies default values using reflection (internal use only)
+// Used for protobuf types and embedded struct handling
+func (s *Schema) applyDefaultsReflection(config interface{}) error {
+ configValue := reflect.ValueOf(config)
+ if configValue.Kind() == reflect.Ptr {
+ configValue = configValue.Elem()
+ }
+
+ if configValue.Kind() != reflect.Struct {
+ return fmt.Errorf("config must be a struct or pointer to struct")
+ }
+
+ configType := configValue.Type()
+
+ for i := 0; i < configValue.NumField(); i++ {
+ field := configValue.Field(i)
+ fieldType := configType.Field(i)
+
+ // Handle embedded structs recursively (before JSON tag check)
+ if field.Kind() == reflect.Struct && fieldType.Anonymous {
+ if !field.CanAddr() {
+ return fmt.Errorf("embedded struct %s is not addressable - config must be a pointer", fieldType.Name)
+ }
+ err := s.applyDefaultsReflection(field.Addr().Interface())
+ if err != nil {
+ return fmt.Errorf("failed to apply defaults to embedded struct %s: %v", fieldType.Name, err)
+ }
+ continue
+ }
+
+ // Get JSON tag name
+ jsonTag := fieldType.Tag.Get("json")
+ if jsonTag == "" {
+ continue
+ }
+
+ // Remove options like ",omitempty"
+ if commaIdx := strings.Index(jsonTag, ","); commaIdx >= 0 {
+ jsonTag = jsonTag[:commaIdx]
+ }
+
+ // Find corresponding schema field
+ schemaField := s.GetFieldByName(jsonTag)
+ if schemaField == nil {
+ continue
+ }
+
+ // Apply default if field is zero value
+ if field.CanSet() && field.IsZero() {
+ defaultValue := reflect.ValueOf(schemaField.DefaultValue)
+ if defaultValue.Type().ConvertibleTo(field.Type()) {
+ field.Set(defaultValue.Convert(field.Type()))
+ }
+ }
+ }
+
+ return nil
+}
+
+// ValidateConfig validates a configuration against the schema
+func (s *Schema) ValidateConfig(config interface{}) []error {
+ var errors []error
+
+ configValue := reflect.ValueOf(config)
+ if configValue.Kind() == reflect.Ptr {
+ configValue = configValue.Elem()
+ }
+
+ if configValue.Kind() != reflect.Struct {
+ errors = append(errors, fmt.Errorf("config must be a struct or pointer to struct"))
+ return errors
+ }
+
+ configType := configValue.Type()
+
+ for i := 0; i < configValue.NumField(); i++ {
+ field := configValue.Field(i)
+ fieldType := configType.Field(i)
+
+ // Get JSON tag name
+ jsonTag := fieldType.Tag.Get("json")
+ if jsonTag == "" {
+ continue
+ }
+
+ // Remove options like ",omitempty"
+ if commaIdx := strings.Index(jsonTag, ","); commaIdx > 0 {
+ jsonTag = jsonTag[:commaIdx]
+ }
+
+ // Find corresponding schema field
+ schemaField := s.GetFieldByName(jsonTag)
+ if schemaField == nil {
+ continue
+ }
+
+ // Validate field value
+ fieldValue := field.Interface()
+ if err := schemaField.ValidateValue(fieldValue); err != nil {
+ errors = append(errors, err)
+ }
+ }
+
+ return errors
+}