Documentation ¶
Index ¶
- Constants
- Variables
- func Diff(fromConfig *Config, toConfig *Config) (string, error)
- func GetExtraValues(options *ExtraValuesOptions) (string, error)
- func SplitImage(image string) (string, string, string)
- func UnmarshalYAMLStrict(data []byte, i any) error
- func ValidateChanges(oldCfg, newCfg *Config) error
- func ValidateStoreAndDistroChanges(currentStoreType, previousStoreType StoreType, ...) error
- type APIService
- type APIServiceService
- type AutoSleepExclusion
- type AutoWakeup
- type BackingStore
- type CentralAdmission
- type CertManager
- type CertManagerSync
- type CertManagerSyncFromHost
- type CertManagerSyncToHost
- type ClusterIssuersSyncConfig
- type ClusterStoresSyncConfig
- type Config
- func (c *Config) BackingStoreType() StoreType
- func (c *Config) Distro() string
- func (c *Config) EmbeddedDatabase() bool
- func (c *Config) GetPlatformConfig() (*PlatformConfig, error)
- func (c *Config) IsConfiguredForSleepMode() bool
- func (c *Config) IsProFeatureEnabled() bool
- func (c *Config) SetPlatformConfig(platformConfig *PlatformConfig) error
- func (c *Config) UnmarshalYAMLStrict(data []byte) error
- type ControlPlane
- type ControlPlaneAdvanced
- type ControlPlaneGlobalMetadata
- type ControlPlaneHeadlessService
- type ControlPlaneHighAvailability
- type ControlPlaneIngress
- type ControlPlanePersistence
- type ControlPlaneProbes
- type ControlPlaneProxy
- type ControlPlaneScheduling
- type ControlPlaneSecurity
- type ControlPlaneService
- type ControlPlaneServiceAccount
- type ControlPlaneStatefulSet
- type ControlPlaneWorkloadServiceAccount
- type CoreDNS
- type CoreDNSDeployment
- type CoreDNSService
- type DNSPolicy
- type Database
- type DatabaseKine
- type DenyRule
- type Distro
- type DistroCommon
- type DistroContainer
- type DistroContainerEnabled
- type DistroK0s
- type DistroK3s
- type DistroK8s
- type Duration
- type EnableAutoSwitch
- type EnableAutoSwitchWithPatches
- type EnableSwitch
- type EnableSwitchWithPatches
- type Etcd
- type EtcdDeploy
- type EtcdDeployHeadlessService
- type EtcdDeployService
- type EtcdDeployStatefulSet
- type EtcdEmbedded
- type Experimental
- type ExperimentalDeploy
- type ExperimentalDeployHelm
- type ExperimentalDeployHelmChart
- type ExperimentalDeployHelmRelease
- type ExperimentalDeployHost
- type ExperimentalDeployVCluster
- type ExperimentalGenericSync
- type ExperimentalGenericSyncExtraRules
- type ExperimentalIsolatedControlPlane
- type ExperimentalMultiNamespaceMode
- type ExperimentalSyncSettings
- type Export
- type ExportKubeConfig
- type ExportKubeConfigSecretReference
- type ExportKubeConfigServiceAccount
- type ExternalConfig
- type ExternalDatabaseKine
- type ExternalEtcdHighAvailability
- type ExternalEtcdPersistence
- type ExternalEtcdPersistenceVolumeClaim
- type ExternalSecrets
- type ExternalSecretsSync
- type ExtraValuesOptions
- type Hook
- type Hooks
- type HostPathMapper
- type IPBlock
- type Image
- type ImagePullSecretName
- type Import
- type Integrations
- type KubeVirt
- type KubeVirtSync
- type KubernetesVersion
- type LabelSelector
- type LabelsAndAnnotations
- type LimitRange
- type MetricsServer
- type MutatingWebhook
- type MutatingWebhookConfiguration
- type NetworkPolicy
- type NetworkProxyKubelets
- type Networking
- type NetworkingAdvanced
- type ObjectMeta
- type OutgoingConnections
- type Patch
- type PatchCondition
- type PatchSync
- type PatchType
- type PlatformAPIKey
- type PlatformConfig
- type Plugin
- type Plugins
- type PluginsExtraRules
- type PluginsRBAC
- type PodDNSConfig
- type PodDNSConfigOption
- type Policies
- type RBAC
- type RBACClusterRole
- type RBACPolicyRule
- type RBACRole
- type ReplicateServices
- type ResolveDNS
- type ResolveDNSTarget
- type ResourceQuota
- type Resources
- type RuleWithVerbs
- type Scope
- type Selector
- type ServiceMapping
- type ServiceMonitor
- type SleepMode
- type SleepModeAutoSleep
- type StatefulSetImage
- type StoreType
- type StrBool
- type Sync
- type SyncAllResource
- type SyncBase
- type SyncFromHost
- type SyncFromHostCustomResource
- type SyncNodeSelector
- type SyncNodes
- type SyncPods
- type SyncRewriteHosts
- type SyncRewriteHostsInitContainer
- type SyncToHost
- type SyncToHostCustomResource
- type Telemetry
- type TranslatePatch
- type TranslatePatchLabels
- type TranslatePatchReference
- type TypeInformation
- type ValidatingWebhook
- type ValidatingWebhookClientConfig
- type ValidatingWebhookConfiguration
- type ValidatingWebhookServiceReference
- type VirtualClusterKubeConfig
- type VolumeClaim
- type VolumeMount
Constants ¶
const ( K3SDistro = "k3s" K8SDistro = "k8s" K0SDistro = "k0s" Unknown = "unknown" )
Variables ¶
var ErrInvalidConfig = errors.New("invalid config")
var ErrUnsupportedType = errors.New("unsupported type")
ErrUnsupportedType is returned if the type is not implemented
var K0SVersionMap = map[string]string{
"1.31": "k0sproject/k0s:v1.30.2-k0s.0",
"1.30": "k0sproject/k0s:v1.30.2-k0s.0",
"1.29": "k0sproject/k0s:v1.29.6-k0s.0",
"1.28": "k0sproject/k0s:v1.28.11-k0s.0",
"1.27": "k0sproject/k0s:v1.27.16-k0s.0",
}
K0SVersionMap holds the supported k0s versions
var K3SVersionMap = map[string]string{
"1.31": "rancher/k3s:v1.31.1-k3s1",
"1.30": "rancher/k3s:v1.30.2-k3s1",
"1.29": "rancher/k3s:v1.29.6-k3s1",
"1.28": "rancher/k3s:v1.28.11-k3s1",
"1.27": "rancher/k3s:v1.27.16-k3s1",
}
K3SVersionMap holds the supported k3s versions
var K8SAPIVersionMap = map[string]string{
"1.31": "registry.k8s.io/kube-apiserver:v1.31.1",
"1.30": "registry.k8s.io/kube-apiserver:v1.30.2",
"1.29": "registry.k8s.io/kube-apiserver:v1.29.6",
"1.28": "registry.k8s.io/kube-apiserver:v1.28.11",
"1.27": "registry.k8s.io/kube-apiserver:v1.27.16",
}
K8SAPIVersionMap holds the supported k8s api servers
var K8SControllerVersionMap = map[string]string{
"1.31": "registry.k8s.io/kube-controller-manager:v1.31.1",
"1.30": "registry.k8s.io/kube-controller-manager:v1.30.2",
"1.29": "registry.k8s.io/kube-controller-manager:v1.29.6",
"1.28": "registry.k8s.io/kube-controller-manager:v1.28.11",
"1.27": "registry.k8s.io/kube-controller-manager:v1.27.16",
}
K8SControllerVersionMap holds the supported k8s controller managers
var K8SEtcdVersionMap = map[string]string{
"1.31": "registry.k8s.io/etcd:3.5.15-0",
"1.30": "registry.k8s.io/etcd:3.5.13-0",
"1.29": "registry.k8s.io/etcd:3.5.10-0",
"1.28": "registry.k8s.io/etcd:3.5.9-0",
"1.27": "registry.k8s.io/etcd:3.5.7-0",
}
K8SEtcdVersionMap holds the supported etcd
var K8SSchedulerVersionMap = map[string]string{
"1.31": "registry.k8s.io/kube-scheduler:v1.31.1",
"1.30": "registry.k8s.io/kube-scheduler:v1.30.2",
"1.29": "registry.k8s.io/kube-scheduler:v1.29.6",
"1.28": "registry.k8s.io/kube-scheduler:v1.28.11",
"1.27": "registry.k8s.io/kube-scheduler:v1.27.16",
}
K8SSchedulerVersionMap holds the supported k8s schedulers
var Values string
Functions ¶
func GetExtraValues ¶
func GetExtraValues(options *ExtraValuesOptions) (string, error)
func UnmarshalYAMLStrict ¶
func ValidateChanges ¶
ValidateChanges checks for disallowed config changes. Currently only certain backingstore changes are allowed but no distro change.
func ValidateStoreAndDistroChanges ¶
func ValidateStoreAndDistroChanges(currentStoreType, previousStoreType StoreType, currentDistro, previousDistro string) error
ValidateStoreAndDistroChanges checks whether migrating from one store to the other is allowed.
Types ¶
type APIService ¶
type APIService struct { // Service is a reference to the service for the API server. Service APIServiceService `json:"service,omitempty"` }
APIService holds configuration related to the api server
type APIServiceService ¶
type APIServiceService struct { // Name is the name of the host service of the apiservice. Name string `json:"name,omitempty"` // Namespace is the name of the host service of the apiservice. Namespace string `json:"namespace,omitempty"` // Port is the target port on the host service to connect to. Port int `json:"port,omitempty"` }
APIServiceService holds the service name and namespace of the host apiservice.
type AutoSleepExclusion ¶
type AutoSleepExclusion struct {
Selector LabelSelector `json:"selector,omitempty"`
}
AutoSleepExclusion holds conifiguration for excluding workloads from sleeping by label(s)
type AutoWakeup ¶
type AutoWakeup struct {
Schedule string `json:"schedule,omitempty"`
}
AutoWakeup holds the cron schedule to wake workloads automatically
type BackingStore ¶
type BackingStore struct { // Etcd defines that etcd should be used as the backend for the virtual cluster Etcd Etcd `json:"etcd,omitempty"` // Database defines that a database backend should be used as the backend for the virtual cluster. This uses a project called kine under the hood which is a shim for bridging Kubernetes and relational databases. Database Database `json:"database,omitempty"` }
type CentralAdmission ¶
type CentralAdmission struct { // ValidatingWebhooks are validating webhooks that should be enforced in the virtual cluster ValidatingWebhooks []ValidatingWebhookConfiguration `json:"validatingWebhooks,omitempty"` // MutatingWebhooks are mutating webhooks that should be enforced in the virtual cluster MutatingWebhooks []MutatingWebhookConfiguration `json:"mutatingWebhooks,omitempty"` }
type CertManager ¶
type CertManager struct { EnableSwitch // Sync contains advanced configuration for syncing cert-manager resources. Sync CertManagerSync `json:"sync,omitempty"` }
CertManager reuses a host cert-manager and makes its CRDs from it available inside the vCluster
type CertManagerSync ¶
type CertManagerSync struct { ToHost CertManagerSyncToHost `json:"toHost,omitempty"` FromHost CertManagerSyncFromHost `json:"fromHost,omitempty"` }
type CertManagerSyncFromHost ¶
type CertManagerSyncFromHost struct { // ClusterIssuers defines if (and which) cluster issuers should get synced from the host cluster to the virtual cluster. ClusterIssuers ClusterIssuersSyncConfig `json:"clusterIssuers,omitempty"` }
type CertManagerSyncToHost ¶
type CertManagerSyncToHost struct { // Certificates defines if certificates should get synced from the virtual cluster to the host cluster. Certificates EnableSwitch `json:"certificates,omitempty"` // Issuers defines if issuers should get synced from the virtual cluster to the host cluster. Issuers EnableSwitch `json:"issuers,omitempty"` }
type ClusterIssuersSyncConfig ¶
type ClusterIssuersSyncConfig struct { EnableSwitch // Selector defines what cluster issuers should be imported. Selector LabelSelector `json:"selector,omitempty"` }
type ClusterStoresSyncConfig ¶ added in v0.21.0
type ClusterStoresSyncConfig struct { EnableSwitch // Selector defines what cluster stores should be synced Selector LabelSelector `json:"selector,omitempty"` }
type Config ¶
type Config struct { // Global values shared across all (sub)charts Global interface{} `json:"global,omitempty"` // ExportKubeConfig describes how vCluster should export the vCluster kubeConfig file. ExportKubeConfig ExportKubeConfig `json:"exportKubeConfig,omitempty"` // Sync describes how to sync resources from the virtual cluster to host cluster and back. Sync Sync `json:"sync,omitempty"` // Integrations holds config for vCluster integrations with other operators or tools running on the host cluster Integrations Integrations `json:"integrations,omitempty"` // Networking options related to the virtual cluster. Networking Networking `json:"networking,omitempty"` // Policies to enforce for the virtual cluster deployment as well as within the virtual cluster. Policies Policies `json:"policies,omitempty"` // Configure vCluster's control plane components and deployment. ControlPlane ControlPlane `json:"controlPlane,omitempty"` // RBAC options for the virtual cluster. RBAC RBAC `json:"rbac,omitempty"` // Define which vCluster plugins to load. Plugins map[string]Plugins `json:"plugins,omitempty"` // Experimental features for vCluster. Configuration here might change, so be careful with this. Experimental Experimental `json:"experimental,omitempty"` // External holds configuration for tools that are external to the vCluster. External map[string]ExternalConfig `json:"external,omitempty"` // Configuration related to telemetry gathered about vCluster usage. Telemetry Telemetry `json:"telemetry,omitempty"` // ServiceCIDR holds the service cidr for the virtual cluster. Do not use this option anymore. ServiceCIDR string `json:"serviceCIDR,omitempty"` // Specifies whether to use vCluster Pro. This is automatically inferred in newer versions. Do not use that option anymore. Pro bool `json:"pro,omitempty"` // Plugin specifies which vCluster plugins to enable. Use "plugins" instead. Do not use this option anymore. Plugin map[string]Plugin `json:"plugin,omitempty"` // SleepMode holds the native sleep mode configuration for Pro clusters SleepMode *SleepMode `json:"sleepMode,omitempty"` }
Config is the vCluster config. This struct describes valid Helm values for vCluster as well as configuration used by the vCluster binary itself.
func NewDefaultConfig ¶
NewDefaultConfig creates a new config based on the values.yaml, including all default values.
func (*Config) BackingStoreType ¶
BackingStoreType returns the backing store type of the vCluster. If no backing store is enabled, it returns StoreTypeUnknown.
func (*Config) EmbeddedDatabase ¶
func (*Config) GetPlatformConfig ¶
func (c *Config) GetPlatformConfig() (*PlatformConfig, error)
func (*Config) IsConfiguredForSleepMode ¶
func (*Config) IsProFeatureEnabled ¶
func (*Config) SetPlatformConfig ¶
func (c *Config) SetPlatformConfig(platformConfig *PlatformConfig) error
func (*Config) UnmarshalYAMLStrict ¶
type ControlPlane ¶
type ControlPlane struct { // Distro holds virtual cluster related distro options. A distro cannot be changed after vCluster is deployed. Distro Distro `json:"distro,omitempty"` // BackingStore defines which backing store to use for virtual cluster. If not defined will use embedded database as a default backing store. BackingStore BackingStore `json:"backingStore,omitempty"` // CoreDNS defines everything related to the coredns that is deployed and used within the vCluster. CoreDNS CoreDNS `json:"coredns,omitempty"` // Proxy defines options for the virtual cluster control plane proxy that is used to do authentication and intercept requests. Proxy ControlPlaneProxy `json:"proxy,omitempty"` // HostPathMapper defines if vCluster should rewrite host paths. HostPathMapper HostPathMapper `json:"hostPathMapper,omitempty" product:"pro"` // Ingress defines options for vCluster ingress deployed by Helm. Ingress ControlPlaneIngress `json:"ingress,omitempty"` // Service defines options for vCluster service deployed by Helm. Service ControlPlaneService `json:"service,omitempty"` // StatefulSet defines options for vCluster statefulSet deployed by Helm. StatefulSet ControlPlaneStatefulSet `json:"statefulSet,omitempty"` // ServiceMonitor can be used to automatically create a service monitor for vCluster deployment itself. ServiceMonitor ServiceMonitor `json:"serviceMonitor,omitempty"` // Advanced holds additional configuration for the vCluster control plane. Advanced ControlPlaneAdvanced `json:"advanced,omitempty"` }
func (ControlPlane) JSONSchemaExtend ¶
func (c ControlPlane) JSONSchemaExtend(base *jsonschema.Schema)
type ControlPlaneAdvanced ¶
type ControlPlaneAdvanced struct { // DefaultImageRegistry will be used as a prefix for all internal images deployed by vCluster or Helm. This makes it easy to // upload all required vCluster images to a single private repository and set this value. Workload images are not affected by this. DefaultImageRegistry string `json:"defaultImageRegistry,omitempty"` // VirtualScheduler defines if a scheduler should be used within the virtual cluster or the scheduling decision for workloads will be made by the host cluster. VirtualScheduler EnableSwitch `json:"virtualScheduler,omitempty"` // ServiceAccount specifies options for the vCluster control plane service account. ServiceAccount ControlPlaneServiceAccount `json:"serviceAccount,omitempty"` // WorkloadServiceAccount specifies options for the service account that will be used for the workloads that run within the virtual cluster. WorkloadServiceAccount ControlPlaneWorkloadServiceAccount `json:"workloadServiceAccount,omitempty"` // HeadlessService specifies options for the headless service used for the vCluster StatefulSet. HeadlessService ControlPlaneHeadlessService `json:"headlessService,omitempty"` // GlobalMetadata is metadata that will be added to all resources deployed by Helm. GlobalMetadata ControlPlaneGlobalMetadata `json:"globalMetadata,omitempty"` }
type ControlPlaneHighAvailability ¶
type ControlPlaneHighAvailability struct { // Replicas is the amount of replicas to use for the statefulSet. Replicas int32 `json:"replicas,omitempty"` // LeaseDuration is the time to lease for the leader. LeaseDuration int `json:"leaseDuration,omitempty"` // RenewDeadline is the deadline to renew a lease for the leader. RenewDeadline int `json:"renewDeadline,omitempty"` // RetryPeriod is the time until a replica will retry to get a lease. RetryPeriod int `json:"retryPeriod,omitempty"` }
type ControlPlaneIngress ¶
type ControlPlaneIngress struct { // Enabled defines if the control plane ingress should be enabled Enabled bool `json:"enabled,omitempty"` // Host is the host where vCluster will be reachable Host string `json:"host,omitempty"` // PathType is the path type of the ingress PathType string `json:"pathType,omitempty"` // Spec allows you to configure extra ingress options. Spec map[string]interface{} `json:"spec,omitempty"` LabelsAndAnnotations `json:",inline"` }
type ControlPlanePersistence ¶
type ControlPlanePersistence struct { // VolumeClaim can be used to configure the persistent volume claim. VolumeClaim VolumeClaim `json:"volumeClaim,omitempty"` // VolumeClaimTemplates defines the volumeClaimTemplates for the statefulSet VolumeClaimTemplates []map[string]interface{} `json:"volumeClaimTemplates,omitempty"` // Allows you to override the dataVolume. Only works correctly if volumeClaim.enabled=false. DataVolume []map[string]interface{} `json:"dataVolume,omitempty"` // BinariesVolume defines a binaries volume that is used to retrieve // distro specific executables to be run by the syncer controller. // This volume doesn't need to be persistent. BinariesVolume []map[string]interface{} `json:"binariesVolume,omitempty"` // AddVolumes defines extra volumes for the pod AddVolumes []map[string]interface{} `json:"addVolumes,omitempty"` // AddVolumeMounts defines extra volume mounts for the container AddVolumeMounts []VolumeMount `json:"addVolumeMounts,omitempty"` }
type ControlPlaneProbes ¶
type ControlPlaneProbes struct { // LivenessProbe specifies if the liveness probe for the container should be enabled LivenessProbe EnableSwitch `json:"livenessProbe,omitempty"` // ReadinessProbe specifies if the readiness probe for the container should be enabled ReadinessProbe EnableSwitch `json:"readinessProbe,omitempty"` // StartupProbe specifies if the startup probe for the container should be enabled StartupProbe EnableSwitch `json:"startupProbe,omitempty"` }
type ControlPlaneProxy ¶
type ControlPlaneProxy struct { // BindAddress under which vCluster will expose the proxy. BindAddress string `json:"bindAddress,omitempty"` // Port under which vCluster will expose the proxy. Changing port is currently not supported. Port int `json:"port,omitempty"` // ExtraSANs are extra hostnames to sign the vCluster proxy certificate for. ExtraSANs []string `json:"extraSANs,omitempty"` }
type ControlPlaneScheduling ¶
type ControlPlaneScheduling struct { // NodeSelector is the node selector to apply to the pod. NodeSelector map[string]interface{} `json:"nodeSelector,omitempty"` // Affinity is the affinity to apply to the pod. Affinity map[string]interface{} `json:"affinity,omitempty"` // Tolerations are the tolerations to apply to the pod. Tolerations []map[string]interface{} `json:"tolerations,omitempty"` // PriorityClassName is the priority class name for the the pod. PriorityClassName string `json:"priorityClassName,omitempty"` // PodManagementPolicy is the statefulSet pod management policy. PodManagementPolicy string `json:"podManagementPolicy,omitempty"` // TopologySpreadConstraints are the topology spread constraints for the pod. TopologySpreadConstraints []interface{} `json:"topologySpreadConstraints,omitempty"` }
type ControlPlaneSecurity ¶
type ControlPlaneSecurity struct { // PodSecurityContext specifies security context options on the pod level. PodSecurityContext map[string]interface{} `json:"podSecurityContext,omitempty"` // ContainerSecurityContext specifies security context options on the container level. ContainerSecurityContext map[string]interface{} `json:"containerSecurityContext,omitempty"` }
type ControlPlaneService ¶
type ControlPlaneService struct { // Enabled defines if the control plane service should be enabled Enabled bool `json:"enabled,omitempty"` // Spec allows you to configure extra service options. Spec map[string]interface{} `json:"spec,omitempty"` // KubeletNodePort is the node port where the fake kubelet is exposed. Defaults to 0. KubeletNodePort int `json:"kubeletNodePort,omitempty"` // HTTPSNodePort is the node port where https is exposed. Defaults to 0. HTTPSNodePort int `json:"httpsNodePort,omitempty"` LabelsAndAnnotations `json:",inline"` }
type ControlPlaneServiceAccount ¶
type ControlPlaneServiceAccount struct { // Enabled specifies if the service account should get deployed. Enabled bool `json:"enabled,omitempty"` // Name specifies what name to use for the service account. Name string `json:"name,omitempty"` // ImagePullSecrets defines extra image pull secrets for the service account. ImagePullSecrets []ImagePullSecretName `json:"imagePullSecrets,omitempty"` // Annotations are extra annotations for this resource. Annotations map[string]string `json:"annotations,omitempty"` // Labels are extra labels for this resource. Labels map[string]string `json:"labels,omitempty"` }
type ControlPlaneStatefulSet ¶
type ControlPlaneStatefulSet struct { // HighAvailability holds options related to high availability. HighAvailability ControlPlaneHighAvailability `json:"highAvailability,omitempty"` // Resources are the resource requests and limits for the statefulSet container. Resources Resources `json:"resources,omitempty"` // Scheduling holds options related to scheduling. Scheduling ControlPlaneScheduling `json:"scheduling,omitempty"` // Security defines pod or container security context. Security ControlPlaneSecurity `json:"security,omitempty"` // Probes enables or disables the main container probes. Probes ControlPlaneProbes `json:"probes,omitempty"` // Persistence defines options around persistence for the statefulSet. Persistence ControlPlanePersistence `json:"persistence,omitempty"` // EnableServiceLinks for the StatefulSet pod EnableServiceLinks *bool `json:"enableServiceLinks,omitempty"` LabelsAndAnnotations `json:",inline"` // Additional labels or annotations for the statefulSet pods. Pods LabelsAndAnnotations `json:"pods,omitempty"` // Image is the image for the controlPlane statefulSet container Image StatefulSetImage `json:"image,omitempty"` // ImagePullPolicy is the policy how to pull the image. ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // WorkingDir specifies in what folder the main process should get started. WorkingDir string `json:"workingDir,omitempty"` // Command allows you to override the main command. Command []string `json:"command,omitempty"` // Args allows you to override the main arguments. Args []string `json:"args,omitempty"` // Env are additional environment variables for the statefulSet container. Env []map[string]interface{} `json:"env,omitempty"` // Set DNS policy for the pod. DNSPolicy DNSPolicy `json:"dnsPolicy,omitempty"` // Specifies the DNS parameters of a pod. DNSConfig *PodDNSConfig `json:"dnsConfig,omitempty"` }
type ControlPlaneWorkloadServiceAccount ¶
type ControlPlaneWorkloadServiceAccount struct { // Enabled specifies if the service account for the workloads should get deployed. Enabled bool `json:"enabled,omitempty"` // Name specifies what name to use for the service account for the virtual cluster workloads. Name string `json:"name,omitempty"` // ImagePullSecrets defines extra image pull secrets for the workload service account. ImagePullSecrets []ImagePullSecretName `json:"imagePullSecrets,omitempty"` // Annotations are extra annotations for this resource. Annotations map[string]string `json:"annotations,omitempty"` // Labels are extra labels for this resource. Labels map[string]string `json:"labels,omitempty"` }
type CoreDNS ¶
type CoreDNS struct { // Enabled defines if coredns is enabled Enabled bool `json:"enabled,omitempty"` // Embedded defines if vCluster will start the embedded coredns service within the control-plane and not as a separate deployment. This is a PRO feature. Embedded bool `json:"embedded,omitempty" product:"pro"` // Service holds extra options for the coredns service deployed within the virtual cluster Service CoreDNSService `json:"service,omitempty"` // Deployment holds extra options for the coredns deployment deployed within the virtual cluster Deployment CoreDNSDeployment `json:"deployment,omitempty"` // OverwriteConfig can be used to overwrite the coredns config OverwriteConfig string `json:"overwriteConfig,omitempty"` // OverwriteManifests can be used to overwrite the coredns manifests used to deploy coredns OverwriteManifests string `json:"overwriteManifests,omitempty"` // PriorityClassName specifies the priority class name for the CoreDNS pods. PriorityClassName string `json:"priorityClassName,omitempty"` }
func (CoreDNS) JSONSchemaExtend ¶
func (c CoreDNS) JSONSchemaExtend(base *jsonschema.Schema)
type CoreDNSDeployment ¶
type CoreDNSDeployment struct { // Image is the coredns image to use Image string `json:"image,omitempty"` // Replicas is the amount of coredns pods to run. Replicas int `json:"replicas,omitempty"` // NodeSelector is the node selector to use for coredns. NodeSelector map[string]string `json:"nodeSelector,omitempty"` // Affinity is the affinity to apply to the pod. Affinity map[string]interface{} `json:"affinity,omitempty"` // Tolerations are the tolerations to apply to the pod. Tolerations []map[string]interface{} `json:"tolerations,omitempty"` // Resources are the desired resources for coredns. Resources Resources `json:"resources,omitempty"` // Pods is additional metadata for the coredns pods. Pods LabelsAndAnnotations `json:"pods,omitempty"` LabelsAndAnnotations `json:",inline"` // TopologySpreadConstraints are the topology spread constraints for the CoreDNS pod. TopologySpreadConstraints []interface{} `json:"topologySpreadConstraints,omitempty"` }
type CoreDNSService ¶
type CoreDNSService struct { // Spec holds extra options for the coredns service Spec map[string]interface{} `json:"spec,omitempty"` LabelsAndAnnotations `json:",inline"` }
type DNSPolicy ¶ added in v0.21.0
type DNSPolicy string
DNSPolicy defines how a pod's DNS will be configured. +enum
const ( // DNSClusterFirstWithHostNet indicates that the pod should use cluster DNS // first, if it is available, then fall back on the default // (as determined by kubelet) DNS settings. DNSClusterFirstWithHostNet DNSPolicy = "ClusterFirstWithHostNet" // DNSClusterFirst indicates that the pod should use cluster DNS // first unless hostNetwork is true, if it is available, then // fall back on the default (as determined by kubelet) DNS settings. DNSClusterFirst DNSPolicy = "ClusterFirst" // DNSDefault indicates that the pod should use the default (as // determined by kubelet) DNS settings. DNSDefault DNSPolicy = "Default" // DNSNone indicates that the pod should use empty DNS settings. DNS // parameters such as nameservers and search paths should be defined via // DNSConfig. DNSNone DNSPolicy = "None" )
type Database ¶
type Database struct { // Embedded defines that an embedded database (sqlite) should be used as the backend for the virtual cluster Embedded DatabaseKine `json:"embedded,omitempty"` // External defines that an external database should be used as the backend for the virtual cluster External ExternalDatabaseKine `json:"external,omitempty"` }
type DatabaseKine ¶
type DatabaseKine struct { // Enabled defines if the database should be used. Enabled bool `json:"enabled,omitempty"` // DataSource is the kine dataSource to use for the database. This depends on the database format. // This is optional for the embedded database. Examples: // * mysql: mysql://username:password@tcp(hostname:3306)/k3s // * postgres: postgres://username:password@hostname:5432/k3s DataSource string `json:"dataSource,omitempty"` // KeyFile is the key file to use for the database. This is optional. KeyFile string `json:"keyFile,omitempty"` // CertFile is the cert file to use for the database. This is optional. CertFile string `json:"certFile,omitempty"` // CaFile is the ca file to use for the database. This is optional. CaFile string `json:"caFile,omitempty"` }
type DenyRule ¶
type DenyRule struct { // The name of the check. Name string `json:"name,omitempty"` // Namespace describe a list of namespaces that will be affected by the check. // An empty list means that all namespaces will be affected. // In case of ClusterScoped rules, only the Namespace resource is affected. Namespaces []string `json:"namespaces,omitempty"` // Rules describes on which verbs and on what resources/subresources the webhook is enforced. // The webhook is enforced if it matches any Rule. // The version of the request must match the rule version exactly. Equivalent matching is not supported. Rules []RuleWithVerbs `json:"rules,omitempty"` // ExcludedUsers describe a list of users for which the checks will be skipped. // Impersonation attempts on these users will still be subjected to the checks. ExcludedUsers []string `json:"excludedUsers,omitempty"` }
type DistroCommon ¶
type DistroCommon struct { // Env are extra environment variables to use for the main container and NOT the init container. Env []map[string]interface{} `json:"env,omitempty"` // Resources for the distro init container Resources map[string]interface{} `json:"resources,omitempty"` // Security options can be used for the distro init container SecurityContext map[string]interface{} `json:"securityContext,omitempty"` }
type DistroContainer ¶
type DistroContainer struct { // Image is the distro image Image Image `json:"image,omitempty"` // ImagePullPolicy is the pull policy for the distro image ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // Command is the command to start the distro binary. This will override the existing command. Command []string `json:"command,omitempty"` // ExtraArgs are additional arguments to pass to the distro binary. ExtraArgs []string `json:"extraArgs,omitempty"` }
type DistroContainerEnabled ¶
type DistroContainerEnabled struct { // Enabled signals this container should be enabled. Enabled bool `json:"enabled,omitempty"` // Image is the distro image Image Image `json:"image,omitempty"` // ImagePullPolicy is the pull policy for the distro image ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // Command is the command to start the distro binary. This will override the existing command. Command []string `json:"command,omitempty"` // ExtraArgs are additional arguments to pass to the distro binary. ExtraArgs []string `json:"extraArgs,omitempty"` }
type DistroK0s ¶
type DistroK0s struct { // Enabled specifies if the k0s distro should be enabled. Only one distro can be enabled at the same time. Enabled bool `json:"enabled,omitempty"` // Config allows you to override the k0s config passed to the k0s binary. Config string `json:"config,omitempty"` DistroCommon `json:",inline"` DistroContainer `json:",inline"` }
type DistroK3s ¶
type DistroK3s struct { // Enabled specifies if the K3s distro should be enabled. Only one distro can be enabled at the same time. Enabled bool `json:"enabled,omitempty"` // Token is the K3s token to use. If empty, vCluster will choose one. Token string `json:"token,omitempty"` DistroCommon `json:",inline"` DistroContainer `json:",inline"` }
type DistroK8s ¶
type DistroK8s struct { // Enabled specifies if the K8s distro should be enabled. Only one distro can be enabled at the same time. Enabled bool `json:"enabled,omitempty"` // Version specifies k8s components (scheduler, kube-controller-manager & apiserver) version. // It is a shortcut for controlPlane.distro.k8s.apiServer.image.tag, // controlPlane.distro.k8s.controllerManager.image.tag and // controlPlane.distro.k8s.scheduler.image.tag // If e.g. controlPlane.distro.k8s.version is set to v1.30.1 and // controlPlane.distro.k8s.scheduler.image.tag //(or controlPlane.distro.k8s.controllerManager.image.tag or controlPlane.distro.k8s.apiServer.image.tag) // is set to v1.31.0, // value from controlPlane.distro.k8s.<controlPlane-component>.image.tag will be used // (where <controlPlane-component is apiServer, controllerManager and scheduler). Version string `json:"version,omitempty"` // APIServer holds configuration specific to starting the api server. APIServer DistroContainerEnabled `json:"apiServer,omitempty"` // ControllerManager holds configuration specific to starting the controller manager. ControllerManager DistroContainerEnabled `json:"controllerManager,omitempty"` // Scheduler holds configuration specific to starting the scheduler. Enable this via controlPlane.advanced.virtualScheduler.enabled Scheduler DistroContainer `json:"scheduler,omitempty"` DistroCommon `json:",inline"` }
type Duration ¶
type Duration string
Duration allows for automatic Marshalling from strings like "1m" to a time.Duration
func (Duration) MarshalJSON ¶
MarshalJSON implements Marshaler
func (*Duration) UnmarshalJSON ¶
UnmarshalJSON implements Marshaler
type EnableAutoSwitch ¶
type EnableAutoSwitch struct { // Enabled defines if this option should be enabled. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` }
type EnableAutoSwitchWithPatches ¶ added in v0.21.0
type EnableAutoSwitchWithPatches struct { // Enabled defines if this option should be enabled. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type EnableSwitch ¶
type EnableSwitch struct { // Enabled defines if this option should be enabled. Enabled bool `json:"enabled,omitempty"` }
type EnableSwitchWithPatches ¶ added in v0.21.0
type EnableSwitchWithPatches struct { // Enabled defines if this option should be enabled. Enabled bool `json:"enabled,omitempty"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type Etcd ¶
type Etcd struct { // Embedded defines to use embedded etcd as a storage backend for the virtual cluster Embedded EtcdEmbedded `json:"embedded,omitempty" product:"pro"` // Deploy defines to use an external etcd that is deployed by the helm chart Deploy EtcdDeploy `json:"deploy,omitempty"` }
func (Etcd) JSONSchemaExtend ¶
func (e Etcd) JSONSchemaExtend(base *jsonschema.Schema)
type EtcdDeploy ¶
type EtcdDeploy struct { // Enabled defines that an external etcd should be deployed. Enabled bool `json:"enabled,omitempty"` // StatefulSet holds options for the external etcd statefulSet. StatefulSet EtcdDeployStatefulSet `json:"statefulSet,omitempty"` // Service holds options for the external etcd service. Service EtcdDeployService `json:"service,omitempty"` // HeadlessService holds options for the external etcd headless service. HeadlessService EtcdDeployHeadlessService `json:"headlessService,omitempty"` }
type EtcdDeployService ¶
type EtcdDeployStatefulSet ¶
type EtcdDeployStatefulSet struct { // Enabled defines if the statefulSet should be deployed Enabled bool `json:"enabled,omitempty"` // EnableServiceLinks for the StatefulSet pod EnableServiceLinks *bool `json:"enableServiceLinks,omitempty"` // Image is the image to use for the external etcd statefulSet Image Image `json:"image,omitempty"` // ImagePullPolicy is the pull policy for the external etcd image ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // Env are extra environment variables Env []map[string]interface{} `json:"env,omitempty"` // ExtraArgs are appended to the etcd command. ExtraArgs []string `json:"extraArgs,omitempty"` // Resources the etcd can consume Resources Resources `json:"resources,omitempty"` // Pods defines extra metadata for the etcd pods. Pods LabelsAndAnnotations `json:"pods,omitempty"` // HighAvailability are high availability options HighAvailability ExternalEtcdHighAvailability `json:"highAvailability,omitempty"` // Scheduling options for the etcd pods. Scheduling ControlPlaneScheduling `json:"scheduling,omitempty"` // Security options for the etcd pods. Security ControlPlaneSecurity `json:"security,omitempty"` // Persistence options for the etcd pods. Persistence ExternalEtcdPersistence `json:"persistence,omitempty"` LabelsAndAnnotations `json:",inline"` }
type EtcdEmbedded ¶
type EtcdEmbedded struct { // Enabled defines if the embedded etcd should be used. Enabled bool `json:"enabled,omitempty" product:"pro"` // MigrateFromDeployedEtcd signals that vCluster should migrate from the deployed external etcd to embedded etcd. MigrateFromDeployedEtcd bool `json:"migrateFromDeployedEtcd,omitempty"` }
func (EtcdEmbedded) JSONSchemaExtend ¶
func (e EtcdEmbedded) JSONSchemaExtend(base *jsonschema.Schema)
type Experimental ¶
type Experimental struct { // Deploy allows you to configure manifests and Helm charts to deploy within the host or virtual cluster. Deploy ExperimentalDeploy `json:"deploy,omitempty"` // SyncSettings are advanced settings for the syncer controller. SyncSettings ExperimentalSyncSettings `json:"syncSettings,omitempty"` // GenericSync holds options to generically sync resources from virtual cluster to host. GenericSync ExperimentalGenericSync `json:"genericSync,omitempty"` // MultiNamespaceMode tells virtual cluster to sync to multiple namespaces instead of a single one. This will map each virtual cluster namespace to a single namespace in the host cluster. MultiNamespaceMode ExperimentalMultiNamespaceMode `json:"multiNamespaceMode,omitempty"` // IsolatedControlPlane is a feature to run the vCluster control plane in a different Kubernetes cluster than the workloads themselves. IsolatedControlPlane ExperimentalIsolatedControlPlane `json:"isolatedControlPlane,omitempty" product:"pro"` // VirtualClusterKubeConfig allows you to override distro specifics and specify where vCluster will find the required certificates and vCluster config. VirtualClusterKubeConfig VirtualClusterKubeConfig `json:"virtualClusterKubeConfig,omitempty"` // DenyProxyRequests denies certain requests in the vCluster proxy. DenyProxyRequests []DenyRule `json:"denyProxyRequests,omitempty" product:"pro"` }
func (Experimental) JSONSchemaExtend ¶
func (e Experimental) JSONSchemaExtend(base *jsonschema.Schema)
type ExperimentalDeploy ¶
type ExperimentalDeploy struct { // Host defines what manifests to deploy into the host cluster Host ExperimentalDeployHost `json:"host,omitempty"` // VCluster defines what manifests and charts to deploy into the vCluster VCluster ExperimentalDeployVCluster `json:"vcluster,omitempty"` }
type ExperimentalDeployHelm ¶
type ExperimentalDeployHelm struct { // Chart defines what chart should get deployed. Chart ExperimentalDeployHelmChart `json:"chart,omitempty"` // Release defines what release should get deployed. Release ExperimentalDeployHelmRelease `json:"release,omitempty"` // Values defines what values should get used. Values string `json:"values,omitempty"` // Timeout defines the timeout for Helm Timeout string `json:"timeout,omitempty"` // Bundle allows to compress the Helm chart and specify this instead of an online chart Bundle string `json:"bundle,omitempty"` }
type ExperimentalDeployHost ¶
type ExperimentalDeployHost struct { // Manifests are raw Kubernetes manifests that should get applied within the host cluster. Manifests string `json:"manifests,omitempty"` // ManifestsTemplate is a Kubernetes manifest template that will be rendered with vCluster values before applying it within the host cluster. ManifestsTemplate string `json:"manifestsTemplate,omitempty"` }
type ExperimentalDeployVCluster ¶
type ExperimentalDeployVCluster struct { // Manifests are raw Kubernetes manifests that should get applied within the virtual cluster. Manifests string `json:"manifests,omitempty"` // ManifestsTemplate is a Kubernetes manifest template that will be rendered with vCluster values before applying it within the virtual cluster. ManifestsTemplate string `json:"manifestsTemplate,omitempty"` // Helm are Helm charts that should get deployed into the virtual cluster Helm []ExperimentalDeployHelm `json:"helm,omitempty"` }
type ExperimentalGenericSync ¶
type ExperimentalGenericSync struct { // Version is the config version Version string `json:"version,omitempty" yaml:"version,omitempty"` // Exports syncs a resource from the virtual cluster to the host Exports []*Export `json:"export,omitempty" yaml:"export,omitempty"` // Imports syncs a resource from the host cluster to virtual cluster Imports []*Import `json:"import,omitempty" yaml:"import,omitempty"` // Hooks are hooks that can be used to inject custom patches before syncing Hooks *Hooks `json:"hooks,omitempty" yaml:"hooks,omitempty"` ClusterRole ExperimentalGenericSyncExtraRules `json:"clusterRole,omitempty"` Role ExperimentalGenericSyncExtraRules `json:"role,omitempty"` }
type ExperimentalGenericSyncExtraRules ¶
type ExperimentalGenericSyncExtraRules struct {
ExtraRules []interface{} `json:"extraRules,omitempty"`
}
type ExperimentalIsolatedControlPlane ¶
type ExperimentalIsolatedControlPlane struct { // Enabled specifies if the isolated control plane feature should be enabled. Enabled bool `json:"enabled,omitempty" product:"pro"` // Headless states that Helm should deploy the vCluster in headless mode for the isolated control plane. Headless bool `json:"headless,omitempty"` // KubeConfig is the path where to find the remote workload cluster kubeconfig. KubeConfig string `json:"kubeConfig,omitempty"` // Namespace is the namespace where to sync the workloads into. Namespace string `json:"namespace,omitempty"` // Service is the vCluster service in the remote cluster. Service string `json:"service,omitempty"` }
type ExperimentalMultiNamespaceMode ¶
type ExperimentalMultiNamespaceMode struct { // Enabled specifies if multi namespace mode should get enabled Enabled bool `json:"enabled,omitempty"` // NamespaceLabels are extra labels that will be added by vCluster to each created namespace. NamespaceLabels map[string]string `json:"namespaceLabels,omitempty"` }
type ExperimentalSyncSettings ¶
type ExperimentalSyncSettings struct { // DisableSync will not sync any resources and disable most control plane functionality. DisableSync bool `json:"disableSync,omitempty" product:"pro"` // RewriteKubernetesService will rewrite the Kubernetes service to point to the vCluster service if disableSync is enabled RewriteKubernetesService bool `json:"rewriteKubernetesService,omitempty" product:"pro"` // TargetNamespace is the namespace where the workloads should get synced to. TargetNamespace string `json:"targetNamespace,omitempty"` // SetOwner specifies if vCluster should set an owner reference on the synced objects to the vCluster service. This allows for easy garbage collection. SetOwner bool `json:"setOwner,omitempty"` // HostMetricsBindAddress is the bind address for the local manager HostMetricsBindAddress string `json:"hostMetricsBindAddress,omitempty"` // VirtualMetricsBindAddress is the bind address for the virtual manager VirtualMetricsBindAddress string `json:"virtualMetricsBindAddress,omitempty"` }
func (ExperimentalSyncSettings) JSONSchemaExtend ¶
func (e ExperimentalSyncSettings) JSONSchemaExtend(base *jsonschema.Schema)
type ExportKubeConfig ¶
type ExportKubeConfig struct { // Context is the name of the context within the generated kubeconfig to use. Context string `json:"context,omitempty"` // Override the default https://localhost:8443 and specify a custom hostname for the generated kubeconfig. Server string `json:"server,omitempty"` // If tls should get skipped for the server Insecure bool `json:"insecure,omitempty"` // ServiceAccount can be used to generate a service account token instead of the default certificates. ServiceAccount ExportKubeConfigServiceAccount `json:"serviceAccount,omitempty"` // Declare in which host cluster secret vCluster should store the generated virtual cluster kubeconfig. // If this is not defined, vCluster will create it with `vc-NAME`. If you specify another name, // vCluster creates the config in this other secret. Secret ExportKubeConfigSecretReference `json:"secret,omitempty"` }
ExportKubeConfig describes how vCluster should export the vCluster kubeconfig.
type ExportKubeConfigSecretReference ¶
type ExportKubeConfigSecretReference struct { // Name is the name of the secret where the kubeconfig should get stored. Name string `json:"name,omitempty"` // Namespace where vCluster should store the kubeconfig secret. If this is not equal to the namespace // where you deployed vCluster, you need to make sure vCluster has access to this other namespace. Namespace string `json:"namespace,omitempty"` }
Declare in which host cluster secret vCluster should store the generated virtual cluster kubeconfig. If this is not defined, vCluster create it with `vc-NAME`. If you specify another name, vCluster creates the config in this other secret.
type ExportKubeConfigServiceAccount ¶ added in v0.21.0
type ExportKubeConfigServiceAccount struct { // Name of the service account to be used to generate a service account token instead of the default certificates. Name string `json:"name,omitempty"` // Namespace of the service account to be used to generate a service account token instead of the default certificates. // If omitted, will use the kube-system namespace. Namespace string `json:"namespace,omitempty"` // ClusterRole to assign to the service account. ClusterRole string `json:"clusterRole,omitempty"` }
type ExternalConfig ¶
type ExternalConfig map[string]interface{}
ExternalConfig holds external tool configuration
type ExternalDatabaseKine ¶ added in v0.21.0
type ExternalDatabaseKine struct { DatabaseKine // Connector specifies a secret located in a connected vCluster Platform that contains database server connection information // to be used by Platform to create a database and database user for the vCluster. // and non-privileged user. A kine endpoint should be created using the database and user on Platform registration. // This is optional. Connector string `json:"connector,omitempty"` }
type ExternalEtcdHighAvailability ¶
type ExternalEtcdHighAvailability struct { // Replicas are the amount of pods to use. Replicas int `json:"replicas,omitempty"` }
type ExternalEtcdPersistence ¶
type ExternalEtcdPersistence struct { // VolumeClaim can be used to configure the persistent volume claim. VolumeClaim ExternalEtcdPersistenceVolumeClaim `json:"volumeClaim,omitempty"` // VolumeClaimTemplates defines the volumeClaimTemplates for the statefulSet VolumeClaimTemplates []map[string]interface{} `json:"volumeClaimTemplates,omitempty"` // AddVolumes defines extra volumes for the pod AddVolumes []map[string]interface{} `json:"addVolumes,omitempty"` // AddVolumeMounts defines extra volume mounts for the container AddVolumeMounts []VolumeMount `json:"addVolumeMounts,omitempty"` }
type ExternalEtcdPersistenceVolumeClaim ¶
type ExternalEtcdPersistenceVolumeClaim struct { // Enabled enables deploying a persistent volume claim. Enabled bool `json:"enabled,omitempty"` // AccessModes are the persistent volume claim access modes. AccessModes []string `json:"accessModes,omitempty"` // RetentionPolicy is the persistent volume claim retention policy. RetentionPolicy string `json:"retentionPolicy,omitempty"` // Size is the persistent volume claim storage size. Size string `json:"size,omitempty"` // StorageClass is the persistent volume claim storage class. StorageClass string `json:"storageClass,omitempty"` }
type ExternalSecrets ¶ added in v0.21.0
type ExternalSecrets struct { // Enabled defines whether the external secret integration is enabled or not Enabled bool `json:"enabled,omitempty"` // Webhook defines whether the host webhooks are reused or not Webhook EnableSwitch `json:"webhook,omitempty"` // Sync defines the syncing behavior for the integration Sync ExternalSecretsSync `json:"sync,omitempty"` }
ExternalSecrets reuses a host external secret operator and makes certain CRDs from it available inside the vCluster
type ExternalSecretsSync ¶ added in v0.21.0
type ExternalSecretsSync struct { // ExternalSecrets defines whether to sync external secrets or not ExternalSecrets EnableSwitch `json:"externalSecrets,omitempty"` // Stores defines whether to sync stores or not Stores EnableSwitch `json:"stores,omitempty"` // ClusterStores defines whether to sync cluster stores or not ClusterStores ClusterStoresSyncConfig `json:"clusterStores,omitempty"` }
type ExtraValuesOptions ¶
type ExtraValuesOptions struct { Distro string Expose bool NodePort bool KubernetesVersion KubernetesVersion DisableTelemetry bool InstanceCreatorType string MachineID string PlatformInstanceID string PlatformUserID string }
ExtraValuesOptions holds the chart options
type Hook ¶
type Hook struct { TypeInformation // Verbs are the verbs that the hook should mutate Verbs []string `json:"verbs,omitempty" yaml:"verbs,omitempty"` // Patches are the patches to apply on the object to be synced Patches []*Patch `json:"patches,omitempty" yaml:"patches,omitempty"` }
type Hooks ¶
type Hooks struct { // HostToVirtual is a hook that is executed before syncing from the host to the virtual cluster HostToVirtual []*Hook `json:"hostToVirtual,omitempty" yaml:"hostToVirtual,omitempty"` // VirtualToHost is a hook that is executed before syncing from the virtual to the host cluster VirtualToHost []*Hook `json:"virtualToHost,omitempty" yaml:"virtualToHost,omitempty"` }
type HostPathMapper ¶
type IPBlock ¶
type IPBlock struct { // cidr is a string representing the IPBlock // Valid examples are "192.168.1.0/24" or "2001:db8::/64" CIDR string `json:"cidr,omitempty"` // except is a slice of CIDRs that should not be included within an IPBlock // Valid examples are "192.168.1.0/24" or "2001:db8::/64" // Except values will be rejected if they are outside the cidr range // +optional Except []string `json:"except,omitempty"` }
type Image ¶
type Image struct { // Registry is the registry of the container image, e.g. my-registry.com or ghcr.io. This setting can be globally // overridden via the controlPlane.advanced.defaultImageRegistry option. Empty means docker hub. Registry string `json:"registry,omitempty"` // Repository is the repository of the container image, e.g. my-repo/my-image Repository string `json:"repository,omitempty"` // Tag is the tag of the container image, e.g. latest Tag string `json:"tag,omitempty"` }
type ImagePullSecretName ¶
type ImagePullSecretName struct { // Name of the image pull secret to use. Name string `json:"name,omitempty"` }
type Integrations ¶
type Integrations struct { // MetricsServer reuses the metrics server from the host cluster within the vCluster. MetricsServer MetricsServer `json:"metricsServer,omitempty"` // KubeVirt reuses a host kubevirt and makes certain CRDs from it available inside the vCluster KubeVirt KubeVirt `json:"kubeVirt,omitempty"` // ExternalSecrets reuses a host external secret operator and makes certain CRDs from it available inside the vCluster ExternalSecrets ExternalSecrets `json:"externalSecrets,omitempty"` // CertManager reuses a host cert-manager and makes its CRDs from it available inside the vCluster. // - Certificates and Issuers will be synced from the virtual cluster to the host cluster. // - ClusterIssuers will be synced from the host cluster to the virtual cluster. CertManager CertManager `json:"certManager,omitempty"` }
Integrations holds config for vCluster integrations with other operators or tools running on the host cluster
type KubeVirt ¶ added in v0.21.0
type KubeVirt struct { // Enabled signals if the integration should be enabled Enabled bool `json:"enabled,omitempty"` // APIService holds information about where to find the virt-api service. Defaults to virt-api/kubevirt. APIService APIService `json:"apiService,omitempty"` // Webhook holds configuration for enabling the webhook within the vCluster Webhook EnableSwitch `json:"webhook,omitempty"` // Sync holds configuration on what resources to sync Sync KubeVirtSync `json:"sync,omitempty"` }
KubeVirt reuses a host kubevirt and makes certain CRDs from it available inside the vCluster
type KubeVirtSync ¶ added in v0.21.0
type KubeVirtSync struct { // If DataVolumes should get synced DataVolumes EnableSwitch `json:"dataVolumes,omitempty"` // If VirtualMachineInstanceMigrations should get synced VirtualMachineInstanceMigrations EnableSwitch `json:"virtualMachineInstanceMigrations,omitempty"` // If VirtualMachineInstances should get synced VirtualMachineInstances EnableSwitch `json:"virtualMachineInstances,omitempty"` // If VirtualMachines should get synced VirtualMachines EnableSwitch `json:"virtualMachines,omitempty"` // If VirtualMachineClones should get synced VirtualMachineClones EnableSwitch `json:"virtualMachineClones,omitempty"` // If VirtualMachinePools should get synced VirtualMachinePools EnableSwitch `json:"virtualMachinePools,omitempty"` }
KubeVirtSync are the crds that are supported by this integration
type KubernetesVersion ¶
func ParseKubernetesVersionInfo ¶
func ParseKubernetesVersionInfo(versionStr string) (*KubernetesVersion, error)
type LabelSelector ¶ added in v0.21.0
type LabelsAndAnnotations ¶
type LimitRange ¶
type LimitRange struct { // Enabled defines if the limit range should be deployed by vCluster. "auto" means that if resourceQuota is enabled, // the limitRange will be enabled as well. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` // Default are the default limits for the limit range Default map[string]interface{} `json:"default,omitempty"` // DefaultRequest are the default request options for the limit range DefaultRequest map[string]interface{} `json:"defaultRequest,omitempty"` // Max are the max limits for the limit range Max map[string]interface{} `json:"max,omitempty"` // Min are the min limits for the limit range Min map[string]interface{} `json:"min,omitempty"` LabelsAndAnnotations `json:",inline"` }
type MetricsServer ¶
type MetricsServer struct { // Enabled signals the metrics server integration should be enabled. Enabled bool `json:"enabled,omitempty"` // APIService holds information about where to find the metrics-server service. Defaults to metrics-server/kube-system. APIService APIService `json:"apiService,omitempty"` // Nodes defines if metrics-server nodes api should get proxied from host to virtual cluster. Nodes bool `json:"nodes,omitempty"` // Pods defines if metrics-server pods api should get proxied from host to virtual cluster. Pods bool `json:"pods,omitempty"` }
MetricsServer reuses the metrics server from the host cluster within the vCluster.
type MutatingWebhook ¶
type MutatingWebhook struct { // reinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. // Allowed values are "Never" and "IfNeeded". ReinvocationPolicy *string `protobuf:"bytes,10,opt,name=reinvocationPolicy,casttype=ReinvocationPolicyType" json:"reinvocationPolicy,omitempty"` ValidatingWebhook `json:",inline"` }
type MutatingWebhookConfiguration ¶
type MutatingWebhookConfiguration struct { // Kind is a string value representing the REST resource this object represents. // Servers may infer this from the endpoint the client submits requests to. Kind string `json:"kind,omitempty"` // APIVersion defines the versioned schema of this representation of an object. // Servers should convert recognized schemas to the latest internal value, and // may reject unrecognized values. APIVersion string `json:"apiVersion,omitempty"` // Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata. Metadata ObjectMeta `json:"metadata,omitempty"` // Webhooks is a list of webhooks and the affected resources and operations. Webhooks []MutatingWebhook `json:"webhooks,omitempty"` }
type NetworkPolicy ¶
type NetworkPolicy struct { // Enabled defines if the network policy should be deployed by vCluster. Enabled bool `json:"enabled,omitempty"` FallbackDNS string `json:"fallbackDns,omitempty"` OutgoingConnections OutgoingConnections `json:"outgoingConnections,omitempty"` LabelsAndAnnotations `json:",inline"` }
type NetworkProxyKubelets ¶
type NetworkProxyKubelets struct { // ByHostname will add a special vCluster hostname to the nodes where the node can be reached at. This doesn't work // for all applications, e.g. Prometheus requires a node IP. ByHostname bool `json:"byHostname,omitempty"` // ByIP will create a separate service in the host cluster for every node that will point to virtual cluster and will be used to // route traffic. ByIP bool `json:"byIP,omitempty"` }
type Networking ¶
type Networking struct { // ReplicateServices allows replicating services from the host within the virtual cluster or the other way around. ReplicateServices ReplicateServices `json:"replicateServices,omitempty"` // ResolveDNS allows to define extra DNS rules. This only works if embedded coredns is configured. ResolveDNS []ResolveDNS `json:"resolveDNS,omitempty" product:"pro"` // Advanced holds advanced network options. Advanced NetworkingAdvanced `json:"advanced,omitempty"` }
func (Networking) JSONSchemaExtend ¶
func (n Networking) JSONSchemaExtend(base *jsonschema.Schema)
type NetworkingAdvanced ¶
type NetworkingAdvanced struct { // ClusterDomain is the Kubernetes cluster domain to use within the virtual cluster. ClusterDomain string `json:"clusterDomain,omitempty"` // FallbackHostCluster allows to fallback dns to the host cluster. This is useful if you want to reach host services without // any other modification. You will need to provide a namespace for the service, e.g. my-other-service.my-other-namespace FallbackHostCluster bool `json:"fallbackHostCluster,omitempty"` // ProxyKubelets allows rewriting certain metrics and stats from the Kubelet to "fake" this for applications such as // prometheus or other node exporters. ProxyKubelets NetworkProxyKubelets `json:"proxyKubelets,omitempty"` }
type ObjectMeta ¶
type ObjectMeta struct { // Name must be unique within a namespace. Is required when creating resources, although // some resources may allow a client to request the generation of an appropriate name // automatically. Name is primarily intended for creation idempotence and configuration // definition. Name string `json:"name,omitempty"` // Map of string keys and values that can be used to organize and categorize // (scope and select) objects. May match selectors of replication controllers // and services. Labels map[string]string `json:"labels,omitempty"` // Annotations is an unstructured key value map stored with a resource that may be // set by external tools to store and retrieve arbitrary metadata. Annotations map[string]string `json:"annotations,omitempty"` }
type OutgoingConnections ¶
type OutgoingConnections struct { // IPBlock describes a particular CIDR (Ex. "192.168.1.0/24","2001:db8::/64") that is allowed // to the pods matched by a NetworkPolicySpec's podSelector. The except entry describes CIDRs // that should not be included within this rule. IPBlock IPBlock `json:"ipBlock,omitempty"` // Platform enables egress access towards loft platform Platform bool `json:"platform,omitempty"` }
type Patch ¶
type Patch struct { // Operation is the type of the patch Operation PatchType `json:"op,omitempty" yaml:"op,omitempty"` // FromPath is the path from the other object FromPath string `json:"fromPath,omitempty" yaml:"fromPath,omitempty"` // Path is the path of the patch Path string `json:"path,omitempty" yaml:"path,omitempty"` // NamePath is the path to the name of a child resource within Path NamePath string `json:"namePath,omitempty" yaml:"namePath,omitempty"` // NamespacePath is path to the namespace of a child resource within Path NamespacePath string `json:"namespacePath,omitempty" yaml:"namespacePath,omitempty"` // Value is the new value to be set to the path Value interface{} `json:"value,omitempty" yaml:"value,omitempty"` // Regex - is regular expresion used to identify the Name, // and optionally Namespace, parts of the field value that // will be replaced with the rewritten Name and/or Namespace Regex string `json:"regex,omitempty" yaml:"regex,omitempty"` ParsedRegex *regexp.Regexp `json:"-" yaml:"-"` // Conditions are conditions that must be true for // the patch to get executed Conditions []*PatchCondition `json:"conditions,omitempty" yaml:"conditions,omitempty"` // Ignore determines if the path should be ignored if handled as a reverse patch Ignore *bool `json:"ignore,omitempty" yaml:"ignore,omitempty"` // Sync defines if a specialized syncer should be initialized using values // from the rewriteName operation as Secret/Configmap names to be synced Sync *PatchSync `json:"sync,omitempty" yaml:"sync,omitempty"` }
type PatchCondition ¶
type PatchCondition struct { // Path is the path within the object to select Path string `json:"path,omitempty" yaml:"path,omitempty"` // SubPath is the path below the selected object to select SubPath string `json:"subPath,omitempty" yaml:"subPath,omitempty"` // Equal is the value the path should be equal to Equal interface{} `json:"equal,omitempty" yaml:"equal,omitempty"` // NotEqual is the value the path should not be equal to NotEqual interface{} `json:"notEqual,omitempty" yaml:"notEqual,omitempty"` // Empty means that the path value should be empty or unset Empty *bool `json:"empty,omitempty" yaml:"empty,omitempty"` }
type PatchType ¶
type PatchType string
const ( PatchTypeRewriteName PatchType = "rewriteName" PatchTypeRewriteLabelKey PatchType = "rewriteLabelKey" PatchTypeRewriteLabelSelector PatchType = "rewriteLabelSelector" PatchTypeRewriteLabelExpressionsSelector PatchType = "rewriteLabelExpressionsSelector" PatchTypeCopyFromObject PatchType = "copyFromObject" PatchTypeAdd PatchType = "add" PatchTypeReplace PatchType = "replace" PatchTypeRemove PatchType = "remove" )
type PlatformAPIKey ¶
type PlatformAPIKey struct { // SecretName is the name of the secret where the platform access key is stored. This defaults to vcluster-platform-api-key if undefined. SecretName string `json:"secretName,omitempty"` // Namespace defines the namespace where the access key secret should be retrieved from. If this is not equal to the namespace // where the vCluster instance is deployed, you need to make sure vCluster has access to this other namespace. Namespace string `json:"namespace,omitempty"` // CreateRBAC will automatically create the necessary RBAC roles and role bindings to allow vCluster to read the secret specified // in the above namespace, if specified. // This defaults to true. CreateRBAC *bool `json:"createRBAC,omitempty"` }
PlatformAPIKey defines where to find the platform access key. The secret key name doesn't matter as long as the secret only contains a single key.
type PlatformConfig ¶
type PlatformConfig struct { // APIKey defines where to find the platform access key and host. By default, vCluster will search in the following locations in this precedence: // * environment variable called LICENSE // * secret specified under external.platform.apiKey.secretName // * secret called "vcluster-platform-api-key" in the vCluster namespace APIKey PlatformAPIKey `json:"apiKey,omitempty"` }
type Plugin ¶
type Plugin struct { Plugins `json:",inline"` // Version is the plugin version, this is only needed for legacy plugins. Version string `json:"version,omitempty"` Env []interface{} `json:"env,omitempty"` EnvFrom []interface{} `json:"envFrom,omitempty"` Lifecycle map[string]interface{} `json:"lifecycle,omitempty"` LivenessProbe map[string]interface{} `json:"livenessProbe,omitempty"` ReadinessProbe map[string]interface{} `json:"readinessProbe,omitempty"` StartupProbe map[string]interface{} `json:"startupProbe,omitempty"` WorkingDir string `json:"workingDir,omitempty"` Optional bool `json:"optional,omitempty"` }
type Plugins ¶
type Plugins struct { // Name is the name of the init-container and NOT the plugin name Name string `json:"name,omitempty"` // Image is the container image that should be used for the plugin Image string `json:"image,omitempty"` // ImagePullPolicy is the pull policy to use for the container image ImagePullPolicy string `json:"imagePullPolicy,omitempty"` // Config is the plugin config to use. This can be arbitrary config used for the plugin. Config map[string]interface{} `json:"config,omitempty"` // RBAC holds additional rbac configuration for the plugin RBAC PluginsRBAC `json:"rbac,omitempty"` // Command is the command that should be used for the init container Command []string `json:"command,omitempty"` // Args are the arguments that should be used for the init container Args []string `json:"args,omitempty"` // SecurityContext is the container security context used for the init container SecurityContext map[string]interface{} `json:"securityContext,omitempty"` // Resources are the container resources used for the init container Resources map[string]interface{} `json:"resources,omitempty"` // VolumeMounts are extra volume mounts for the init container VolumeMounts []interface{} `json:"volumeMounts,omitempty"` }
type PluginsExtraRules ¶
type PluginsExtraRules struct { // ExtraRules are extra rbac permissions roles that will be added to role or cluster role ExtraRules []RBACPolicyRule `json:"extraRules,omitempty"` }
type PluginsRBAC ¶
type PluginsRBAC struct { // Role holds extra virtual cluster role permissions for the plugin Role PluginsExtraRules `json:"role,omitempty"` // ClusterRole holds extra virtual cluster cluster role permissions required for the plugin ClusterRole PluginsExtraRules `json:"clusterRole,omitempty"` }
type PodDNSConfig ¶ added in v0.21.0
type PodDNSConfig struct { // A list of DNS name server IP addresses. // This will be appended to the base nameservers generated from DNSPolicy. // Duplicated nameservers will be removed. // +optional // +listType=atomic Nameservers []string `protobuf:"bytes,1,rep,name=nameservers" json:"nameservers,omitempty"` // A list of DNS search domains for host-name lookup. // This will be appended to the base search paths generated from DNSPolicy. // Duplicated search paths will be removed. // +optional // +listType=atomic Searches []string `protobuf:"bytes,2,rep,name=searches" json:"searches,omitempty"` // A list of DNS resolver options. // This will be merged with the base options generated from DNSPolicy. // Duplicated entries will be removed. Resolution options given in Options // will override those that appear in the base DNSPolicy. // +optional // +listType=atomic Options []PodDNSConfigOption `protobuf:"bytes,3,rep,name=options" json:"options,omitempty"` }
PodDNSConfig defines the DNS parameters of a pod in addition to those generated from DNSPolicy.
type PodDNSConfigOption ¶ added in v0.21.0
type PodDNSConfigOption struct { // Required. Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"` // +optional Value *string `protobuf:"bytes,2,opt,name=value" json:"value,omitempty"` }
PodDNSConfigOption defines DNS resolver options of a pod.
type Policies ¶
type Policies struct { // NetworkPolicy specifies network policy options. NetworkPolicy NetworkPolicy `json:"networkPolicy,omitempty"` // PodSecurityStandard that can be enforced can be one of: empty (""), baseline, restricted or privileged PodSecurityStandard string `json:"podSecurityStandard,omitempty"` // ResourceQuota specifies resource quota options. ResourceQuota ResourceQuota `json:"resourceQuota,omitempty"` // LimitRange specifies limit range options. LimitRange LimitRange `json:"limitRange,omitempty"` // CentralAdmission defines what validating or mutating webhooks should be enforced within the virtual cluster. CentralAdmission CentralAdmission `json:"centralAdmission,omitempty" product:"pro"` }
func (Policies) JSONSchemaExtend ¶
func (p Policies) JSONSchemaExtend(base *jsonschema.Schema)
type RBAC ¶
type RBAC struct { // Role holds virtual cluster role configuration Role RBACRole `json:"role,omitempty"` // ClusterRole holds virtual cluster cluster role configuration ClusterRole RBACClusterRole `json:"clusterRole,omitempty"` }
type RBACClusterRole ¶
type RBACClusterRole struct { // Enabled defines if the cluster role should be enabled or disabled. If auto, vCluster automatically determines whether the virtual cluster requires a cluster role. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` // ExtraRules will add rules to the cluster role. ExtraRules []map[string]interface{} `json:"extraRules,omitempty"` // OverwriteRules will overwrite the cluster role rules completely. OverwriteRules []map[string]interface{} `json:"overwriteRules,omitempty"` }
type RBACPolicyRule ¶
type RBACPolicyRule struct { // Verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs. Verbs []string `json:"verbs"` // APIGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of // the enumerated resources in any API group will be allowed. "" represents the core API group and "*" represents all API groups. APIGroups []string `json:"apiGroups,omitempty"` // Resources is a list of resources this rule applies to. '*' represents all resources. Resources []string `json:"resources,omitempty"` // ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed. ResourceNames []string `json:"resourceNames,omitempty"` // NonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path // Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. // Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both. NonResourceURLs []string `json:"nonResourceURLs,omitempty"` }
type RBACRole ¶
type RBACRole struct { // Enabled defines if the role should be enabled or disabled. Enabled bool `json:"enabled,omitempty"` // ExtraRules will add rules to the role. ExtraRules []map[string]interface{} `json:"extraRules,omitempty"` // OverwriteRules will overwrite the role rules completely. OverwriteRules []map[string]interface{} `json:"overwriteRules,omitempty"` }
type ReplicateServices ¶
type ReplicateServices struct { // ToHost defines the services that should get synced from virtual cluster to the host cluster. If services are // synced to a different namespace than the virtual cluster is in, additional permissions for the other namespace // are required. ToHost []ServiceMapping `json:"toHost,omitempty"` // FromHost defines the services that should get synced from the host to the virtual cluster. FromHost []ServiceMapping `json:"fromHost,omitempty"` }
type ResolveDNS ¶
type ResolveDNS struct { // Hostname is the hostname within the vCluster that should be resolved from. Hostname string `json:"hostname"` // Service is the virtual cluster service that should be resolved from. Service string `json:"service"` // Namespace is the virtual cluster namespace that should be resolved from. Namespace string `json:"namespace"` // Target is the DNS target that should get mapped to Target ResolveDNSTarget `json:"target,omitempty"` }
type ResolveDNSTarget ¶
type ResolveDNSTarget struct { // Hostname to use as a DNS target Hostname string `json:"hostname,omitempty"` // IP to use as a DNS target IP string `json:"ip,omitempty"` // HostService to target, format is hostNamespace/hostService HostService string `json:"hostService,omitempty"` // HostNamespace to target HostNamespace string `json:"hostNamespace,omitempty"` // VClusterService format is hostNamespace/vClusterName/vClusterNamespace/vClusterService VClusterService string `json:"vClusterService,omitempty"` }
type ResourceQuota ¶
type ResourceQuota struct { // Enabled defines if the resource quota should be enabled. "auto" means that if limitRange is enabled, // the resourceQuota will be enabled as well. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` // Quota are the quota options Quota map[string]interface{} `json:"quota,omitempty"` // ScopeSelector is the resource quota scope selector ScopeSelector map[string]interface{} `json:"scopeSelector,omitempty"` // Scopes are the resource quota scopes Scopes []string `json:"scopes,omitempty"` LabelsAndAnnotations `json:",inline"` }
type RuleWithVerbs ¶
type RuleWithVerbs struct { // APIGroups is the API groups the resources belong to. '*' is all groups. APIGroups []string `protobuf:"bytes,1,rep,name=apiGroups" json:"apiGroups,omitempty"` // APIVersions is the API versions the resources belong to. '*' is all versions. APIVersions []string `protobuf:"bytes,2,rep,name=apiVersions" json:"apiVersions,omitempty"` // Resources is a list of resources this rule applies to. Resources []string `protobuf:"bytes,3,rep,name=resources" json:"resources,omitempty"` // Scope specifies the scope of this rule. Scope *string `protobuf:"bytes,4,rep,name=scope" json:"scope,omitempty"` // Verb is the kube verb associated with the request for API requests, not the http verb. This includes things like list and watch. // For non-resource requests, this is the lowercase http verb. // If '*' is present, the length of the slice must be one. Verbs []string `json:"operations,omitempty"` }
type ServiceMapping ¶
type ServiceMapping struct { // From is the service that should get synced. Can be either in the form name or namespace/name. From string `json:"from,omitempty"` // To is the target service that it should get synced to. Can be either in the form name or namespace/name. To string `json:"to,omitempty"` }
type ServiceMonitor ¶
type ServiceMonitor struct { // Enabled configures if Helm should create the service monitor. Enabled bool `json:"enabled,omitempty"` // Labels are the extra labels to add to the service monitor. Labels map[string]string `json:"labels,omitempty"` // Annotations are the extra annotations to add to the service monitor. Annotations map[string]string `json:"annotations,omitempty"` }
type SleepMode ¶
type SleepMode struct { // Enabled toggles the sleep mode functionality, allowing for disabling sleep mode without removing other config Enabled bool `json:"enabled,omitempty"` // Timezone represents the timezone a sleep schedule should run against, defaulting to UTC if unset TimeZone string `json:"timeZone,omitempty"` // AutoSleep holds autoSleep details AutoSleep SleepModeAutoSleep `json:"autoSleep,omitempty"` }
SleepMode holds configuration for native/workload only sleep mode
type SleepModeAutoSleep ¶
type SleepModeAutoSleep struct { // AfterInactivity represents how long a vCluster can be idle before workloads are automaticaly put to sleep AfterInactivity Duration `json:"afterInactivity,omitempty"` // Schedule represents a cron schedule for when to sleep workloads Schedule string `json:"schedule,omitempty"` // Wakeup holds configuration for waking the vCluster on a schedule rather than waiting for some activity. Wakeup AutoWakeup `json:"wakeup,omitempty"` // Exclude holds configuration for labels that, if present, will prevent a workload from going to sleep Exclude AutoSleepExclusion `json:"exclude,omitempty"` }
SleepModeAutoSleep holds configuration for allowing a vCluster to sleep its workloads automatically
type StatefulSetImage ¶
type StatefulSetImage struct { // Configure the registry of the container image, e.g. my-registry.com or ghcr.io // It defaults to ghcr.io and can be overriding either by using this field or controlPlane.advanced.defaultImageRegistry Registry string `json:"registry,omitempty"` // Configure the repository of the container image, e.g. my-repo/my-image. // It defaults to the vCluster pro repository that includes the optional pro modules that are turned off by default. // If you still want to use the pure OSS build, use 'loft-sh/vcluster-oss' instead. Repository string `json:"repository,omitempty"` // Tag is the tag of the container image, e.g. latest Tag string `json:"tag,omitempty"` }
type Sync ¶
type Sync struct { // Configure resources to sync from the virtual cluster to the host cluster. ToHost SyncToHost `json:"toHost,omitempty"` // Configure what resources vCluster should sync from the host cluster to the virtual cluster. FromHost SyncFromHost `json:"fromHost,omitempty"` }
type SyncAllResource ¶
type SyncAllResource struct { // Enabled defines if this option should be enabled. Enabled bool `json:"enabled,omitempty"` // All defines if all resources of that type should get synced or only the necessary ones that are needed. All bool `json:"all,omitempty"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type SyncBase ¶
type SyncBase struct { TypeInformation `json:",inline" yaml:",inline"` Optional bool `json:"optional,omitempty" yaml:"optional,omitempty"` // ReplaceWhenInvalid determines if the controller should try to recreate the object // if there is a problem applying ReplaceWhenInvalid bool `json:"replaceOnConflict,omitempty" yaml:"replaceOnConflict,omitempty"` // Patches are the patches to apply on the virtual cluster objects // when syncing them from the host cluster Patches []*Patch `json:"patches,omitempty" yaml:"patches,omitempty"` // ReversePatches are the patches to apply to host cluster objects // after it has been synced to the virtual cluster ReversePatches []*Patch `json:"reversePatches,omitempty" yaml:"reversePatches,omitempty"` }
type SyncFromHost ¶
type SyncFromHost struct { // Nodes defines if nodes should get synced from the host cluster to the virtual cluster, but not back. Nodes SyncNodes `json:"nodes,omitempty"` // Events defines if events should get synced from the host cluster to the virtual cluster, but not back. Events EnableSwitchWithPatches `json:"events,omitempty"` // IngressClasses defines if ingress classes should get synced from the host cluster to the virtual cluster, but not back. IngressClasses EnableSwitchWithPatches `json:"ingressClasses,omitempty"` // RuntimeClasses defines if runtime classes should get synced from the host cluster to the virtual cluster, but not back. RuntimeClasses EnableSwitchWithPatches `json:"runtimeClasses,omitempty"` // PriorityClasses defines if priority classes classes should get synced from the host cluster to the virtual cluster, but not back. PriorityClasses EnableSwitchWithPatches `json:"priorityClasses,omitempty"` // StorageClasses defines if storage classes should get synced from the host cluster to the virtual cluster, but not back. If auto, is automatically enabled when the virtual scheduler is enabled. StorageClasses EnableAutoSwitchWithPatches `json:"storageClasses,omitempty"` // CSINodes defines if csi nodes should get synced from the host cluster to the virtual cluster, but not back. If auto, is automatically enabled when the virtual scheduler is enabled. CSINodes EnableAutoSwitchWithPatches `json:"csiNodes,omitempty"` // CSIDrivers defines if csi drivers should get synced from the host cluster to the virtual cluster, but not back. If auto, is automatically enabled when the virtual scheduler is enabled. CSIDrivers EnableAutoSwitchWithPatches `json:"csiDrivers,omitempty"` // CSIStorageCapacities defines if csi storage capacities should get synced from the host cluster to the virtual cluster, but not back. If auto, is automatically enabled when the virtual scheduler is enabled. CSIStorageCapacities EnableAutoSwitchWithPatches `json:"csiStorageCapacities,omitempty"` // CustomResources defines what custom resources should get synced read-only to the virtual cluster from the host cluster. vCluster will automatically add any required RBAC to the vCluster cluster role. CustomResources map[string]SyncFromHostCustomResource `json:"customResources,omitempty"` // VolumeSnapshotClasses defines if volume snapshot classes created within the virtual cluster should get synced to the host cluster. VolumeSnapshotClasses EnableSwitchWithPatches `json:"volumeSnapshotClasses,omitempty"` }
type SyncFromHostCustomResource ¶ added in v0.21.0
type SyncFromHostCustomResource struct { // Enabled defines if this option should be enabled. Enabled bool `json:"enabled,omitempty" jsonschema:"required"` // Scope defines the scope of the resource Scope Scope `json:"scope,omitempty" jsonschema:"required"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type SyncNodeSelector ¶
type SyncNodeSelector struct { // All specifies if all nodes should get synced by vCluster from the host to the virtual cluster or only the ones where pods are assigned to. All bool `json:"all,omitempty"` // Labels are the node labels used to sync nodes from host cluster to virtual cluster. This will also set the node selector when syncing a pod from virtual cluster to host cluster to the same value. Labels map[string]string `json:"labels,omitempty"` }
type SyncNodes ¶
type SyncNodes struct { // Enabled specifies if syncing real nodes should be enabled. If this is disabled, vCluster will create fake nodes instead. Enabled bool `json:"enabled,omitempty"` // SyncBackChanges enables syncing labels and taints from the virtual cluster to the host cluster. If this is enabled someone within the virtual cluster will be able to change the labels and taints of the host cluster node. SyncBackChanges bool `json:"syncBackChanges,omitempty"` // ClearImageStatus will erase the image status when syncing a node. This allows to hide images that are pulled by the node. ClearImageStatus bool `json:"clearImageStatus,omitempty"` // Selector can be used to define more granular what nodes should get synced from the host cluster to the virtual cluster. Selector SyncNodeSelector `json:"selector,omitempty"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type SyncPods ¶
type SyncPods struct { // Enabled defines if pod syncing should be enabled. Enabled bool `json:"enabled,omitempty"` // TranslateImage maps an image to another image that should be used instead. For example this can be used to rewrite // a certain image that is used within the virtual cluster to be another image on the host cluster TranslateImage map[string]string `json:"translateImage,omitempty"` // EnforceTolerations will add the specified tolerations to all pods synced by the virtual cluster. EnforceTolerations []string `json:"enforceTolerations,omitempty"` // UseSecretsForSATokens will use secrets to save the generated service account tokens by virtual cluster instead of using a // pod annotation. UseSecretsForSATokens bool `json:"useSecretsForSATokens,omitempty"` // RewriteHosts is a special option needed to rewrite statefulset containers to allow the correct FQDN. virtual cluster will add // a small container to each stateful set pod that will initially rewrite the /etc/hosts file to match the FQDN expected by // the virtual cluster. RewriteHosts SyncRewriteHosts `json:"rewriteHosts,omitempty"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type SyncRewriteHosts ¶
type SyncRewriteHosts struct { // Enabled specifies if rewriting stateful set pods should be enabled. Enabled bool `json:"enabled,omitempty"` // InitContainer holds extra options for the init container used by vCluster to rewrite the FQDN for stateful set pods. InitContainer SyncRewriteHostsInitContainer `json:"initContainer,omitempty"` }
type SyncRewriteHostsInitContainer ¶
type SyncRewriteHostsInitContainer struct { // Image is the image virtual cluster should use to rewrite this FQDN. Image string `json:"image,omitempty"` // Resources are the resources that should be assigned to the init container for each stateful set init container. Resources Resources `json:"resources,omitempty"` }
type SyncToHost ¶
type SyncToHost struct { // Pods defines if pods created within the virtual cluster should get synced to the host cluster. Pods SyncPods `json:"pods,omitempty"` // Secrets defines if secrets created within the virtual cluster should get synced to the host cluster. Secrets SyncAllResource `json:"secrets,omitempty"` // ConfigMaps defines if config maps created within the virtual cluster should get synced to the host cluster. ConfigMaps SyncAllResource `json:"configMaps,omitempty"` // Ingresses defines if ingresses created within the virtual cluster should get synced to the host cluster. Ingresses EnableSwitchWithPatches `json:"ingresses,omitempty"` // Services defines if services created within the virtual cluster should get synced to the host cluster. Services EnableSwitchWithPatches `json:"services,omitempty"` // Endpoints defines if endpoints created within the virtual cluster should get synced to the host cluster. Endpoints EnableSwitchWithPatches `json:"endpoints,omitempty"` // NetworkPolicies defines if network policies created within the virtual cluster should get synced to the host cluster. NetworkPolicies EnableSwitchWithPatches `json:"networkPolicies,omitempty"` // PersistentVolumeClaims defines if persistent volume claims created within the virtual cluster should get synced to the host cluster. PersistentVolumeClaims EnableSwitchWithPatches `json:"persistentVolumeClaims,omitempty"` // PersistentVolumes defines if persistent volumes created within the virtual cluster should get synced to the host cluster. PersistentVolumes EnableSwitchWithPatches `json:"persistentVolumes,omitempty"` // VolumeSnapshots defines if volume snapshots created within the virtual cluster should get synced to the host cluster. VolumeSnapshots EnableSwitchWithPatches `json:"volumeSnapshots,omitempty"` // VolumeSnapshotContents defines if volume snapshot contents created within the virtual cluster should get synced to the host cluster. VolumeSnapshotContents EnableSwitchWithPatches `json:"volumeSnapshotContents,omitempty"` // StorageClasses defines if storage classes created within the virtual cluster should get synced to the host cluster. StorageClasses EnableSwitchWithPatches `json:"storageClasses,omitempty"` // ServiceAccounts defines if service accounts created within the virtual cluster should get synced to the host cluster. ServiceAccounts EnableSwitchWithPatches `json:"serviceAccounts,omitempty"` // PodDisruptionBudgets defines if pod disruption budgets created within the virtual cluster should get synced to the host cluster. PodDisruptionBudgets EnableSwitchWithPatches `json:"podDisruptionBudgets,omitempty"` // PriorityClasses defines if priority classes created within the virtual cluster should get synced to the host cluster. PriorityClasses EnableSwitchWithPatches `json:"priorityClasses,omitempty"` // CustomResources defines what custom resources should get synced from the virtual cluster to the host cluster. vCluster will copy the definition automatically from host cluster to virtual cluster on startup. // vCluster will also automatically add any required RBAC permissions to the vCluster role for this to work. CustomResources map[string]SyncToHostCustomResource `json:"customResources,omitempty"` }
type SyncToHostCustomResource ¶ added in v0.21.0
type SyncToHostCustomResource struct { // Enabled defines if this option should be enabled. Enabled bool `json:"enabled,omitempty" jsonschema:"required"` // Scope defines the scope of the resource. If undefined, will use Namespaced. Currently only Namespaced is supported. Scope Scope `json:"scope,omitempty"` // Patches patch the resource according to the provided specification. Patches []TranslatePatch `json:"patches,omitempty"` }
type Telemetry ¶
type Telemetry struct { // Enabled specifies that the telemetry for the vCluster control plane should be enabled. Enabled bool `json:"enabled,omitempty"` InstanceCreator string `json:"instanceCreator,omitempty"` MachineID string `json:"machineID,omitempty"` PlatformUserID string `json:"platformUserID,omitempty"` PlatformInstanceID string `json:"platformInstanceID,omitempty"` }
type TranslatePatch ¶ added in v0.21.0
type TranslatePatch struct { // Path is the path within the patch to target. If the path is not found within the patch, the patch is not applied. Path string `json:"path,omitempty" jsonschema:"required"` // Expression transforms the value according to the given JavaScript expression. Expression string `json:"expression,omitempty"` // ReverseExpression transforms the value according to the given JavaScript expression. ReverseExpression string `json:"reverseExpression,omitempty"` // Reference treats the path value as a reference to another object and will rewrite it based on the chosen mode // automatically. In single-namespace mode this will translate the name to "vxxxxxxxxx" to avoid conflicts with // other names, in multi-namespace mode this will not translate the name. Reference *TranslatePatchReference `json:"reference,omitempty"` // Labels treats the path value as a labels selector. Labels *TranslatePatchLabels `json:"labels,omitempty"` }
type TranslatePatchLabels ¶ added in v0.21.0
type TranslatePatchLabels struct{}
type TranslatePatchReference ¶ added in v0.21.0
type TranslatePatchReference struct { // APIVersion is the apiVersion of the referenced object. APIVersion string `json:"apiVersion,omitempty" jsonschema:"required"` // APIVersionPath is optional relative path to use to determine the kind. If APIVersionPath is not found, will fallback to apiVersion. APIVersionPath string `json:"apiVersionPath,omitempty"` // Kind is the kind of the referenced object. Kind string `json:"kind,omitempty" jsonschema:"required"` // KindPath is the optional relative path to use to determine the kind. If KindPath is not found, will fallback to kind. KindPath string `json:"kindPath,omitempty"` // NamePath is the optional relative path to the reference name within the object. NamePath string `json:"namePath,omitempty"` // NamespacePath is the optional relative path to the reference namespace within the object. If omitted or not found, namespacePath equals to the // metadata.namespace path of the object. NamespacePath string `json:"namespacePath,omitempty"` }
type TypeInformation ¶
type ValidatingWebhook ¶
type ValidatingWebhook struct { // The name of the admission webhook. // Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where // "imagepolicy" is the name of the webhook, and kubernetes.io is the name // of the organization. Name string `json:"name"` // ClientConfig defines how to communicate with the hook. ClientConfig ValidatingWebhookClientConfig `json:"clientConfig"` // Rules describes what operations on what resources/subresources the webhook cares about. // The webhook cares about an operation if it matches _any_ Rule. Rules []interface{} `json:"rules,omitempty"` // FailurePolicy defines how unrecognized errors from the admission endpoint are handled - // allowed values are Ignore or Fail. Defaults to Fail. FailurePolicy *string `json:"failurePolicy,omitempty"` // matchPolicy defines how the "rules" list is used to match incoming requests. // Allowed values are "Exact" or "Equivalent". MatchPolicy *string `json:"matchPolicy,omitempty"` // NamespaceSelector decides whether to run the webhook on an object based // on whether the namespace for that object matches the selector. If the // object itself is a namespace, the matching is performed on // object.metadata.labels. If the object is another cluster scoped resource, // it never skips the webhook. NamespaceSelector interface{} `json:"namespaceSelector,omitempty"` // ObjectSelector decides whether to run the webhook based on if the // object has matching labels. objectSelector is evaluated against both // the oldObject and newObject that would be sent to the webhook, and // is considered to match if either object matches the selector. ObjectSelector interface{} `json:"objectSelector,omitempty"` // SideEffects states whether this webhook has side effects. SideEffects *string `json:"sideEffects"` // TimeoutSeconds specifies the timeout for this webhook. TimeoutSeconds *int32 `json:"timeoutSeconds,omitempty"` // AdmissionReviewVersions is an ordered list of preferred `AdmissionReview` // versions the Webhook expects. AdmissionReviewVersions []string `json:"admissionReviewVersions"` // MatchConditions is a list of conditions that must be met for a request to be sent to this // webhook. Match conditions filter requests that have already been matched by the rules, // namespaceSelector, and objectSelector. An empty list of matchConditions matches all requests. // There are a maximum of 64 match conditions allowed. MatchConditions []interface{} `json:"matchConditions,omitempty"` }
type ValidatingWebhookClientConfig ¶
type ValidatingWebhookClientConfig struct { // URL gives the location of the webhook, in standard URL form // (`scheme://host:port/path`). Exactly one of `url` or `service` // must be specified. URL *string `json:"url,omitempty"` // Service is a reference to the service for this webhook. Either // `service` or `url` must be specified. // // If the webhook is running within the cluster, then you should use `service`. Service *ValidatingWebhookServiceReference `json:"service,omitempty"` // CABundle is a PEM encoded CA bundle which will be used to validate the webhook's server certificate. // If unspecified, system trust roots on the apiserver are used. CABundle []byte `json:"caBundle,omitempty"` }
ValidatingWebhookClientConfig contains the information to make a TLS connection with the webhook
type ValidatingWebhookConfiguration ¶
type ValidatingWebhookConfiguration struct { // Kind is a string value representing the REST resource this object represents. // Servers may infer this from the endpoint the client submits requests to. Kind string `json:"kind,omitempty"` // APIVersion defines the versioned schema of this representation of an object. // Servers should convert recognized schemas to the latest internal value, and // may reject unrecognized values. APIVersion string `json:"apiVersion,omitempty"` // Standard object metadata; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata. Metadata ObjectMeta `json:"metadata,omitempty"` // Webhooks is a list of webhooks and the affected resources and operations. Webhooks []ValidatingWebhook `json:"webhooks,omitempty"` }
type ValidatingWebhookServiceReference ¶
type ValidatingWebhookServiceReference struct { // Namespace is the namespace of the service. Namespace string `json:"namespace"` // Name is the name of the service. Name string `json:"name"` // Path is an optional URL path which will be sent in any request to // this service. Path *string `json:"path,omitempty"` // If specified, the port on the service that hosting webhook. // Default to 443 for backward compatibility. // `port` should be a valid port number (1-65535, inclusive). Port *int32 `json:"port,omitempty"` }
type VirtualClusterKubeConfig ¶
type VirtualClusterKubeConfig struct { // KubeConfig is the virtual cluster kubeconfig path. KubeConfig string `json:"kubeConfig,omitempty"` // ServerCAKey is the server ca key path. ServerCAKey string `json:"serverCAKey,omitempty"` // ServerCAKey is the server ca cert path. ServerCACert string `json:"serverCACert,omitempty"` // ServerCAKey is the client ca cert path. ClientCACert string `json:"clientCACert,omitempty"` // RequestHeaderCACert is the request header ca cert path. RequestHeaderCACert string `json:"requestHeaderCACert,omitempty"` }
type VolumeClaim ¶
type VolumeClaim struct { // Enabled enables deploying a persistent volume claim. If auto, vCluster will automatically determine // based on the chosen distro and other options if this is required. Enabled StrBool `json:"enabled,omitempty" jsonschema:"oneof_type=string;boolean"` // AccessModes are the persistent volume claim access modes. AccessModes []string `json:"accessModes,omitempty"` // RetentionPolicy is the persistent volume claim retention policy. RetentionPolicy string `json:"retentionPolicy,omitempty"` // Size is the persistent volume claim storage size. Size string `json:"size,omitempty"` // StorageClass is the persistent volume claim storage class. StorageClass string `json:"storageClass,omitempty"` }
type VolumeMount ¶
type VolumeMount struct { // This must match the Name of a Volume. Name string `protobuf:"bytes,1,opt,name=name" json:"name"` // Mounted read-only if true, read-write otherwise (false or unspecified). // Defaults to false. ReadOnly bool `protobuf:"varint,2,opt,name=readOnly" json:"readOnly,omitempty"` // Path within the container at which the volume should be mounted. Must // not contain ':'. MountPath string `protobuf:"bytes,3,opt,name=mountPath" json:"mountPath"` // Path within the volume from which the container's volume should be mounted. // Defaults to "" (volume's root). SubPath string `protobuf:"bytes,4,opt,name=subPath" json:"subPath,omitempty"` // mountPropagation determines how mounts are propagated from the host // to container and the other way around. // When not set, MountPropagationNone is used. // This field is beta in 1.10. MountPropagation *string `protobuf:"bytes,5,opt,name=mountPropagation,casttype=MountPropagationMode" json:"mountPropagation,omitempty"` // Expanded path within the volume from which the container's volume should be mounted. // Behaves similarly to SubPath but environment variable references $(VAR_NAME) are expanded using the container's environment. // Defaults to "" (volume's root). // SubPathExpr and SubPath are mutually exclusive. SubPathExpr string `protobuf:"bytes,6,opt,name=subPathExpr" json:"subPathExpr,omitempty"` }
VolumeMount describes a mounting of a Volume within a container.