From a56804f417b56714eae918790510c5fcb89f4749 Mon Sep 17 00:00:00 2001 From: Arnaldo de Moraes Pereira Date: Wed, 27 Apr 2016 15:13:23 -0300 Subject: [PATCH] Context on `finalizers` when creating namespaces Minor explanation on `finalizers` when creating namespaces before pointing to the right documentation. --- docs/admin/namespaces/index.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/admin/namespaces/index.md b/docs/admin/namespaces/index.md index 95780559e3..574f41b10a 100644 --- a/docs/admin/namespaces/index.md +++ b/docs/admin/namespaces/index.md @@ -103,17 +103,20 @@ metadata: name: ``` -Note that the name of your namespace must be a DNS compatible label. - -More information on the `finalizers` field can be found in the namespace [design doc](https://github.com/kubernetes/kubernetes/blob/{{page.githubbranch}}/docs/design/namespaces.md#finalizers). - Then run: ```shell $ kubectl create -f ./my-namespace.yaml ``` -## Working in namespaces +Note that the name of your namespace must be a DNS compatible label. + +There's an optional field `finalizers`, which allows observables to purge resources whenever the namespace is deleted. Keep in mind that if you specify a nonexistent finalizer, the namespace will be created but will get stuck in the `Terminating` state if the user tries to delete it. + +More information on `finalizers` can be found in the namespace [design doc](https://github.com/kubernetes/kubernetes/blob/{{page.githubbranch}}/docs/design/namespaces.md#finalizers). + + +### Working in namespaces See [Setting the namespace for a request](/docs/user-guide/namespaces/#setting-the-namespace-for-a-request) and [Setting the namespace preference](/docs/user-guide/namespaces/#setting-the-namespace-preference).