etcd/server/cluster_config.go

package server

import (
	"time"
)

const (
	// DefaultActiveSize is the default number of active followers allowed.
	DefaultActiveSize = 9

	// MinActiveSize is the minimum active size allowed.
	MinActiveSize = 3

	// DefaultRemoveDelay is the default elapsed time before promotion.
	DefaultRemoveDelay = int((30 * time.Minute) / time.Second)

	// MinRemoveDelay is the minimum promote delay allowed.
	MinRemoveDelay = int((2 * time.Second) / time.Second)

	// DefaultSyncClusterInterval is the default interval for cluster sync.
	DefaultSyncClusterInterval = int((30 * time.Minute) / time.Second)

	// MinSyncClusterInterval is the minimum sync interval allowed.
	MinSyncClusterInterval = int((1 * time.Second) / time.Second)
)

// ClusterConfig represents cluster-wide configuration settings.
// These settings can only be changed through Raft.
type ClusterConfig struct {
	// ActiveSize is the maximum number of node that can join as Raft followers.
	// Nodes that join the cluster after the limit is reached are standbys.
	ActiveSize int `json:"activeSize"`

	// RemoveDelay is the amount of time, in seconds, after a node is
	// unreachable that it will be swapped out as a standby node.
	RemoveDelay int `json:"removeDelay"`

	// SyncClusterInterval is the amount of time, in seconds, between
	// cluster sync when it runs in standby mode.
	SyncClusterInterval int `json:"syncClusterInterval"`
}

// NewClusterConfig returns a cluster configuration with default settings.
func NewClusterConfig() *ClusterConfig {
	return &ClusterConfig{
		ActiveSize:          DefaultActiveSize,
		RemoveDelay:         DefaultRemoveDelay,
		SyncClusterInterval: DefaultSyncClusterInterval,
	}
}