diff --git a/docs/content/en/references/backups_v1alpha1_types.html b/docs/content/en/references/backups_v1alpha1_types.html index 80f925adf..79165f90f 100644 --- a/docs/content/en/references/backups_v1alpha1_types.html +++ b/docs/content/en/references/backups_v1alpha1_types.html @@ -464,10 +464,8 @@

Destination -(Optional) -

Fleet represents the name of a fleet which determines a set of clusters. -If Fleet is set, it will be used to determine the target clusters. -If users wish to specify clusters directly, they can use the Clusters field.

+

Fleet represents the name of a fleet which determines a set of target clusters within the namespace. +This field is required to identify the context for cluster selection.

@@ -481,9 +479,8 @@

Destination (Optional) -

Clusters allows users to directly specify a set of destination clusters. -It should be used exclusively to select clusters described within the Fleet. -If Fleet is set, it takes precedence over the Clusters field.

+

Clusters allows users to specify a subset of clusters within the selected fleet for targeted operations. +If not set, it implies that the operation is targeted at all clusters within the specified fleet.

diff --git a/manifests/charts/fleet-manager/crds/backup.kurator.dev_backups.yaml b/manifests/charts/fleet-manager/crds/backup.kurator.dev_backups.yaml index b07cfee78..20c986207 100644 --- a/manifests/charts/fleet-manager/crds/backup.kurator.dev_backups.yaml +++ b/manifests/charts/fleet-manager/crds/backup.kurator.dev_backups.yaml @@ -51,10 +51,10 @@ spec: be performed. properties: clusters: - description: Clusters allows users to directly specify a set of - destination clusters. It should be used exclusively to select - clusters described within the Fleet. If Fleet is set, it takes - precedence over the Clusters field. + description: Clusters allows users to specify a subset of clusters + within the selected fleet for targeted operations. If not set, + it implies that the operation is targeted at all clusters within + the specified fleet. items: description: "ObjectReference contains enough information to let you inspect or modify the referred object. --- New uses @@ -120,10 +120,11 @@ spec: type: array fleet: description: Fleet represents the name of a fleet which determines - a set of clusters. If Fleet is set, it will be used to determine - the target clusters. If users wish to specify clusters directly, - they can use the Clusters field. + a set of target clusters within the namespace. This field is + required to identify the context for cluster selection. type: string + required: + - fleet type: object policy: description: Policy are the rules defining how backups should be performed. diff --git a/manifests/charts/fleet-manager/crds/backup.kurator.dev_migrates.yaml b/manifests/charts/fleet-manager/crds/backup.kurator.dev_migrates.yaml index df4c3b8b3..80f46837b 100644 --- a/manifests/charts/fleet-manager/crds/backup.kurator.dev_migrates.yaml +++ b/manifests/charts/fleet-manager/crds/backup.kurator.dev_migrates.yaml @@ -314,10 +314,10 @@ spec: to one or more TargetCluster. properties: clusters: - description: Clusters allows users to directly specify a set of - destination clusters. It should be used exclusively to select - clusters described within the Fleet. If Fleet is set, it takes - precedence over the Clusters field. + description: Clusters allows users to specify a subset of clusters + within the selected fleet for targeted operations. If not set, + it implies that the operation is targeted at all clusters within + the specified fleet. items: description: "ObjectReference contains enough information to let you inspect or modify the referred object. --- New uses @@ -383,19 +383,20 @@ spec: type: array fleet: description: Fleet represents the name of a fleet which determines - a set of clusters. If Fleet is set, it will be used to determine - the target clusters. If users wish to specify clusters directly, - they can use the Clusters field. + a set of target clusters within the namespace. This field is + required to identify the context for cluster selection. type: string + required: + - fleet type: object targetCluster: description: TargetCluster represents the target clusters for migration. properties: clusters: - description: Clusters allows users to directly specify a set of - destination clusters. It should be used exclusively to select - clusters described within the Fleet. If Fleet is set, it takes - precedence over the Clusters field. + description: Clusters allows users to specify a subset of clusters + within the selected fleet for targeted operations. If not set, + it implies that the operation is targeted at all clusters within + the specified fleet. items: description: "ObjectReference contains enough information to let you inspect or modify the referred object. --- New uses @@ -461,10 +462,11 @@ spec: type: array fleet: description: Fleet represents the name of a fleet which determines - a set of clusters. If Fleet is set, it will be used to determine - the target clusters. If users wish to specify clusters directly, - they can use the Clusters field. + a set of target clusters within the namespace. This field is + required to identify the context for cluster selection. type: string + required: + - fleet type: object required: - sourceCluster diff --git a/manifests/charts/fleet-manager/crds/backup.kurator.dev_restores.yaml b/manifests/charts/fleet-manager/crds/backup.kurator.dev_restores.yaml index baaa35348..6701a7af2 100644 --- a/manifests/charts/fleet-manager/crds/backup.kurator.dev_restores.yaml +++ b/manifests/charts/fleet-manager/crds/backup.kurator.dev_restores.yaml @@ -51,10 +51,10 @@ spec: will perform restore. properties: clusters: - description: Clusters allows users to directly specify a set of - destination clusters. It should be used exclusively to select - clusters described within the Fleet. If Fleet is set, it takes - precedence over the Clusters field. + description: Clusters allows users to specify a subset of clusters + within the selected fleet for targeted operations. If not set, + it implies that the operation is targeted at all clusters within + the specified fleet. items: description: "ObjectReference contains enough information to let you inspect or modify the referred object. --- New uses @@ -120,10 +120,11 @@ spec: type: array fleet: description: Fleet represents the name of a fleet which determines - a set of clusters. If Fleet is set, it will be used to determine - the target clusters. If users wish to specify clusters directly, - they can use the Clusters field. + a set of target clusters within the namespace. This field is + required to identify the context for cluster selection. type: string + required: + - fleet type: object policy: description: Policy defines the customization rules for the restore. diff --git a/pkg/apis/backups/v1alpha1/common_type.go b/pkg/apis/backups/v1alpha1/common_type.go index 8a0a58eb2..68faacdea 100644 --- a/pkg/apis/backups/v1alpha1/common_type.go +++ b/pkg/apis/backups/v1alpha1/common_type.go @@ -23,15 +23,13 @@ import ( // Destination defines a target set of clusters, either through a fleet or by specifying them directly. type Destination struct { - // Fleet represents the name of a fleet which determines a set of clusters. - // If Fleet is set, it will be used to determine the target clusters. - // If users wish to specify clusters directly, they can use the Clusters field. - // +optional - Fleet string `json:"fleet,omitempty"` + // Fleet represents the name of a fleet which determines a set of target clusters within the namespace. + // This field is required to identify the context for cluster selection. + // +required + Fleet string `json:"fleet"` - // Clusters allows users to directly specify a set of destination clusters. - // It should be used exclusively to select clusters described within the Fleet. - // If Fleet is set, it takes precedence over the Clusters field. + // Clusters allows users to specify a subset of clusters within the selected fleet for targeted operations. + // If not set, it implies that the operation is targeted at all clusters within the specified fleet. // +optional Clusters []*corev1.ObjectReference `json:"clusters,omitempty"` }