1
1
---
2
2
title : Server-Side Apply
3
- state : alpha
3
+ state : beta
4
4
alphaVersion : " 1.15"
5
+ betaVersion : " 1.19"
5
6
weight : 300
6
7
---
7
8
@@ -17,6 +18,20 @@ Server-side apply is a Kubernetes feature. Read more about server-side apply in
17
18
the [ Kubernetes documentation] ( https://kubernetes.io/docs/reference/using-api/server-side-apply/ ) .
18
19
{{</hint >}}
19
20
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
+
20
35
## Use server-side apply to sync claims with composite resources
21
36
22
37
When you create a claim, Crossplane creates a corresponding composite resource.
@@ -29,32 +44,22 @@ and how they relate to composite resources.
29
44
Crossplane can use server-side apply to keep the claim in sync with the
30
45
composite resource.
31
46
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
-
41
47
{{<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
43
49
a claim with its counterpart composite resource:
44
50
45
51
- The claim's ` metadata ` syncs to the composite resource's ` metadata ` .
46
52
- The claim's ` spec ` syncs to the composite resource's ` spec ` .
47
53
- The composite resource's ` status ` syncs to the claim's ` status ` .
48
54
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 `
50
56
and ` spec ` back to the claim's ` metadata ` and ` spec ` . It also doesn't sync the
51
57
claim's ` status ` to the composite resource's ` status ` .
52
58
{{</hint >}}
53
59
54
60
## Use server-side apply to sync claims end-to-end
55
61
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.
58
63
59
64
When you use composition functions, Crossplane uses server side apply to sync
60
65
composite resources with composed resources. Read more about this in the
0 commit comments