Skip to content

Commit c664ce8

Browse files
authored
Merge pull request #892 from twobiers/fix/server-side-apply-beta
Update server-side apply documentation with beta promotion
2 parents 908f9d5 + 25f9455 commit c664ce8

File tree

1 file changed

+19
-14
lines changed

1 file changed

+19
-14
lines changed

content/v1.19/concepts/server-side-apply.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
11
---
22
title: Server-Side Apply
3-
state: alpha
3+
state: beta
44
alphaVersion: "1.15"
5+
betaVersion: "1.19"
56
weight: 300
67
---
78

@@ -17,6 +18,20 @@ Server-side apply is a Kubernetes feature. Read more about server-side apply in
1718
the [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

2237
When you create a claim, Crossplane creates a corresponding composite resource.
@@ -29,32 +44,22 @@ and how they relate to composite resources.
2944
Crossplane can use server-side apply to keep the claim in sync with the
3045
composite 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
4349
a 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`
5056
and `spec` back to the claim's `metadata` and `spec`. It also doesn't sync the
5157
claim'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

5964
When you use composition functions, Crossplane uses server side apply to sync
6065
composite resources with composed resources. Read more about this in the

0 commit comments

Comments
 (0)