v1beta1

type Auth struct {
	// User is the username for SSH authentication.
	// +optional
	User string `yaml:"user,omitempty" json:"user,omitempty"`

	// Password is the password for SSH authentication.
	// +optional
	Password string `yaml:"password,omitempty" json:"password,omitempty"`

	// Port is the port for SSH authentication.
	// +optional
	Port *int `yaml:"port,omitempty" json:"port,omitempty"`

	// PrivateKey is the value of the private key for SSH authentication.
	// +optional
	PrivateKey string `yaml:"privateKey,omitempty" json:"privateKey,omitempty"`

	// PrivateKeyFile is the path to the private key for SSH authentication.
	// +optional
	PrivateKeyPath string `yaml:"privateKeyPath,omitempty" json:"privateKeyPath,omitempty"`

	// Secret is the secret of the PrivateKey or Password for SSH authentication.It should in the same namespace as capkk.
	// When Password is empty, replace it with data.password.
	// When PrivateKey is empty, replace it with data.privateKey
	// +optional
	Secret string `yaml:"secret,omitempty" json:"secret,omitempty"`

	// Timeout is the timeout for establish an SSH connection.
	// +optional
	Timeout *time.Duration `yaml:"timeout,omitempty" json:"timeout,omitempty"`
}

type Checksum struct {
	// Value is the checksum string value.
	// +optional
	Value string `json:"value,omitempty"`

	// Path defines the URL path, which is the path of the checksum file.
	// +optional
	Path string `json:"path,omitempty"`
}

type Component struct {
	// ZONE is the zone of the KKCluster where can get the binaries.
	// If you have problem to access https://storage.googleapis.com, you can set "zone: cn".
	// +optional
	ZONE string `json:"zone,omitempty"`

	// Host is the host to download the binaries.
	// +optional
	Host string `json:"host,omitempty"`

	// Overrides is a list of components download information that need to be overridden.
	// +optional
	Overrides []Override `json:"overrides,omitempty"`
}

type ContainerManager struct {
	// CRISocket is used to connect an existing CRIClient.
	// +optional
	CRISocket string `json:"criSocket,omitempty"`

	// Type defines the type of ContainerManager.
	// "docker", "containerd"
	Type string `json:"type,omitempty"`

	// Version defines the version of ContainerManager.
	Version string `json:"version,omitempty"`

	// CRICTLVersion defines the version of CRICTL.
	CRICTLVersion string `json:"crictlVersion,omitempty"`

	// CRIDockerdVersion defines the version of cri-dockerd, available only when Type is docker.
	// https://github.com/Mirantis/cri-dockerd
	// +optional
	CRIDockerdVersion string `json:"criDockerdVersion,omitempty"`
}

type InstanceInfo struct {
	// Name is the host name of the machine.
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name,omitempty"`

	// Address is the IP address of the machine.
	Address string `json:"address,omitempty"`

	// InternalAddress is the internal IP address of the machine.
	InternalAddress string `json:"internalAddress,omitempty"`

	// Roles is the role of the machine.
	// +optional
	Roles []Role `json:"roles,omitempty"`

	// Arch is the architecture of the machine. e.g. "amd64", "arm64".
	// +optional
	Arch string `json:"arch,omitempty"`

	// Auth is the SSH authentication information of this machine. It will override the global auth configuration.
	// +optional
	Auth Auth `json:"auth,omitempty"`
}

type InstanceState string

type KKCluster struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   KKClusterSpec   `json:"spec,omitempty"`
	Status KKClusterStatus `json:"status,omitempty"`
}

type KKClusterList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []KKCluster `json:"items"`
}

type KKClusterSpec struct {
	// Distribution represents the Kubernetes distribution type of the cluster.
	Distribution string `json:"distribution,omitempty"`

	// Nodes represents the information about the nodes available to the cluster
	Nodes Nodes `json:"nodes"`

	// ControlPlaneEndpoint represents the endpoint used to communicate with the control plane.
	// +optional
	ControlPlaneEndpoint clusterv1.APIEndpoint `json:"controlPlaneEndpoint"`

	// ControlPlaneLoadBalancer is optional configuration for customizing control plane behavior.
	ControlPlaneLoadBalancer *KKLoadBalancerSpec `json:"controlPlaneLoadBalancer,omitempty"`

	// Component is optional configuration for modifying the FTP server
	// that gets the necessary components for the cluster.
	// +optional
	Component *Component `json:"component,omitempty"`

	// Registry represents the cluster image registry used to pull the images.
	// +optional
	Registry Registry `json:"registry,omitempty"`
}

type KKClusterStatus struct {
	// +kubebuilder:default=false
	Ready bool `json:"ready"`
	// FailureReason will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a succinct value suitable
	// for machine interpretation.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureReason *errors.MachineStatusError `json:"failureReason,omitempty"`

	// FailureMessage will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a more verbose string suitable
	// for logging and human consumption.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureMessage *string `json:"failureMessage,omitempty"`

	// Conditions defines current service state of the KKMachine.
	// +optional
	Conditions clusterv1.Conditions `json:"conditions,omitempty"`
}

type KKClusterTemplate struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec KKClusterTemplateSpec `json:"spec,omitempty"`
}

type KKClusterTemplateList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []KKClusterTemplate `json:"items"`
}

type KKClusterTemplateResource struct {
	// Standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	ObjectMeta clusterv1.ObjectMeta `json:"metadata,omitempty"`
	Spec       KKClusterSpec        `json:"spec"`
}

type KKClusterTemplateSpec struct {
	Template KKClusterTemplateResource `json:"template"`
}

type KKInstance struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   KKInstanceSpec   `json:"spec,omitempty"`
	Status KKInstanceStatus `json:"status,omitempty"`
}

type KKInstanceList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []KKInstance `json:"items"`
}

type KKInstanceSpec struct {
	// Name is the host name of the machine.
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name,omitempty"`

	// Address is the IP address of the machine.
	Address string `json:"address,omitempty"`

	// InternalAddress is the internal IP address of the machine.
	InternalAddress string `json:"internalAddress,omitempty"`

	// Roles is the role of the machine.
	// +optional
	Roles []Role `json:"roles,omitempty"`

	// Arch is the architecture of the machine. e.g. "amd64", "arm64".
	// +optional
	Arch string `json:"arch,omitempty"`

	// Auth is the SSH authentication information of this machine. It will override the global auth configuration.
	// +optional
	Auth Auth `json:"auth,omitempty"`

	// ContainerManager is the container manager config of this machine.
	// +optional
	ContainerManager ContainerManager `json:"containerManager,omitempty"`

	// Repository is the repository config of this machine.
	// +optional
	Repository *Repository `json:"repository,omitempty"`
}

type KKInstanceStatus struct {
	// The current state of the instance.
	State InstanceState `json:"instanceState,omitempty"`

	// NodeRef will point to the corresponding Node if it exists.
	// +optional
	NodeRef *corev1.ObjectReference `json:"nodeRef,omitempty"`

	// NodeInfo is a set of ids/uuids to uniquely identify the node.
	// More info: https://kubernetes.io/docs/concepts/nodes/node/#info
	// +optional
	NodeInfo *corev1.NodeSystemInfo `json:"nodeInfo,omitempty"`

	// FailureReason will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a succinct value suitable
	// for machine interpretation.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureReason *errors.MachineStatusError `json:"failureReason,omitempty"`

	// FailureMessage will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a more verbose string suitable
	// for logging and human consumption.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureMessage *string `json:"failureMessage,omitempty"`

	// Conditions defines current service state of the KKMachine.
	// +optional
	Conditions clusterv1.Conditions `json:"conditions,omitempty"`
}

type KKLoadBalancerSpec struct {
	// The hostname on which the API server is serving.
	Host string `json:"host,omitempty"`
}

type KKMachine struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   KKMachineSpec   `json:"spec,omitempty"`
	Status KKMachineStatus `json:"status,omitempty"`
}

type KKMachineList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []KKMachine `json:"items"`
}

type KKMachineSpec struct {
	// ProviderID is the unique identifier as specified by the kubekey provider.
	ProviderID *string `json:"providerID,omitempty"`

	// InstanceID is the name of the KKInstance.
	InstanceID *string `json:"instanceID,omitempty"`

	// Roles is the role of the machine.
	// +optional
	Roles []Role `json:"roles"`

	// ContainerManager is the container manager config of this machine.
	// +optional
	ContainerManager ContainerManager `json:"containerManager"`

	// Repository is the repository config of this machine.
	// +optional
	Repository *Repository `json:"repository,omitempty"`
}

type KKMachineStatus struct {
	// Ready is true when the provider resource is ready.
	// +optional
	Ready bool `json:"ready"`

	// Addresses contains the KK instance associated addresses.
	Addresses []clusterv1.MachineAddress `json:"addresses,omitempty"`

	// InstanceState is the state of the KK instance for this machine.
	// +optional
	InstanceState *InstanceState `json:"instanceState,omitempty"`

	// FailureReason will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a succinct value suitable
	// for machine interpretation.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureReason *errors.MachineStatusError `json:"failureReason,omitempty"`

	// FailureMessage will be set in the event that there is a terminal problem
	// reconciling the Machine and will contain a more verbose string suitable
	// for logging and human consumption.
	//
	// This field should not be set for transitive errors that a controller
	// faces that are expected to be fixed automatically over
	// time (like service outages), but instead indicate that something is
	// fundamentally wrong with the Machine's spec or the configuration of
	// the controller, and that manual intervention is required. Examples
	// of terminal errors would be invalid combinations of settings in the
	// spec, values that are unsupported by the controller, or the
	// responsible controller itself being critically misconfigured.
	//
	// Any transient errors that occur during the reconciliation of Machines
	// can be added as events to the Machine object and/or logged in the
	// controller's output.
	// +optional
	FailureMessage *string `json:"failureMessage,omitempty"`

	// Conditions defines current service state of the KKMachine.
	// +optional
	Conditions clusterv1.Conditions `json:"conditions,omitempty"`
}

type KKMachineTemplate struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   KKMachineTemplateSpec   `json:"spec,omitempty"`
	Status KKMachineTemplateStatus `json:"status,omitempty"`
}

type KKMachineTemplateList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []KKMachineTemplate `json:"items"`
}

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

	// Spec is the specification of the desired behavior of the machine.
	Spec KKMachineSpec `json:"spec"`
}

type KKMachineTemplateSpec struct {
	Template KKMachineTemplateResource `json:"template"`
}

type KKMachineTemplateStatus struct {
	// Capacity defines the resource capacity for this machine.
	// This value is used for autoscaling from zero operations as defined in:
	// https://github.com/kubernetes-sigs/cluster-api/blob/main/docs/proposals/20210310-opt-in-autoscaling-from-zero.md
	// +optional
	Capacity corev1.ResourceList `json:"capacity,omitempty"`
}

type Nodes struct {
	// Auth is the SSH authentication information of all instance. It is a global auth configuration.
	// +optional
	Auth Auth `json:"auth"`

	// Instances defines all instance contained in kkcluster.
	Instances []InstanceInfo `json:"instances"`
}

type Override struct {
	// ID is the component id name. e.g. kubeadm, kubelet, containerd, etc.
	ID string `json:"id,omitempty"`

	// Arch is the component arch. e.g. amd64, arm64, etc.
	Arch string `json:"arch,omitempty"`

	// Version is the component version. e.g. v1.21.1, v1.22.0, etc.
	Version string `json:"version,omitempty"`

	// URL is the download url of the binaries.
	URL string `json:"url,omitempty"`

	// Path defines the URL path, which is the string of information that comes after the top level domain name.
	Path string `json:"path,omitempty"`

	// Checksum is the SHA256 checksum of the binary.
	// +optional
	Checksum Checksum `json:"checksum,omitempty"`
}

type Registry struct {
	metav1.TypeMeta `json:",inline"`

	// PrivateRegistry defines the private registry address of ContainerManager.
	PrivateRegistry string `json:"privateRegistry"`

	// InsecureRegistries defines the insecure registries of ContainerManager.
	InsecureRegistries []string `json:"insecureRegistries,omitempty"`

	// RegistryMirrors defines the registry mirrors of this PrivateRegistry.
	RegistryMirrors []string `json:"registryMirrors,omitempty"`

	// NamespaceOverride defines the namespace override of this PrivateRegistry.
	NamespaceOverride string `json:"namespaceOverride"`

	// Auth defines the auth of this PrivateRegistry.
	Auth RegistryAuth `json:"auth"`
}

type RegistryAuth struct {
	// Username defines the username of this PrivateRegistry.
	Username string `json:"username"`

	// Password defines the password of this PrivateRegistry.
	Password string `json:"password"`

	// InsecureSkipVerify allow contacting this PrivateRegistry over HTTPS with failed TLS verification.
	InsecureSkipVerify bool `json:"insecureSkipVerify"`

	// PlainHTTP allow contacting this PrivateRegistry over HTTP.
	PlainHTTP bool `json:"plainHTTP"`

	// CertsPath defines the path of the certs files of this PrivateRegistry.
	CertsPath string `json:"certsPath"`

	// CAFile is an SSL Certificate Authority file used to secure etcd communication.
	CAFile string `yaml:"caFile" json:"caFile,omitempty"`
	// CertFile is an SSL certification file used to secure etcd communication.
	CertFile string `yaml:"certFile" json:"certFile,omitempty"`
	// KeyFile is an SSL key file used to secure etcd communication.
	KeyFile string `yaml:"keyFile" json:"keyFile,omitempty"`
}

type Repository struct {
	// ISO specifies the ISO file name. There are 3 options:
	// "": empty string means will not install the packages.
	// "none": no ISO file will be used. And capkk will use the default repository to install the required packages.
	// "auto": capkk will detect the ISO file automatically. Only support Ubuntu/Debian/CentOS.
	// "xxx-20.04-debs-amd64.iso": use the specified name to get the ISO file name.
	// +optional
	ISO string `json:"iso,omitempty"`

	// Update will update the repository packages list and cache if it is true.
	// +optional
	Update bool `json:"update,omitempty"`

	// Packages is a list of packages to be installed.
	// +optional
	Packages []string `json:"packages,omitempty"`
}

type Role string