Skip to content

Commit da9fd6e

Browse files
atsansonejwilliams-mongo
authored andcommitted
(DOCSP-7018): Updated delete resource known issue. (#93)
* (DOCSP-7018): Updated delete resource known issue. * Updated per @mongomoe review.
1 parent 59066bd commit da9fd6e

File tree

2 files changed

+15
-13
lines changed

2 files changed

+15
-13
lines changed

Makefile

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ help:
3636

3737
## Builds this branch's HTML under build/<branch>/html
3838
html:
39-
time giza make html
39+
giza make html
4040

4141

4242
#################################################################
@@ -46,7 +46,7 @@ html:
4646
## Build this branch's HTML files to a fresh build directory
4747
clean-html:
4848
rm -rf build/${GIT_BRANCH}
49-
time giza make html
49+
giza make html
5050

5151

5252
#################################################################

source/reference/known-issues.txt

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -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

1820
Configure Persistent Storage Correctly
19-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21+
--------------------------------------
2022

2123
If there are no
22-
`persistent volumes <https://kubernetes.io/docs/concepts/storage/persistent-volumes/>`__
24+
:k8sdocs:`persistent volumes </concepts/storage/persistent-volumes/>`
2325
available when you create a resource, the resulting |k8s-pod| stays in
2426
transient state and the Operator fails (after 20 retries) with the
2527
following error:
@@ -30,15 +32,15 @@ following error:
3032

3133
To 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

3638
For testing only, you may also set ``persistent : false``. This
3739
*must not be used in production*, as data is not preserved between
3840
restarts.
3941

4042
Remove Resources before Removing |k8s|
41-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
43+
--------------------------------------
4244

4345
Sometimes |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
4951
Agents remain.
5052

5153
Create Separate Namespaces for |k8s-op-short| and MongoDB Resources
52-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
54+
-------------------------------------------------------------------
5355

5456
The best strategy is to create |k8s-op-short| and its resources in
5557
different namespaces so that the following operations would work
@@ -71,7 +73,7 @@ This would mean that it could not clean the configurations, which
7173
would have to be done in the |application|.
7274

7375
Difficulties with Updates
74-
~~~~~~~~~~~~~~~~~~~~~~~~~
76+
-------------------------
7577

7678
In some cases, the |k8s-op-short| can stop receiving change events. As
7779
this 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

9294
Machine Memory vs. Container Memory
93-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
95+
-----------------------------------
9496

9597
MongoDB versions older than 3.6.13, 4.0.9, and 4.1.9 report host system RAM, not
9698
container RAM.
9799

98100

99101
Changes to Avoid
100-
~~~~~~~~~~~~~~~~
102+
----------------
101103

102104
The |k8s-op-short| will not be able to apply the following change on a MongoDB Deployment simultaneously:
103105

0 commit comments

Comments
 (0)