Repository navigation
Commit 55e7f34
authored
## Summary
The troubleshooting step "A namespace stays `Terminating`" still said
that #209 makes a namespace without an eligible control plane hang
forever. #214 fixed that for a namespace that has no `CoderControlPlane`
at all: the aggregated API now answers its list with an empty list.
## What
Step 2 of the section is now three short sentences and two commands,
with no list of cases:
1. If `NamespaceDeletionContentFailure` is `True`, read its message. It
contains the error that the aggregated API returned for the namespace
controller's list, for example a `503` or a `400`.
2. For what each error means, it links [Namespaces without a Coder
backend](https://github.com/coder/coder-k8s/blob/main/docs/reference/aggregated-api-behavior.md#namespaces-without-a-coder-backend)
and the existing "Aggregated reads return `ServiceUnavailable`" entry.
3. If a `CoderControlPlane` is still in the namespace, check its
finalizers (for example `coder.com/workspace-rbac-cleanup`) and the
controller logs.
The note that #214 added under "Aggregated reads return
`ServiceUnavailable`" stays as it is. This change does not repeat it.
## Review rounds
1. Round 1 found four gaps in a list of cases. The second commit fixed
them.
2. Round 2 found three more gaps in that list. Instead of a longer list,
cfc8e16 simplifies the step so that it no longer lists cases.
## Validation
On the pushed tree: `make docs-check` (strict build),
`markdownlint-cli2` 0.18.1, and `cspell` 8.19.4, each with exit 0. The
built page contains both new links.
Refs #209
Refs #215
---
_Generated with [`xum`](https://github.com/coder/xum) • Model:
`anthropic:claude-opus-5-5` • Thinking: `high`_
1 parent bf8019f commit 55e7f34
1 file changed
Lines changed: 2 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
280 | 280 | | |
281 | 281 | | |
282 | 282 | | |
283 | | - | |
| 283 | + | |
284 | 284 | | |
285 | 285 | | |
286 | 286 | | |
| 287 | + | |
287 | 288 | | |
288 | | - | |
289 | | - | |
0 commit comments