Document snag with stringData and server-side apply

kubernetes · Sep 7, 2023 · 285b6fa · 285b6fa
1 parent fd2eeb8
commit 285b6fa
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 0 deletions.
diff --git a/content/en/docs/concepts/configuration/secret.md b/content/en/docs/concepts/configuration/secret.md
@@ -387,6 +387,10 @@ stringData:
   password: t0p-Secret # required field for kubernetes.io/basic-auth
 ```
 
+{{< note >}}
+`stringData` for a Secret does not work well with server-side apply
+{{< /note >}}
+
 The basic authentication Secret type is provided only for convenience.
 You can create an `Opaque` type for credentials used for basic authentication.
 However, using the defined and public Secret type (`kubernetes.io/basic-auth`) helps other
@@ -545,6 +549,10 @@ stringData:
   usage-bootstrap-signing: "true"
 ```
 
+{{< note >}}
+`stringData` for a Secret does not work well with server-side apply
+{{< /note >}}
+
 ## Working with Secrets
 
 ### Creating a Secret

diff --git a/content/en/docs/tasks/configmap-secret/managing-secret-using-config-file.md b/content/en/docs/tasks/configmap-secret/managing-secret-using-config-file.md
@@ -109,6 +109,10 @@ stringData:
     password: <password>
 ```
 
+{{< note >}}
+`stringData` for a Secret does not work well with server-side apply
+{{< /note >}}
+
 When you retrieve the Secret data, the command returns the encoded values,
 and not the plaintext values you provided in `stringData`.
 
@@ -152,6 +156,10 @@ stringData:
   username: administrator
 ```
 
+{{< note >}}
+`stringData` for a Secret does not work well with server-side apply
+{{< /note >}}
+
 The `Secret` object is created as follows:
 
 ```yaml