v1alpha1

type APIServerComponent struct {
	// KubeAPIServerComponent holds settings to kube-apiserver component of the kubernetes.
	// Karmada uses it as it's own apiserver in order to provide Kubernetes-native APIs.
	KubeAPIServer KubeAPIServerComponent `json:"kubeAPIServer,omitempty"`

	// KarmadaAggregratedAPIServerComponent holds settings to karmada-aggregated-apiserver component of the karmada.
	KarmadaAggregratedAPIServer KarmadaAggregratedAPIServerComponent `json:"karmadaAggregratedAPIServer,omitempty"`
}

type ClusterSynchroManagerComponent struct {
	// ImageMeta allows to customize the image used for the clustersynchro-manager component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the clustersynchro-manager component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// clustersynchro-manager component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/clusterpedia-io/clusterpedia/blob/main/cmd/clustersynchro-manager/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// FeatureGates enabled by the user.
	// More info: https://github.com/clusterpedia-io/clusterpedia/blob/main/pkg/synchromanager/features/features.go
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type Clusterpedia struct {
	metav1.TypeMeta `json:",inline"`
	// Standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// Specification of the desired behavior of the Clusterpedia.
	// +optional
	Spec ClusterpediaSpec `json:"spec"`
	// Most recently observed status of the Clusterpedia.
	// +optional
	Status ClusterpediaStatus `json:"status"`
}

type ClusterpediaAPIServerComponent struct {
	// ImageMeta allows to customize the image used for the clusterpedia-apiserver component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the clusterpedia-apiserver component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// clusterpedia-apiserver component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/clusterpedia-io/clusterpedia/blob/main/cmd/apiserver/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// FeatureGates enabled by the user.
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type ClusterpediaControllerManagerComponent struct {
	// ImageMeta allows to customize the image used for the clusterpedia-controller-manager component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the clusterpedia-controller-manager component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// clusterpedia-controller-manager component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/clusterpedia-io/clusterpedia/blob/main/cmd/controller-manager/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// FeatureGates enabled by the user.
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type ClusterpediaControlplaneProvider struct {
	// SyncAllCustomResources indicates whether to sync all the custom resources of member clusters to clusterpedia.
	// +optional
	SyncAllCustomResources bool `json:"syncAllCustomResources,omitempty"`

	// SyncResources represents which resources will be synced to clusterpedia from member clusters.
	// If empty, firefly won't auto-create clusterimportpolicy and nothing will be synced into clusterpedia by default.
	// +optional
	SyncResources []clusterapi.ClusterGroupResources `json:"syncResources,omitempty"`

	// Karmada represents the karmada control plane.
	// +optional
	Karmada *ClusterpediaControlplaneProviderKarmada `json:"karmada,omitempty"`
}

type ClusterpediaControlplaneProviderKarmada struct {
	corev1.LocalObjectReference `json:",inline"`
}

type ClusterpediaList struct {
	metav1.TypeMeta `json:",inline"`
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ListMeta `json:"metadata"`

	Items []Clusterpedia `json:"items"`
}

type ClusterpediaSpec struct {
	// ControlplaneProvider represents where the clusterpedia crds will be deployed on.
	// If unset, means that the clusterpedia and its crds will be installed on the host
	// cluster.
	// +optional
	ControlplaneProvider *ClusterpediaControlplaneProvider `json:"controlplaneProvider,omitempty"`

	// Version is the target version of the clusterpedia component.
	// If empty, `latest` will be used by default.
	// +optional
	Version string `json:"version,omitempty"`

	// Storage contains extra settings for the clusterpedia-storage component
	// If empty, firefly will choose the internal postgres as default value.
	// +optional
	Storage ClusterpediaStorageComponent `json:"storage,omitempty"`

	// APIServer contains extra settings for the clusterpedia-apiserver component
	// +optional
	APIServer ClusterpediaAPIServerComponent `json:"apiServer,omitempty"`

	// ControllerManager contains extra settings for the clusterpedia-controller-manager component
	ControllerManager ClusterpediaControllerManagerComponent `json:"controllerManager,omitempty"`

	// ClusterSynchroManager contains extra settings for the clustersynchro-manager component
	ClusterpediaSynchroManager ClusterSynchroManagerComponent `json:"clusterSynchroManager,omitempty"`

	// ImageRepository sets the container registry to pull images from.
	// If empty, `ghcr.io/clusterpedia-io/clusterpedia` will be used by default.
	// +optional
	ImageRepository string `json:"imageRepository,omitempty"`

	// FeatureGates enabled by the user.
	// If you don't know that a feature gate should be applied to which components, you can
	// use this field to enable or disable the feature gate for all the components of the clusterpedia instance.
	// It can be overridden by the component-specific feature gate settings.
	// Note: the clusterpedia community doesn't support this field now. Please use component-specific feature gate settings.
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type ClusterpediaStatus struct {
	// observedGeneration is the most recent generation observed for this Clusterpedia. It corresponds to the
	// Clusterpedia's generation, which is updated on mutation by the API Server.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Represents the latest available observations of a clusterpedia's current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type ClusterpediaStorageComponent struct {
	// Postgres holds settings to clusterpedia-storage-postgres component of the clusterpeida.
	Postgres *Postgres `json:"postgres,omitempty"`
	//MySQL holds settings to clusterpedia-storage-mysql component of the clusterpeida.
	MySQL *MySQL `json:"mysql,omitempty"`
}

type ControllerManagerComponent struct {
	// KubeControllerManager holds settings to kube-controller-manager component of the karmada.
	KubeControllerManager KubeControllerManagerComponent `json:"kubeControllerManager,omitempty"`

	// KarmadaControllerManager holds settings to karmada-controller-manager component of the karmada.
	KarmadaControllerManager KarmadaControllerManagerComponent `json:"karmadaControllerManager,omitempty"`

	// FireflyKarmadaManager holds settings to firefly-karmada-manager component of the karmada.
	FireflyKarmadaManager FireflyKarmadaManagerComponent `json:"fireflyKarmadaManager,omitempty"`
}

type Etcd struct {
	// Local provides configuration knobs for configuring the built-in etcd instance
	// Local and External are mutually exclusive
	// +optional
	Local *LocalEtcd `json:"local,omitempty"`

	// External describes how to connect to an external etcd cluster
	// Local and External are mutually exclusive
	// +optional
	External *ExternalEtcd `json:"external,omitempty"`
}

type ExternalEtcd struct {
	// Endpoints of etcd members. Required for ExternalEtcd.
	Endpoints []string `json:"endpoints"`

	// CAData is an SSL Certificate Authority file used to secure etcd communication.
	// Required if using a TLS connection.
	CAData []byte `json:"caData"`

	// CertData is an SSL certification file used to secure etcd communication.
	// Required if using a TLS connection.
	CertData []byte `json:"certData"`

	// KeyData is an SSL key file used to secure etcd communication.
	// Required if using a TLS connection.
	KeyData []byte `json:"keyData"`
}

type FireflyKarmadaManagerComponent struct {
	// ImageMeta allows to customize the image used for the firefly-karmada-manager component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// A list of controllers to enable. '*' enables all on-by-default controllers,
	// 'foo' enables the controller named 'foo', '-foo' disables the controller named
	// 'foo'.
	//
	// All controllers: estimator, node
	// Disabled-by-default controllers:  (default [*])
	//
	// +optional
	Controllers []string `json:"controllers,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type ImageMeta struct {
	// ImageRepository sets the container registry to pull images from.
	// if not set, the ImageRepository defined in Spec will be used instead.
	// +optional
	ImageRepository string `json:"imageRepository,omitempty"`

	// ImageTag allows to specify a tag for the image.
	// In case this value is set, firefly does not change automatically the version
	// of the above components during upgrades.
	// +optional
	ImageTag string `json:"imageTag,omitempty"`

	// ImageName allows to specify a name for the image.
	// +optional
	ImageName string `json:"imageName,omitempty"`
}

type Karmada struct {
	metav1.TypeMeta `json:",inline"`
	// Standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// Specification of the desired behavior of the Karmada.
	// +optional
	Spec KarmadaSpec `json:"spec"`
	// Most recently observed status of the Karmada.
	// +optional
	Status KarmadaStatus `json:"status"`
}

type KarmadaAggregratedAPIServerComponent struct {
	// ImageMeta allows to customize the image used for the karmada-aggregated-apiserver component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-aggregated-apiserver component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// karmada-aggregated-apiserver component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/aggregated-apiserver/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KarmadaControllerManagerComponent struct {
	// ImageMeta allows to customize the image used for the karmada-controller-manager component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// A list of controllers to enable. '*' enables all on-by-default controllers,
	// 'foo' enables the controller named 'foo', '-foo' disables the controller named
	// 'foo'.
	//
	// All controllers: binding, cluster, clusterStatus, endpointSlice, execution,
	// federatedResourceQuotaStatus, federatedResourceQuotaSync, hpa, namespace,
	// serviceExport, serviceImport, unifiedAuth, workStatus.
	// Disabled-by-default controllers: hpa (default [*])
	// Actual Supported controllers depend on the version of Karmada. See
	// https://karmada.io/docs/administrator/configuration/configure-controllers#configure-karmada-controllers
	// for details.
	//
	// +optional
	Controllers []string `json:"controllers,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-controller-manager component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// karmada-controller-manager component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/controller-manager/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KarmadaDeschedulerComponent struct {
	// Enable indicates whether the karmada-descheduler conponent should be deployed.
	// This is a pointer to distinguish between explicit zero and not specified.
	// Defaults to false.
	// +optional
	Enable *bool `json:"enable,omitempty"`

	// ImageMeta allows to customize the image used for the karmada-descheduler component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-descheduler component or override.
	// A key in this map is the flag name as it appears on the command line except without
	// leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the karmada-descheduler
	// component. In the future, we will provide a more structured way to configure the component.
	// Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/descheduler/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KarmadaList struct {
	metav1.TypeMeta `json:",inline"`
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ListMeta `json:"metadata"`

	Items []Karmada `json:"items"`
}

type KarmadaSchedulerComponent struct {
	// ImageMeta allows to customize the image used for the karmada-scheduler component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-scheduler component or override.
	// A key in this map is the flag name as it appears on the command line except without
	// leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the karmada-scheduler
	// component. In the future, we will provide a more structured way to configure the component.
	// Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/scheduler/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KarmadaSchedulerEstimatorComponent struct {
	// ImageMeta allows to customize the image used for the karmada-scheduler-estimator component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-scheduler-estimator component or override.
	// A key in this map is the flag name as it appears on the command line except without
	// leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the karmada-scheduler-estimator
	// component. In the future, we will provide a more structured way to configure the component.
	// Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/scheduler-estimator/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KarmadaSpec struct {
	// Etcd holds configuration for etcd.
	// +optional
	Etcd Etcd `json:"etcd,omitempty"`

	// Networking holds configuration for the networking topology of the cluster.
	// +optional
	Networking Networking `json:"networking,omitempty"`

	// KubernetesVersion is the target version of the kube-apiserver component.
	// +optional
	KubernetesVersion string `json:"kubernetesVersion,omitempty"`

	// KarmadaVersion is the target version of the karmada.
	// +optional
	KarmadaVersion string `json:"karmadaVersion,omitempty"`

	// ControlPlaneEndpoint sets a stable IP address or DNS name for the control plane; it
	// can be a valid IP address or a RFC-1123 DNS subdomain, both with optional TCP port.
	// In case the ControlPlaneEndpoint is not specified, the AdvertiseAddress + BindPort
	// are used; in case the ControlPlaneEndpoint is specified but without a TCP port,
	// the BindPort is used.
	// Possible usages are:
	// e.g. In a cluster with more than one control plane instances, this field should be
	// assigned the address of the external load balancer in front of the
	// control plane instances.
	// e.g.  in environments with enforced node recycling, the ControlPlaneEndpoint
	// could be used for assigning a stable DNS to the control plane.
	// +optional
	ControlPlaneEndpoint string `json:"controlPlaneEndpoint,omitempty"`

	// APIServer contains extra settings for the API server control plane component
	// +optional
	APIServer APIServerComponent `json:"apiServer,omitempty"`

	// Webhook contains extra settings for the webhook component
	// +optional
	Webhook WebhookComponent `json:"webhook,omitempty"`

	// ControllerManager contains extra settings for the controller manager control plane component
	// +optional
	ControllerManager ControllerManagerComponent `json:"controllerManager,omitempty"`

	// Scheduler contains extra settings for the scheduler control plane component
	// +optional
	Scheduler SchedulerComponent `json:"scheduler,omitempty"`

	// ImageRepository sets the container registry to pull images from.
	// If empty, `swr.ap-southeast-1.myhuaweicloud.com/karmada` will be used by default.
	// +optional
	ImageRepository string `json:"imageRepository,omitempty"`

	// KubeImageRepository sets the container registry to pull kubernetes images from.
	// If empty, `registry.k8s.io` will be used by default.
	// field.
	// +optional
	KubeImageRepository string `json:"kubeImageRepository,omitempty"`

	// FireflyImageRepository sets the container registry to pull firelfy's images from.
	// If empty, `ghcr.io/firefly-io` will be used by default.
	// field.
	// +optional
	FireflyImageRepository string `json:"fireflyImageRepository,omitempty"`

	// FeatureGates enabled by the user.
	// If you don't know that a feature gate should be applied to which components, you can
	// use this field to enable or disable the feature gate for all the components of the karmada instance.
	// - Failover: https://karmada.io/docs/userguide/failover/#failover
	// - GracefulEviction: https://karmada.io/docs/userguide/failover/#graceful-eviction-feature
	// - PropagateDeps: https://karmada.io/docs/userguide/scheduling/propagate-dependencies
	// - CustomizedClusterResourceModeling: https://karmada.io/docs/userguide/scheduling/cluster-resources#start-to-use-cluster-resource-models
	// More info: https://github.com/karmada-io/karmada/blob/master/pkg/features/features.go
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type KarmadaStatus struct {
	// observedGeneration is the most recent generation observed for this Karmada. It corresponds to the
	// Karmada's generation, which is updated on mutation by the API Server.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Represents the latest available observations of a karmada's current state.
	// +patchMergeKey=type
	// +patchStrategy=merge
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type KarmadaWebhookComponent struct {
	// ImageMeta allows to customize the image used for the karmada-webhook component component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the karmada-webhook component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// karmada-webhook component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://github.com/karmada-io/karmada/blob/master/cmd/webhook/app/options/options.go
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`
}

type KubeAPIServerComponent struct {
	// ImageMeta allows to customize the image used for the kube-apiserver component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the kube-apiserver component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// kube-apiserver component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// CertSANs sets extra Subject Alternative Names for the API Server signing cert.
	// +optional
	CertSANs []string `json:"certSANs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// FeatureGates enabled by the user.
	// More info: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type KubeControllerManagerComponent struct {
	// ImageMeta allows to customize the image used for the karmada-scheduler component
	ImageMeta `json:",inline"`

	// Number of desired pods. This is a pointer to distinguish between explicit
	// zero and not specified. Defaults to 1.
	// +optional
	Replicas *int32 `json:"replicas,omitempty"`

	// A list of controllers to enable. '*' enables all on-by-default controllers,
	// 'foo' enables the controller named 'foo', '-foo' disables the controller named
	// 'foo'.
	//
	// All controllers: attachdetach, bootstrapsigner, cloud-node-lifecycle,
	// clusterrole-aggregation, cronjob, csrapproving, csrcleaner, csrsigning,
	// daemonset, deployment, disruption, endpoint, endpointslice,
	// endpointslicemirroring, ephemeral-volume, garbagecollector,
	// horizontalpodautoscaling, job, namespace, nodeipam, nodelifecycle,
	// persistentvolume-binder, persistentvolume-expander, podgc, pv-protection,
	// pvc-protection, replicaset, replicationcontroller, resourcequota,
	// root-ca-cert-publisher, route, service, serviceaccount, serviceaccount-token,
	// statefulset, tokencleaner, ttl, ttl-after-finished
	// Disabled-by-default controllers: bootstrapsigner, tokencleaner (default [*])
	// Actual Supported controllers depend on the version of Kubernetes. See
	// https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/
	// for details.
	//
	// However, Karmada uses Kubernetes Native API definitions for federated resource template,
	// so it doesn't need enable some resource related controllers like daemonset, deployment etc.
	// On the other hand, Karmada leverages the capabilities of the Kubernetes controller to
	// manage the lifecycle of the federated resource, so it needs to enable some controllers.
	// For example, the `namespace` controller is used to manage the lifecycle of the namespace
	// and the `garbagecollector` controller handles automatic clean-up of redundant items in
	// your karmada.
	//
	// According to the user feedback and karmada requirements, the following controllers are
	// enabled by default: namespace, garbagecollector, serviceaccount-token, ttl-after-finished,
	// bootstrapsigner,csrapproving,csrcleaner,csrsigning. See
	// https://karmada.io/docs/administrator/configuration/configure-controllers#kubernetes-controllers
	//
	// Others are disabled by default. If you want to enable or disable other controllers, you
	// have to explicitly specify all the controllers that kube-controller-manager shoud enable
	// at startup phase.
	// +optional
	Controllers []string `json:"controllers,omitempty"`

	// ExtraArgs is an extra set of flags to pass to the kube-controller-manager component or
	// override. A key in this map is the flag name as it appears on the command line except
	// without leading dash(es).
	//
	// Note: This is a temporary solution to allow for the configuration of the
	// kube-controller-manager component. In the future, we will provide a more structured way
	// to configure the component. Once that is done, this field will be discouraged to be used.
	// Incorrect settings on this feild maybe lead to the corresponding component in an unhealthy
	// state. Before you do it, please confirm that you understand the risks of this configuration.
	//
	// For supported flags, please see
	// https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/
	// for details.
	// +optional
	ExtraArgs map[string]string `json:"extraArgs,omitempty"`

	// Compute Resources required by this component.
	// More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// FeatureGates enabled by the user.
	// More info: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/
	// +optional
	FeatureGates map[string]bool `json:"featureGates,omitempty"`
}

type LocalEtcd struct {
	// ImageMeta allows to customize the container used for etcd
	ImageMeta `json:",inline"`

	// DataVolume is the volume etcd will place its data.
	// If empty, etcd will use an emptyDir.
	// +optional
	DataVolume *corev1.PersistentVolumeClaimTemplate `json:"dataVolume"`

	// ServerCertSANs sets extra Subject Alternative Names for the etcd server signing cert.
	// +optional
	ServerCertSANs []string `json:"serverCertSANs,omitempty"`

	// PeerCertSANs sets extra Subject Alternative Names for the etcd peer signing cert.
	// +optional
	PeerCertSANs []string `json:"peerCertSANs,omitempty"`
}

type LocalMySQL struct {
	// ImageMeta allows to customize the container used for mysql
	// If empty, `docker.io/library/mysql:8` will be used by default.
	ImageMeta `json:",inline"`
}

type LocalPostgres struct {
	// ImageMeta allows to customize the container used for postgres
	// If empty, `docker.io/library/postgres:10` will be used by default.
	ImageMeta `json:",inline"`
}

type MySQL struct {
	// Local provides configuration knobs for configuring the built-in mysql instance
	// Local and External are mutually exclusive
	// +optional
	Local *LocalPostgres `json:"local,omitempty"`
}

type Networking struct {
	// ServiceSubnet is the subnet used by k8s services. Defaults to "10.96.0.0/12".
	// +optional
	ServiceSubnet string `json:"serviceSubnet,omitempty"`

	// DNSDomain is the dns domain used by k8s services. Defaults to "cluster.local".
	// +optional
	DNSDomain string `json:"dnsDomain,omitempty"`
}

type Postgres struct {
	// Local provides configuration knobs for configuring the built-in postgres instance
	// Local and External are mutually exclusive
	// +optional
	Local *LocalPostgres `json:"local,omitempty"`
}

type SchedulerComponent struct {
	// KarmadaScheduler holds settings to karmada-scheduler conponent of the karmada.
	// +optional
	KarmadaScheduler KarmadaSchedulerComponent `json:"karmadaScheduler,omitempty"`

	// KarmadaScheduler holds settings to karmada-descheduler conponent of the karmada.
	// +optional
	KarmadaDescheduler KarmadaDeschedulerComponent `json:"karmadaDescheduler,omitempty"`

	// KarmadaSchedulerEstimator holds settings to karmada-scheduler-estimator conponent of the karmada.
	// +optional
	KarmadaSchedulerEstimator KarmadaSchedulerEstimatorComponent `json:"karmadaSchedulerEstimator,omitempty"`
}

type WebhookComponent struct {
	// KarmadaWebhook holds settings to karmada-webook component of the karmada.
	KarmadaWebhook KarmadaWebhookComponent `json:"karmadaWebhook,omitempty"`
	// FireflyKarmadaWebhook holds settings to firefly-karmada-webook component of the karmada.
	FireflyKarmadaWebhook KarmadaWebhookComponent `json:"fireflyKarmadaWebhook,omitempty"`
}