From 6d2ae6b2e65ab1b4f52bd57bbae10b0d046e4280 Mon Sep 17 00:00:00 2001 From: LavredisG Date: Mon, 14 Oct 2024 03:43:05 +0300 Subject: [PATCH] Update cluster/types.go and cluster/v1alpha1/types.go Signed-off-by: LavredisG --- api/openapi-spec/swagger.json | 28 +++++------ pkg/apis/cluster/types.go | 46 +++++++++---------- pkg/apis/cluster/v1alpha1/types.go | 46 +++++++++---------- pkg/generated/openapi/zz_generated.openapi.go | 28 +++++------ 4 files changed, 74 insertions(+), 74 deletions(-) diff --git a/api/openapi-spec/swagger.json b/api/openapi-spec/swagger.json index 1ecebf2fb3d2..10e323615e76 100644 --- a/api/openapi-spec/swagger.json +++ b/api/openapi-spec/swagger.json @@ -17253,7 +17253,7 @@ } }, "com.github.karmada-io.karmada.pkg.apis.cluster.v1alpha1.Cluster": { - "description": "Cluster represents the desire state and status of a member cluster.", + "description": "Cluster represents the desired state and status of a member cluster.", "type": "object", "required": [ "spec" @@ -17291,7 +17291,7 @@ ] }, "com.github.karmada-io.karmada.pkg.apis.cluster.v1alpha1.ClusterList": { - "description": "ClusterList contains a list of member cluster", + "description": "ClusterList contains a list of member clusters", "type": "object", "required": [ "items" @@ -17338,11 +17338,11 @@ "type": "string" }, "id": { - "description": "ID is the unique identifier for the cluster. It is different from the object uid(.metadata.uid) and typically collected automatically from member cluster during the progress of registration.\n\nThe value is collected in order: 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by\n creating a ClusterProperty object with name 'cluster.clusterset.k8s.io', Karmada would\n take the defined value in the ClusterProperty object.\n See https://github.com/kubernetes-sigs/about-api for more details about ClusterProperty API.\n2. Take the uid of 'kube-system' namespace on the registering cluster.\n\nPlease don't update this value unless you know what you are doing, because it will/may be used to : - uniquely identify the clusters within the Karmada system. - compose the DNS name of multi-cluster services.", + "description": "ID is the unique identifier for the cluster. It is different from the object uid(.metadata.uid) and is typically collected automatically from each member cluster during the process of registration.\n\nThe value is collected in order: 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by\n creating a ClusterProperty object with name 'cluster.clusterset.k8s.io', Karmada would\n take the defined value in the ClusterProperty object.\n See https://github.com/kubernetes-sigs/about-api for more details about ClusterProperty API.\n2. Take the uid of 'kube-system' namespace on the registering cluster.\n\nPlease don't update this value unless you know what you are doing, because it will/may be used to : - uniquely identify the clusters within the Karmada system. - compose the DNS name of multi-cluster services.", "type": "string" }, "impersonatorSecretRef": { - "description": "ImpersonatorSecretRef represents the secret contains the token of impersonator. The secret should hold credentials as follows: - secret.data.token", + "description": "ImpersonatorSecretRef represents the secret that contains the token of impersonator. The secret should hold credentials as follows: - secret.data.token", "$ref": "#/definitions/com.github.karmada-io.karmada.pkg.apis.cluster.v1alpha1.LocalSecretReference" }, "insecureSkipTLSVerification": { @@ -17354,7 +17354,7 @@ "type": "string" }, "proxyHeader": { - "description": "ProxyHeader is the HTTP header required by proxy server. The key in the key-value pair is HTTP header key and value is the associated header payloads. For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3').", + "description": "ProxyHeader is the HTTP header required by proxy server. The key in the key-value pair is HTTP header key and the value is the associated header payloads. For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3').", "type": "object", "additionalProperties": { "type": "string", @@ -17362,11 +17362,11 @@ } }, "proxyURL": { - "description": "ProxyURL is the proxy URL for the cluster. If not empty, the karmada control plane will use this proxy to talk to the cluster. More details please refer to: https://github.com/kubernetes/client-go/issues/351", + "description": "ProxyURL is the proxy URL for the cluster. If not empty, the karmada control plane will use this proxy to talk to the cluster. For more details please refer to: https://github.com/kubernetes/client-go/issues/351", "type": "string" }, "region": { - "description": "Region represents the region of the member cluster locate in.", + "description": "Region represents the region in which the member cluster is located.", "type": "string" }, "resourceModels": { @@ -17378,16 +17378,16 @@ } }, "secretRef": { - "description": "SecretRef represents the secret contains mandatory credentials to access the member cluster. The secret should hold credentials as follows: - secret.data.token - secret.data.caBundle", + "description": "SecretRef represents the secret that contains mandatory credentials to access the member cluster. The secret should hold credentials as follows: - secret.data.token - secret.data.caBundle", "$ref": "#/definitions/com.github.karmada-io.karmada.pkg.apis.cluster.v1alpha1.LocalSecretReference" }, "syncMode": { - "description": "SyncMode describes how a cluster sync resources from karmada control plane.", + "description": "SyncMode describes how a cluster syncs resources from karmada control plane.", "type": "string", "default": "" }, "taints": { - "description": "Taints attached to the member cluster. Taints on the cluster have the \"effect\" on any resource that does not tolerate the Taint.", + "description": "Taints are attached to the member cluster. Taints on the cluster have the \"effect\" on any resource that does not tolerate the Taint.", "type": "array", "items": { "default": {}, @@ -17395,7 +17395,7 @@ } }, "zone": { - "description": "Zone represents the zone of the member cluster locate in. Deprecated: This filed was never been used by Karmada, and it will not be removed from v1alpha1 for backward compatibility, use Zones instead.", + "description": "Zone represents the zone in which the member cluster is located. Deprecated: This field was never been used by Karmada, and it will not be removed from v1alpha1 for backward compatibility, use Zones instead.", "type": "string" }, "zones": { @@ -17413,7 +17413,7 @@ "type": "object", "properties": { "apiEnablements": { - "description": "APIEnablements represents the list of APIs installed in the member cluster.", + "description": "APIEnablements represents the list of APIs installed on the member cluster.", "type": "array", "items": { "default": {}, @@ -17459,7 +17459,7 @@ ], "properties": { "name": { - "description": "Name is the name of resource being referenced.", + "description": "Name is the name of the resource being referenced.", "type": "string", "default": "" }, @@ -17511,7 +17511,7 @@ } }, "com.github.karmada-io.karmada.pkg.apis.cluster.v1alpha1.ResourceModelRange": { - "description": "ResourceModelRange describes the detail of each modeling quota that ranges from min to max. Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. E.g. in an interval, min = 2, max =10 is set, which means the interval [2,10). This rule ensure that all intervals have the same meaning. If the last interval is infinite, it is definitely unreachable. Therefore, we define the right interval as the open interval. For a valid interval, the value on the right is greater than the value on the left, in other words, max must be greater than min. It is strongly recommended that the [Min, Max) of all ResourceModelRanges can make a continuous interval.", + "description": "ResourceModelRange describes the detail of each modeling quota that ranges from min to max. Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. E.g. in an interval, min = 2, max = 10 is set, which means the interval [2,10). This rule ensures that all intervals have the same meaning. If the last interval is infinite, it is definitely unreachable. Therefore, we define the right interval as the open interval. For a valid interval, the value on the right is greater than the value on the left, in other words, max must be greater than min. It is strongly recommended that the [Min, Max) of all ResourceModelRanges can make a continuous interval.", "type": "object", "required": [ "name", diff --git a/pkg/apis/cluster/types.go b/pkg/apis/cluster/types.go index f7f8aea3df97..189eca77772e 100644 --- a/pkg/apis/cluster/types.go +++ b/pkg/apis/cluster/types.go @@ -28,7 +28,7 @@ import ( // +genclient:nonNamespaced // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object -// Cluster represents the desire state and status of a member cluster. +// Cluster represents the desired state and status of a member cluster. type Cluster struct { metav1.TypeMeta metav1.ObjectMeta @@ -44,8 +44,8 @@ type Cluster struct { // ClusterSpec defines the desired state of a member cluster. type ClusterSpec struct { // ID is the unique identifier for the cluster. - // It is different from the object uid(.metadata.uid) and typically collected automatically - // from member cluster during the progress of registration. + // It is different from the object uid(.metadata.uid) and is typically collected automatically + // from each member cluster during the process of registration. // // The value is collected in order: // 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by @@ -63,7 +63,7 @@ type ClusterSpec struct { // +kubebuilder:validation:Maxlength=128000 ID string `json:"id,omitempty"` - // SyncMode describes how a cluster sync resources from karmada control plane. + // SyncMode describes how a cluster syncs resources from karmada control plane. // +required SyncMode ClusterSyncMode @@ -72,14 +72,14 @@ type ClusterSpec struct { // +optional APIEndpoint string - // SecretRef represents the secret contains mandatory credentials to access the member cluster. + // SecretRef represents the secret that contains mandatory credentials to access the member cluster. // The secret should hold credentials as follows: // - secret.data.token // - secret.data.caBundle // +optional SecretRef *LocalSecretReference - // ImpersonatorSecretRef represents the secret contains the token of impersonator. + // ImpersonatorSecretRef represents the secret that contains the token of impersonator. // The secret should hold credentials as follows: // - secret.data.token // +optional @@ -94,12 +94,12 @@ type ClusterSpec struct { // ProxyURL is the proxy URL for the cluster. // If not empty, the karmada control plane will use this proxy to talk to the cluster. - // More details please refer to: https://github.com/kubernetes/client-go/issues/351 + // For more details please refer to: https://github.com/kubernetes/client-go/issues/351 // +optional ProxyURL string // ProxyHeader is the HTTP header required by proxy server. - // The key in the key-value pair is HTTP header key and value is the associated header payloads. + // The key in the key-value pair is HTTP header key and the value is the associated header payloads. // For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3'). // +optional ProxyHeader map[string]string @@ -108,12 +108,12 @@ type ClusterSpec struct { // +optional Provider string - // Region represents the region of the member cluster locate in. + // Region represents the region in which the member cluster is located. // +optional Region string - // Zone represents the zone of the member cluster locate in. - // Deprecated: This filed was never been used by Karmada, and it will not be + // Zone represents the zone in which the member cluster is located. + // Deprecated: This field was never used by Karmada, and it will not be // removed from v1alpha1 for backward compatibility, use Zones instead. // +optional Zone string @@ -126,7 +126,7 @@ type ClusterSpec struct { // +optional Zones []string `json:"zones,omitempty"` - // Taints attached to the member cluster. + // Taints are attached to the member cluster. // Taints on the cluster have the "effect" on // any resource that does not tolerate the Taint. // +optional @@ -204,8 +204,8 @@ type ResourceModel struct { // ResourceModelRange describes the detail of each modeling quota that ranges from min to max. // Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. -// E.g. in an interval, min = 2, max =10 is set, which means the interval [2,10). -// This rule ensure that all intervals have the same meaning. If the last interval is infinite, +// E.g. in an interval, min = 2, max = 10 is set, which means the interval [2,10). +// This rule ensures that all intervals have the same meaning. If the last interval is infinite, // it is definitely unreachable. Therefore, we define the right interval as the open interval. // For a valid interval, the value on the right is greater than the value on the left, // in other words, max must be greater than min. @@ -242,13 +242,13 @@ const ( type ClusterSyncMode string const ( - // Push means that the controller on the karmada control plane will in charge of synchronization. - // The controller watches resources change on karmada control plane then pushes them to member cluster. + // Push means that the controller on the karmada control plane will be in charge of synchronization. + // The controller watches resources change on karmada control plane and then pushes them to member cluster. Push ClusterSyncMode = "Push" - // Pull means that the controller running on the member cluster will in charge of synchronization. - // The controller, as well known as 'agent', watches resources change on karmada control plane then fetches them - // and applies locally on the member cluster. + // Pull means that the controller running on the member cluster will be in charge of synchronization. + // The controller, also known as 'agent', watches resources change on karmada control plane, then fetches them + // and applies them locally on the member cluster. Pull ClusterSyncMode = "Pull" ) @@ -258,7 +258,7 @@ type LocalSecretReference struct { // Namespace is the namespace for the resource being referenced. Namespace string - // Name is the name of resource being referenced. + // Name is the name of the resource being referenced. Name string } @@ -267,7 +267,7 @@ const ( // ClusterConditionReady means the cluster is healthy and ready to accept workloads. ClusterConditionReady = "Ready" - // ClusterConditionCompleteAPIEnablements indicates whether the cluster's API enablements(.status.apiEnablements) is complete. + // ClusterConditionCompleteAPIEnablements indicates whether the cluster's API enablements(.status.apiEnablements) are complete. ClusterConditionCompleteAPIEnablements = "CompleteAPIEnablements" ) @@ -278,7 +278,7 @@ type ClusterStatus struct { // +optional KubernetesVersion string - // APIEnablements represents the list of APIs installed in the member cluster. + // APIEnablements represents the list of APIs installed on the member cluster. // +optional APIEnablements []APIEnablement @@ -369,7 +369,7 @@ type AllocatableModeling struct { // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object -// ClusterList contains a list of member cluster +// ClusterList contains a list of member clusters type ClusterList struct { metav1.TypeMeta metav1.ListMeta diff --git a/pkg/apis/cluster/v1alpha1/types.go b/pkg/apis/cluster/v1alpha1/types.go index fe56dca7da94..8a06b94fe040 100644 --- a/pkg/apis/cluster/v1alpha1/types.go +++ b/pkg/apis/cluster/v1alpha1/types.go @@ -39,7 +39,7 @@ const ( // +kubebuilder:resource:scope="Cluster" // +kubebuilder:subresource:status -// Cluster represents the desire state and status of a member cluster. +// Cluster represents the desired state and status of a member cluster. type Cluster struct { metav1.TypeMeta `json:",inline"` metav1.ObjectMeta `json:"metadata,omitempty"` @@ -55,8 +55,8 @@ type Cluster struct { // ClusterSpec defines the desired state of a member cluster. type ClusterSpec struct { // ID is the unique identifier for the cluster. - // It is different from the object uid(.metadata.uid) and typically collected automatically - // from member cluster during the progress of registration. + // It is different from the object uid(.metadata.uid) and is typically collected automatically + // from each member cluster during the process of registration. // // The value is collected in order: // 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by @@ -74,7 +74,7 @@ type ClusterSpec struct { // +kubebuilder:validation:Maxlength=128000 ID string `json:"id,omitempty"` - // SyncMode describes how a cluster sync resources from karmada control plane. + // SyncMode describes how a cluster syncs resources from karmada control plane. // +kubebuilder:validation:Enum=Push;Pull // +required SyncMode ClusterSyncMode `json:"syncMode"` @@ -84,14 +84,14 @@ type ClusterSpec struct { // +optional APIEndpoint string `json:"apiEndpoint,omitempty"` - // SecretRef represents the secret contains mandatory credentials to access the member cluster. + // SecretRef represents the secret that contains mandatory credentials to access the member cluster. // The secret should hold credentials as follows: // - secret.data.token // - secret.data.caBundle // +optional SecretRef *LocalSecretReference `json:"secretRef,omitempty"` - // ImpersonatorSecretRef represents the secret contains the token of impersonator. + // ImpersonatorSecretRef represents the secret that contains the token of impersonator. // The secret should hold credentials as follows: // - secret.data.token // +optional @@ -106,12 +106,12 @@ type ClusterSpec struct { // ProxyURL is the proxy URL for the cluster. // If not empty, the karmada control plane will use this proxy to talk to the cluster. - // More details please refer to: https://github.com/kubernetes/client-go/issues/351 + // For more details please refer to: https://github.com/kubernetes/client-go/issues/351 // +optional ProxyURL string `json:"proxyURL,omitempty"` // ProxyHeader is the HTTP header required by proxy server. - // The key in the key-value pair is HTTP header key and value is the associated header payloads. + // The key in the key-value pair is HTTP header key and the value is the associated header payloads. // For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3'). // +optional ProxyHeader map[string]string `json:"proxyHeader,omitempty"` @@ -120,12 +120,12 @@ type ClusterSpec struct { // +optional Provider string `json:"provider,omitempty"` - // Region represents the region of the member cluster locate in. + // Region represents the region in which the member cluster is located. // +optional Region string `json:"region,omitempty"` - // Zone represents the zone of the member cluster locate in. - // Deprecated: This filed was never been used by Karmada, and it will not be + // Zone represents the zone in which the member cluster is located. + // Deprecated: This field was never been used by Karmada, and it will not be // removed from v1alpha1 for backward compatibility, use Zones instead. // +optional Zone string `json:"zone,omitempty"` @@ -138,7 +138,7 @@ type ClusterSpec struct { // +optional Zones []string `json:"zones,omitempty"` - // Taints attached to the member cluster. + // Taints are attached to the member cluster. // Taints on the cluster have the "effect" on // any resource that does not tolerate the Taint. // +optional @@ -216,8 +216,8 @@ type ResourceModel struct { // ResourceModelRange describes the detail of each modeling quota that ranges from min to max. // Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. -// E.g. in an interval, min = 2, max =10 is set, which means the interval [2,10). -// This rule ensure that all intervals have the same meaning. If the last interval is infinite, +// E.g. in an interval, min = 2, max = 10 is set, which means the interval [2,10). +// This rule ensures that all intervals have the same meaning. If the last interval is infinite, // it is definitely unreachable. Therefore, we define the right interval as the open interval. // For a valid interval, the value on the right is greater than the value on the left, // in other words, max must be greater than min. @@ -254,13 +254,13 @@ const ( type ClusterSyncMode string const ( - // Push means that the controller on the karmada control plane will in charge of synchronization. - // The controller watches resources change on karmada control plane then pushes them to member cluster. + // Push means that the controller on the karmada control plane will be in charge of synchronization. + // The controller watches resources change on karmada control plane and then pushes them to member cluster. Push ClusterSyncMode = "Push" - // Pull means that the controller running on the member cluster will in charge of synchronization. - // The controller, as well known as 'agent', watches resources change on karmada control plane then fetches them - // and applies locally on the member cluster. + // Pull means that the controller running on the member cluster will be in charge of synchronization. + // The controller, also known as 'agent', watches resources change on karmada control plane, then fetches them + // and applies them locally on the member cluster. Pull ClusterSyncMode = "Pull" ) @@ -270,7 +270,7 @@ type LocalSecretReference struct { // Namespace is the namespace for the resource being referenced. Namespace string `json:"namespace"` - // Name is the name of resource being referenced. + // Name is the name of the resource being referenced. Name string `json:"name"` } @@ -279,7 +279,7 @@ const ( // ClusterConditionReady means the cluster is healthy and ready to accept workloads. ClusterConditionReady = "Ready" - // ClusterConditionCompleteAPIEnablements indicates whether the cluster's API enablements(.status.apiEnablements) is complete. + // ClusterConditionCompleteAPIEnablements indicates whether the cluster's API enablements(.status.apiEnablements) are complete. ClusterConditionCompleteAPIEnablements = "CompleteAPIEnablements" ) @@ -290,7 +290,7 @@ type ClusterStatus struct { // +optional KubernetesVersion string `json:"kubernetesVersion,omitempty"` - // APIEnablements represents the list of APIs installed in the member cluster. + // APIEnablements represents the list of APIs installed on the member cluster. // +optional APIEnablements []APIEnablement `json:"apiEnablements,omitempty"` @@ -378,7 +378,7 @@ type AllocatableModeling struct { // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object -// ClusterList contains a list of member cluster +// ClusterList contains a list of member clusters type ClusterList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata,omitempty"` diff --git a/pkg/generated/openapi/zz_generated.openapi.go b/pkg/generated/openapi/zz_generated.openapi.go index 9c2ddb9b29fc..6670f575d362 100644 --- a/pkg/generated/openapi/zz_generated.openapi.go +++ b/pkg/generated/openapi/zz_generated.openapi.go @@ -1493,7 +1493,7 @@ func schema_pkg_apis_cluster_v1alpha1_Cluster(ref common.ReferenceCallback) comm return common.OpenAPIDefinition{ Schema: spec.Schema{ SchemaProps: spec.SchemaProps{ - Description: "Cluster represents the desire state and status of a member cluster.", + Description: "Cluster represents the desired state and status of a member cluster.", Type: []string{"object"}, Properties: map[string]spec.Schema{ "kind": { @@ -1543,7 +1543,7 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterList(ref common.ReferenceCallback) return common.OpenAPIDefinition{ Schema: spec.Schema{ SchemaProps: spec.SchemaProps{ - Description: "ClusterList contains a list of member cluster", + Description: "ClusterList contains a list of member clusters", Type: []string{"object"}, Properties: map[string]spec.Schema{ "kind": { @@ -1632,14 +1632,14 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterSpec(ref common.ReferenceCallback) Properties: map[string]spec.Schema{ "id": { SchemaProps: spec.SchemaProps{ - Description: "ID is the unique identifier for the cluster. It is different from the object uid(.metadata.uid) and typically collected automatically from member cluster during the progress of registration.\n\nThe value is collected in order: 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by\n creating a ClusterProperty object with name 'cluster.clusterset.k8s.io', Karmada would\n take the defined value in the ClusterProperty object.\n See https://github.com/kubernetes-sigs/about-api for more details about ClusterProperty API.\n2. Take the uid of 'kube-system' namespace on the registering cluster.\n\nPlease don't update this value unless you know what you are doing, because it will/may be used to : - uniquely identify the clusters within the Karmada system. - compose the DNS name of multi-cluster services.", + Description: "ID is the unique identifier for the cluster. It is different from the object uid(.metadata.uid) and is typically collected automatically from each member cluster during the process of registration.\n\nThe value is collected in order: 1. If the registering cluster enabled ClusterProperty API and defined the cluster ID by\n creating a ClusterProperty object with name 'cluster.clusterset.k8s.io', Karmada would\n take the defined value in the ClusterProperty object.\n See https://github.com/kubernetes-sigs/about-api for more details about ClusterProperty API.\n2. Take the uid of 'kube-system' namespace on the registering cluster.\n\nPlease don't update this value unless you know what you are doing, because it will/may be used to : - uniquely identify the clusters within the Karmada system. - compose the DNS name of multi-cluster services.", Type: []string{"string"}, Format: "", }, }, "syncMode": { SchemaProps: spec.SchemaProps{ - Description: "SyncMode describes how a cluster sync resources from karmada control plane.", + Description: "SyncMode describes how a cluster syncs resources from karmada control plane.", Default: "", Type: []string{"string"}, Format: "", @@ -1654,13 +1654,13 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterSpec(ref common.ReferenceCallback) }, "secretRef": { SchemaProps: spec.SchemaProps{ - Description: "SecretRef represents the secret contains mandatory credentials to access the member cluster. The secret should hold credentials as follows: - secret.data.token - secret.data.caBundle", + Description: "SecretRef represents the secret that contains mandatory credentials to access the member cluster. The secret should hold credentials as follows: - secret.data.token - secret.data.caBundle", Ref: ref("github.com/karmada-io/karmada/pkg/apis/cluster/v1alpha1.LocalSecretReference"), }, }, "impersonatorSecretRef": { SchemaProps: spec.SchemaProps{ - Description: "ImpersonatorSecretRef represents the secret contains the token of impersonator. The secret should hold credentials as follows: - secret.data.token", + Description: "ImpersonatorSecretRef represents the secret that contains the token of impersonator. The secret should hold credentials as follows: - secret.data.token", Ref: ref("github.com/karmada-io/karmada/pkg/apis/cluster/v1alpha1.LocalSecretReference"), }, }, @@ -1673,14 +1673,14 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterSpec(ref common.ReferenceCallback) }, "proxyURL": { SchemaProps: spec.SchemaProps{ - Description: "ProxyURL is the proxy URL for the cluster. If not empty, the karmada control plane will use this proxy to talk to the cluster. More details please refer to: https://github.com/kubernetes/client-go/issues/351", + Description: "ProxyURL is the proxy URL for the cluster. If not empty, the karmada control plane will use this proxy to talk to the cluster. For more details please refer to: https://github.com/kubernetes/client-go/issues/351", Type: []string{"string"}, Format: "", }, }, "proxyHeader": { SchemaProps: spec.SchemaProps{ - Description: "ProxyHeader is the HTTP header required by proxy server. The key in the key-value pair is HTTP header key and value is the associated header payloads. For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3').", + Description: "ProxyHeader is the HTTP header required by proxy server. The key in the key-value pair is HTTP header key and the value is the associated header payloads. For the header with multiple values, the values should be separated by comma(e.g. 'k1': 'v1,v2,v3').", Type: []string{"object"}, AdditionalProperties: &spec.SchemaOrBool{ Allows: true, @@ -1703,14 +1703,14 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterSpec(ref common.ReferenceCallback) }, "region": { SchemaProps: spec.SchemaProps{ - Description: "Region represents the region of the member cluster locate in.", + Description: "Region represents the region in which the member cluster is located.", Type: []string{"string"}, Format: "", }, }, "zone": { SchemaProps: spec.SchemaProps{ - Description: "Zone represents the zone of the member cluster locate in. Deprecated: This filed was never been used by Karmada, and it will not be removed from v1alpha1 for backward compatibility, use Zones instead.", + Description: "Zone represents the zone in which the member cluster is located. Deprecated: This field was never been used by Karmada, and it will not be removed from v1alpha1 for backward compatibility, use Zones instead.", Type: []string{"string"}, Format: "", }, @@ -1732,7 +1732,7 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterSpec(ref common.ReferenceCallback) }, "taints": { SchemaProps: spec.SchemaProps{ - Description: "Taints attached to the member cluster. Taints on the cluster have the \"effect\" on any resource that does not tolerate the Taint.", + Description: "Taints are attached to the member cluster. Taints on the cluster have the \"effect\" on any resource that does not tolerate the Taint.", Type: []string{"array"}, Items: &spec.SchemaOrArray{ Schema: &spec.Schema{ @@ -1783,7 +1783,7 @@ func schema_pkg_apis_cluster_v1alpha1_ClusterStatus(ref common.ReferenceCallback }, "apiEnablements": { SchemaProps: spec.SchemaProps{ - Description: "APIEnablements represents the list of APIs installed in the member cluster.", + Description: "APIEnablements represents the list of APIs installed on the member cluster.", Type: []string{"array"}, Items: &spec.SchemaOrArray{ Schema: &spec.Schema{ @@ -1861,7 +1861,7 @@ func schema_pkg_apis_cluster_v1alpha1_LocalSecretReference(ref common.ReferenceC }, "name": { SchemaProps: spec.SchemaProps{ - Description: "Name is the name of resource being referenced.", + Description: "Name is the name of the resource being referenced.", Default: "", Type: []string{"string"}, Format: "", @@ -1943,7 +1943,7 @@ func schema_pkg_apis_cluster_v1alpha1_ResourceModelRange(ref common.ReferenceCal return common.OpenAPIDefinition{ Schema: spec.Schema{ SchemaProps: spec.SchemaProps{ - Description: "ResourceModelRange describes the detail of each modeling quota that ranges from min to max. Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. E.g. in an interval, min = 2, max =10 is set, which means the interval [2,10). This rule ensure that all intervals have the same meaning. If the last interval is infinite, it is definitely unreachable. Therefore, we define the right interval as the open interval. For a valid interval, the value on the right is greater than the value on the left, in other words, max must be greater than min. It is strongly recommended that the [Min, Max) of all ResourceModelRanges can make a continuous interval.", + Description: "ResourceModelRange describes the detail of each modeling quota that ranges from min to max. Please pay attention, by default, the value of min can be inclusive, and the value of max cannot be inclusive. E.g. in an interval, min = 2, max = 10 is set, which means the interval [2,10). This rule ensures that all intervals have the same meaning. If the last interval is infinite, it is definitely unreachable. Therefore, we define the right interval as the open interval. For a valid interval, the value on the right is greater than the value on the left, in other words, max must be greater than min. It is strongly recommended that the [Min, Max) of all ResourceModelRanges can make a continuous interval.", Type: []string{"object"}, Properties: map[string]spec.Schema{ "name": {