@@ -10,16 +10,18 @@ Known Issues in the |k8s-op-full|
1010 :depth: 1
1111 :class: singlecol
1212
13- Disable Backups before Deleting a Resource
14- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13+ Deleting a Resource with Backups Removes All Snapshots
14+ ------------------------------------------------------
1515
16- When deleting a resource that has backup configured, you must disable backup first.
16+ When you delete a resource that has backup configured, the
17+ |k8s-op-short| terminates all backups. Deleting a resource removes all
18+ existing snapshots without warning.
1719
1820Configure Persistent Storage Correctly
19- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21+ --------------------------------------
2022
2123If there are no
22- `persistent volumes <https://kubernetes.io/docs/ concepts/storage/persistent-volumes/>`__
24+ :k8sdocs: `persistent volumes </ concepts/storage/persistent-volumes/>`
2325available when you create a resource, the resulting |k8s-pod| stays in
2426transient state and the Operator fails (after 20 retries) with the
2527following error:
@@ -30,15 +32,15 @@ following error:
3032
3133To prevent this error, either:
3234
33- - Provide `persistent volumes <https://kubernetes.io/docs/concepts/storage/persistent-volumes/>`__ or
35+ - Provide |k8s-pvs| or
3436- Set ``persistent : false`` for the resource
3537
3638For testing only, you may also set ``persistent : false``. This
3739*must not be used in production*, as data is not preserved between
3840restarts.
3941
4042Remove Resources before Removing |k8s|
41- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
43+ --------------------------------------
4244
4345Sometimes |onprem| can diverge from |k8s|. This mostly occurs when
4446|k8s| resources are removed manually. |onprem| can keep displaying an
@@ -49,7 +51,7 @@ resource specification to delete resources first so no dead Automation
4951Agents remain.
5052
5153Create Separate Namespaces for |k8s-op-short| and MongoDB Resources
52- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
54+ -------------------------------------------------------------------
5355
5456The best strategy is to create |k8s-op-short| and its resources in
5557different namespaces so that the following operations would work
@@ -71,7 +73,7 @@ This would mean that it could not clean the configurations, which
7173would have to be done in the |application|.
7274
7375Difficulties with Updates
74- ~~~~~~~~~~~~~~~~~~~~~~~~~
76+ -------------------------
7577
7678In some cases, the |k8s-op-short| can stop receiving change events. As
7779this problem is hard to reproduce, the recommended workaround is to
@@ -90,14 +92,14 @@ automatically and starts working correctly:
9092 :doc:`Kubernetes Operator installation </tutorial/install-k8s-operator>`
9193
9294Machine Memory vs. Container Memory
93- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
95+ -----------------------------------
9496
9597MongoDB versions older than 3.6.13, 4.0.9, and 4.1.9 report host system RAM, not
9698container RAM.
9799
98100
99101Changes to Avoid
100- ~~~~~~~~~~~~~~~~
102+ ----------------
101103
102104The |k8s-op-short| will not be able to apply the following change on a MongoDB Deployment simultaneously:
103105
0 commit comments