Skip to content

Commit

Permalink
Fixing links between pages. (kubernetes#1869)
Browse files Browse the repository at this point in the history
* Fixing links between pages.

* Address review comments.
  • Loading branch information
foxish authored Dec 6, 2016
1 parent 61c17e6 commit a79d620
Show file tree
Hide file tree
Showing 5 changed files with 17 additions and 7 deletions.
6 changes: 4 additions & 2 deletions docs/tasks/manage-stateful-set/debugging-a-statefulset.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ In order to list all the pods which belong to a StatefulSet, which have a label
kubectl get pods -l app=myapp
```

If you find that any Pods listed are in `Unknown` or `Terminating` state for an extended period of time, refer to the [Deleting StatefulSet Pods](/docs/tasks/stateful-sets/deleting-pods/) task for instructions on how to deal with them. You can debug individual Pods in a StatefulSet using the [Debugging Pods](/docs/user-guide/debugging-pods-and-replication-controllers/#debugging-pods) guide.
If you find that any Pods listed are in `Unknown` or `Terminating` state for an extended period of time, refer to the [Deleting StatefulSet Pods](/docs/tasks/manage-stateful-set/delete-pods/) task for instructions on how to deal with them. You can debug individual Pods in a StatefulSet using the [Debugging Pods](/docs/user-guide/debugging-pods-and-replication-controllers/#debugging-pods) guide.

StatefulSets provide a debug mechanism to pause all controller operations on Pods using an annotation. Setting the `pod.alpha.kubernetes.io/initialized` annotation to `"false"` on any StatefulSet Pod will *pause* all operations of the StatefulSet. When paused, the StatefulSet will not perform any scaling operations. Once the debug hook is set, you can execute commands within the containers of StatefulSet pods without interference from scaling operations. You can set the annotation to `"false"` by executing the following:

Expand Down Expand Up @@ -77,7 +77,9 @@ kubectl annotate pods <pod-name> pod.alpha.kubernetes.io/initialized="true" --ov
{% endcapture %}

{% capture whatsnext %}
Learn more about debugging an init-container. *TODO: Link to Task: Debugging an init-container*

Learn more about [debugging an init-container](/docs/tasks/troubleshoot/debug-init-containers/).

{% endcapture %}

{% include templates/task.md %}
4 changes: 3 additions & 1 deletion docs/tasks/manage-stateful-set/delete-pods.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,9 @@ Always perform force deletion of StatefulSet Pods carefully and with complete kn
{% endcapture %}

{% capture whatsnext %}
Learn more about debugging a StatefulSet. *TODO: Link to the task for debugging a StatefulSet*

Learn more about [debugging a StatefulSet](/docs/tasks/manage-stateful-set/debugging-a-statefulset/).

{% endcapture %}

{% include templates/task.md %}
6 changes: 4 additions & 2 deletions docs/tasks/manage-stateful-set/deleting-a-statefulset.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,12 +73,14 @@ In the example above, the Pods have the label `app=myapp`; substitute your own l

#### Force deletion of StatefulSet pods

If you find that some pods in your StatefulSet are stuck in the 'Terminating' or 'Unknown' states for an extended period of time, you may need to manually intervene to forcefully delete the pods from the apiserver. This is a potentially dangerous task. Refer to [Deleting StatefulSet Pods](/docs/tasks/stateful-sets/deleting-pods/) for details.
If you find that some pods in your StatefulSet are stuck in the 'Terminating' or 'Unknown' states for an extended period of time, you may need to manually intervene to forcefully delete the pods from the apiserver. This is a potentially dangerous task. Refer to [Deleting StatefulSet Pods](/docs/tasks/manage-stateful-set/delete-pods/) for details.

{% endcapture %}

{% capture whatsnext %}
Learn more about debugging a StatefulSet. *TODO: Link to the task for debugging a StatefulSet*

Learn more about [force deleting StatefulSet Pods](/docs/tasks/manage-stateful-set/delete-pods/).

{% endcapture %}

{% include templates/task.md %}
4 changes: 3 additions & 1 deletion docs/tasks/manage-stateful-set/scale-stateful-set.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,9 @@ completely healthy.
{% endcapture %}

{% capture whatsnext %}
*TODO: link to other docs about StatefulSet?*

Learn more about [deleting a StatefulSet](/docs/tasks/manage-stateful-set/deleting-a-statefulset/).

{% endcapture %}

{% include templates/task.md %}
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,9 @@ are created to adopt PetSets' Pods.
{% endcapture %}

{% capture whatsnext %}
Learn more about debugging a StatefulSet. *TODO: Link to the task for debugging a StatefulSet.*

Learn more about [scaling a StatefulSet](/docs/tasks/manage-stateful-set/scale-stateful-set/).

{% endcapture %}

{% include templates/task.md %}

0 comments on commit a79d620

Please sign in to comment.