11---
22title : Server-Side Apply
3- state : alpha
3+ state : beta
44alphaVersion : " 1.15"
5+ betaVersion : " 1.19"
56weight : 300
67---
78
@@ -17,6 +18,20 @@ Server-side apply is a Kubernetes feature. Read more about server-side apply in
1718the [ Kubernetes documentation] ( https://kubernetes.io/docs/reference/using-api/server-side-apply/ ) .
1819{{</hint >}}
1920
21+ ## Disable server-side apply
22+ <!-- vale write-good.Passive = NO -->
23+ Server-Side Apply is a beta feature. Beta features are enabled by default.
24+ <!-- vale write-good.Passive = YES -->
25+
26+ Disable server-side apply by disabling the ` --enable-ssa-claims ` feature flag.
27+ Read the [ Install Crossplane documentation] ({{<ref "../software/install#feature-flags">}})
28+ to learn about feature flags.
29+
30+ When server-side apply is disabled, you might see fields reappearing after you delete
31+ them from a claim's ` spec ` . Also, Crossplane doesn't delete labels and annotations from
32+ the composite resource when you delete them from the claim.
33+
34+
2035## Use server-side apply to sync claims with composite resources
2136
2237When you create a claim, Crossplane creates a corresponding composite resource.
@@ -29,32 +44,22 @@ and how they relate to composite resources.
2944Crossplane can use server-side apply to keep the claim in sync with the
3045composite resource.
3146
32- Use the ` --enable-ssa-claims ` feature flag to enable using server-side apply.
33- Read the [ Install Crossplane documentation] ({{<ref "../software/install#feature-flags">}})
34- to learn about feature flags.
35-
36- If you see fields reappearing after you delete them from a claim's ` spec ` ,
37- enable server-side apply to fix the problem. Enabling server-side apply also
38- fixes the problem where Crossplane doesn't delete labels and annotations from
39- the composite resource when you delete them from the claim.
40-
4147{{<hint "important">}}
42- When you enable server-side apply, Crossplane is stricter about how it syncs
48+ With server-side apply, Crossplane is stricter about how it syncs
4349a claim with its counterpart composite resource:
4450
4551- The claim's ` metadata ` syncs to the composite resource's ` metadata ` .
4652- The claim's ` spec ` syncs to the composite resource's ` spec ` .
4753- The composite resource's ` status ` syncs to the claim's ` status ` .
4854
49- When you enable server-side apply Crossplane doesn't sync the composite resource's ` metadata `
55+ With server-side apply Crossplane doesn't sync the composite resource's ` metadata `
5056and ` spec ` back to the claim's ` metadata ` and ` spec ` . It also doesn't sync the
5157claim's ` status ` to the composite resource's ` status ` .
5258{{</hint >}}
5359
5460## Use server-side apply to sync claims end-to-end
5561
56- To get the full benefit of server-side apply, use the ` --enable-ssa-claims `
57- feature flag together with composition functions.
62+ To get the full benefit of server-side apply, use it together with composition functions.
5863
5964When you use composition functions, Crossplane uses server side apply to sync
6065composite resources with composed resources. Read more about this in the
0 commit comments