/* Copyright 2016 The Kubernetes Authors. 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 storagebackend import ( "time" oteltrace "go.opentelemetry.io/otel/trace" noopoteltrace "go.opentelemetry.io/otel/trace/noop" "k8s.io/apimachinery/pkg/runtime" "k8s.io/apimachinery/pkg/runtime/schema" "k8s.io/apiserver/pkg/server/egressselector" "k8s.io/apiserver/pkg/storage/etcd3" "k8s.io/apiserver/pkg/storage/value" flowcontrolrequest "k8s.io/apiserver/pkg/util/flowcontrol/request" ) const ( StorageTypeUnset = "" StorageTypeETCD2 = "etcd2" StorageTypeETCD3 = "etcd3" DefaultCompactInterval = 5 * time.Minute DefaultDBMetricPollInterval = 30 * time.Second DefaultEventsHistoryWindow = 75 * time.Second DefaultHealthcheckTimeout = 2 * time.Second DefaultReadinessTimeout = 2 * time.Second ) // TransportConfig holds all connection related info, i.e. equal TransportConfig means equal servers we talk to. type TransportConfig struct { // ServerList is the list of storage servers to connect with. ServerList []string // TLS credentials KeyFile string CertFile string TrustedCAFile string // function to determine the egress dialer. (i.e. konnectivity server dialer) EgressLookup egressselector.Lookup // The TracerProvider can add tracing the connection TracerProvider oteltrace.TracerProvider } // Config is configuration for creating a storage backend. type Config struct { // Type defines the type of storage backend. Default ("") is "etcd3". Type string // Prefix is the prefix to all keys passed to storage.Interface methods. Prefix string // Transport holds all connection related info, i.e. equal TransportConfig means equal servers we talk to. Transport TransportConfig Codec runtime.Codec // EncodeVersioner is the same groupVersioner used to build the // storage encoder. Given a list of kinds the input object might belong // to, the EncodeVersioner outputs the gvk the object will be // converted to before persisted in etcd. EncodeVersioner runtime.GroupVersioner // Transformer allows the value to be transformed prior to persisting into etcd. Transformer value.Transformer // CompactionInterval is an interval of requesting compaction from apiserver. // If the value is 0, no compaction will be issued. CompactionInterval time.Duration // CountMetricPollPeriod specifies how often should count metric be updated CountMetricPollPeriod time.Duration // DBMetricPollInterval specifies how often should storage backend metric be updated. DBMetricPollInterval time.Duration // EventsHistoryWindow specifies minimum history duration that storage is keeping. EventsHistoryWindow time.Duration // HealthcheckTimeout specifies the timeout used when checking health HealthcheckTimeout time.Duration // ReadycheckTimeout specifies the timeout used when checking readiness ReadycheckTimeout time.Duration LeaseManagerConfig etcd3.LeaseManagerConfig // StorageObjectCountTracker is used to keep track of the total // number of objects in the storage per resource. StorageObjectCountTracker flowcontrolrequest.StorageObjectCountTracker } // ConfigForResource is a Config specialized to a particular `schema.GroupResource` type ConfigForResource struct { // Config is the resource-independent configuration Config // GroupResource is the relevant one GroupResource schema.GroupResource } // ForResource specializes to the given resource func (config *Config) ForResource(resource schema.GroupResource) *ConfigForResource { return &ConfigForResource{ Config: *config, GroupResource: resource, } } func NewDefaultConfig(prefix string, codec runtime.Codec) *Config { return &Config{ Prefix: prefix, Codec: codec, CompactionInterval: DefaultCompactInterval, DBMetricPollInterval: DefaultDBMetricPollInterval, EventsHistoryWindow: DefaultEventsHistoryWindow, HealthcheckTimeout: DefaultHealthcheckTimeout, ReadycheckTimeout: DefaultReadinessTimeout, LeaseManagerConfig: etcd3.NewDefaultLeaseManagerConfig(), Transport: TransportConfig{TracerProvider: noopoteltrace.NewTracerProvider()}, } }