@@ -428,71 +428,14 @@ spec:
428428 ApplyStrategy describes how to resolve the conflict if the resource to be placed already exists in the target cluster
429429 and is owned by other appliers.
430430 properties :
431- actionType :
432- default : Always
433- description : |-
434- WhenToTakeOver determines the action to take when Fleet applies resources to a member
435- cluster for the first time and finds out that the resource already exists in the cluster.
436-
437-
438- This setting is most relevant in cases where you would like Fleet to manage pre-existing
439- resources on a member cluster.
440-
441-
442- Available options include:
443-
444-
445- * Always: with this action, Fleet will apply the hub cluster manifests to the member
446- clusters even if the affected resources already exist. This is the default action.
447-
448-
449- Note that this might lead to fields being overwritten on the member clusters, if they
450- are specified in the hub cluster manifests.
451-
452-
453- * IfNoDiff: with this action, Fleet will apply the hub cluster manifests to the member
454- clusters if (and only if) pre-existing resources look the same as the hub cluster manifests.
455- This is a safer option as pre-existing resources that are inconsistent with the hub cluster
456- manifests will not be overwritten; in fact, Fleet will ignore them until the inconsistencies
457- are resolved properly: any change you make to the hub cluster manifests would not be
458- applied, and if you delete the manifests or even the ClusterResourcePlacement itself
459- from the hub cluster, these pre-existing resources would not be taken away.
460-
461-
462- Fleet will check for inconsistencies in accordance with the ComparisonOption setting. See also
463- the comments on the ComparisonOption field for more information.
464-
465-
466- If a diff has been found in a field that is **managed** by Fleet (i.e., the field
467- **is specified ** in the hub cluster manifest), consider one of the following actions:
468- * set the field in the member cluster to be of the same value as that in the hub cluster
469- manifest.
470- * update the hub cluster manifest so that its field value matches with that in the member
471- cluster.
472- * switch to the Always action, which will allow Fleet to overwrite the field with the
473- value in the hub cluster manifest.
474-
475-
476- If a diff has been found in a field that is **not managed** by Fleet (i.e., the field
477- **is not specified** in the hub cluster manifest), consider one of the following actions:
478- * remove the field from the member cluster.
479- * update the hub cluster manifest so that the field is included in the hub cluster manifest.
480-
481-
482- If appropriate, you may also delete the object from the member cluster; Fleet will recreate
483- it using the hub cluster manifest.
484- enum :
485- - Always
486- - IfNoDiff
487- type : string
488431 allowCoOwnership :
489432 description : |-
490433 AllowCoOwnership defines whether to apply the resource if it already exists in the target cluster and is not
491434 solely owned by fleet (i.e., metadata.ownerReferences contains only fleet custom resources).
492435 If true, apply the resource and add fleet as a co-owner.
493436 If false, leave the resource unchanged and fail the apply.
494437 type : boolean
495- compareOption :
438+ comparisonOption :
496439 default : PartialComparison
497440 description : |-
498441 ComparisonOption controls how Fleet compares the desired state of a resource, as kept in
@@ -651,6 +594,63 @@ spec:
651594 - Always
652595 - IfNotDrifted
653596 type : string
597+ whenToTakeOver :
598+ default : Always
599+ description : |-
600+ WhenToTakeOver determines the action to take when Fleet applies resources to a member
601+ cluster for the first time and finds out that the resource already exists in the cluster.
602+
603+
604+ This setting is most relevant in cases where you would like Fleet to manage pre-existing
605+ resources on a member cluster.
606+
607+
608+ Available options include:
609+
610+
611+ * Always: with this action, Fleet will apply the hub cluster manifests to the member
612+ clusters even if the affected resources already exist. This is the default action.
613+
614+
615+ Note that this might lead to fields being overwritten on the member clusters, if they
616+ are specified in the hub cluster manifests.
617+
618+
619+ * IfNoDiff: with this action, Fleet will apply the hub cluster manifests to the member
620+ clusters if (and only if) pre-existing resources look the same as the hub cluster manifests.
621+ This is a safer option as pre-existing resources that are inconsistent with the hub cluster
622+ manifests will not be overwritten; in fact, Fleet will ignore them until the inconsistencies
623+ are resolved properly: any change you make to the hub cluster manifests would not be
624+ applied, and if you delete the manifests or even the ClusterResourcePlacement itself
625+ from the hub cluster, these pre-existing resources would not be taken away.
626+
627+
628+ Fleet will check for inconsistencies in accordance with the ComparisonOption setting. See also
629+ the comments on the ComparisonOption field for more information.
630+
631+
632+ If a diff has been found in a field that is **managed** by Fleet (i.e., the field
633+ **is specified ** in the hub cluster manifest), consider one of the following actions:
634+ * set the field in the member cluster to be of the same value as that in the hub cluster
635+ manifest.
636+ * update the hub cluster manifest so that its field value matches with that in the member
637+ cluster.
638+ * switch to the Always action, which will allow Fleet to overwrite the field with the
639+ value in the hub cluster manifest.
640+
641+
642+ If a diff has been found in a field that is **not managed** by Fleet (i.e., the field
643+ **is not specified** in the hub cluster manifest), consider one of the following actions:
644+ * remove the field from the member cluster.
645+ * update the hub cluster manifest so that the field is included in the hub cluster manifest.
646+
647+
648+ If appropriate, you may also delete the object from the member cluster; Fleet will recreate
649+ it using the hub cluster manifest.
650+ enum :
651+ - Always
652+ - IfNoDiff
653+ type : string
654654 type : object
655655 clusterDecision :
656656 description : ClusterDecision explains why the scheduler selected this
0 commit comments