Skip to content

Commit 84c035d

Browse files
authored
Merge pull request #34372 from tengqm/fix-links-1
Batch fixes for links (1)
2 parents 325c4fa + 7add552 commit 84c035d

File tree

8 files changed

+181
-109
lines changed

8 files changed

+181
-109
lines changed

content/en/docs/setup/_index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,4 +67,5 @@ for deploying Kubernetes is [kubeadm](/docs/setup/production-environment/tools/k
6767
Kubernetes is designed for its {{< glossary_tooltip term_id="control-plane" text="control plane" >}} to
6868
run on Linux. Within your cluster you can run applications on Linux or other operating systems, including
6969
Windows.
70-
- Learn to [set up clusters with Windows nodes](/docs/setup/production-environment/windows/)
70+
71+
- Learn to [set up clusters with Windows nodes](/docs/concepts/windows/)

content/en/docs/tasks/administer-cluster/migrating-from-dockershim/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ configuration.
2929

3030
These tasks will help you to migrate:
3131

32-
* [Check whether Dockershim deprecation affects you](/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you/)
32+
* [Check whether Dockershim removal affects you](/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-removal-affects-you/)
3333
* [Migrate Docker Engine nodes from dockershim to cri-dockerd](/docs/tasks/administer-cluster/migrating-from-dockershim/migrate-dockershim-dockerd/)
3434
* [Migrating telemetry and security agents from dockershim](/docs/tasks/administer-cluster/migrating-from-dockershim/migrating-telemetry-and-security-agents/)
3535

content/en/docs/tasks/configure-pod-container/migrate-from-psp.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -323,7 +323,7 @@ configuration of the API server:
323323

324324
To verify that the PodSecurityPolicy admission controller is no longer enabled, you can manually run
325325
a test by impersonating a user without access to any PodSecurityPolicies (see the
326-
[PodSecurityPolicy example](/docs/concepts/policy/pod-security-policy/#example)), or by verifying in
326+
[PodSecurityPolicy example](/docs/concepts/security/pod-security-policy/#example)), or by verifying in
327327
the API server logs. At startup, the API server outputs log lines listing the loaded admission
328328
controller plugins:
329329

content/en/docs/tasks/debug/debug-cluster/_index.md

Lines changed: 61 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,13 @@ kubectl cluster-info dump
3636

3737
### Example: debugging a down/unreachable node
3838

39-
Sometimes when debugging it can be useful to look at the status of a node -- for example, because you've noticed strange behavior of a Pod that's running on the node, or to find out why a Pod won't schedule onto the node. As with Pods, you can use `kubectl describe node` and `kubectl get node -o yaml` to retrieve detailed information about nodes. For example, here's what you'll see if a node is down (disconnected from the network, or kubelet dies and won't restart, etc.). Notice the events that show the node is NotReady, and also notice that the pods are no longer running (they are evicted after five minutes of NotReady status).
39+
Sometimes when debugging it can be useful to look at the status of a node -- for example, because
40+
you've noticed strange behavior of a Pod that's running on the node, or to find out why a Pod
41+
won't schedule onto the node. As with Pods, you can use `kubectl describe node` and `kubectl get
42+
node -o yaml` to retrieve detailed information about nodes. For example, here's what you'll see if
43+
a node is down (disconnected from the network, or kubelet dies and won't restart, etc.). Notice
44+
the events that show the node is NotReady, and also notice that the pods are no longer running
45+
(they are evicted after five minutes of NotReady status).
4046

4147
```shell
4248
kubectl get nodes
@@ -222,60 +228,63 @@ of the relevant log files. On systemd-based systems, you may need to use `journ
222228

223229
### Control Plane nodes
224230

225-
* `/var/log/kube-apiserver.log` - API Server, responsible for serving the API
226-
* `/var/log/kube-scheduler.log` - Scheduler, responsible for making scheduling decisions
227-
* `/var/log/kube-controller-manager.log` - a component that runs most Kubernetes built-in {{<glossary_tooltip text="controllers" term_id="controller">}}, with the notable exception of scheduling (the kube-scheduler handles scheduling).
231+
* `/var/log/kube-apiserver.log` - API Server, responsible for serving the API
232+
* `/var/log/kube-scheduler.log` - Scheduler, responsible for making scheduling decisions
233+
* `/var/log/kube-controller-manager.log` - a component that runs most Kubernetes built-in
234+
{{<glossary_tooltip text="controllers" term_id="controller">}}, with the notable exception of scheduling
235+
(the kube-scheduler handles scheduling).
228236

229237
### Worker Nodes
230238

231-
* `/var/log/kubelet.log` - logs from the kubelet, responsible for running containers on the node
232-
* `/var/log/kube-proxy.log` - logs from `kube-proxy`, which is responsible for directing traffic to Service endpoints
239+
* `/var/log/kubelet.log` - logs from the kubelet, responsible for running containers on the node
240+
* `/var/log/kube-proxy.log` - logs from `kube-proxy`, which is responsible for directing traffic to Service endpoints
233241

234242
## Cluster failure modes
235243

236244
This is an incomplete list of things that could go wrong, and how to adjust your cluster setup to mitigate the problems.
237245

238246
### Contributing causes
239247

240-
- VM(s) shutdown
241-
- Network partition within cluster, or between cluster and users
242-
- Crashes in Kubernetes software
243-
- Data loss or unavailability of persistent storage (e.g. GCE PD or AWS EBS volume)
244-
- Operator error, for example misconfigured Kubernetes software or application software
248+
- VM(s) shutdown
249+
- Network partition within cluster, or between cluster and users
250+
- Crashes in Kubernetes software
251+
- Data loss or unavailability of persistent storage (e.g. GCE PD or AWS EBS volume)
252+
- Operator error, for example misconfigured Kubernetes software or application software
245253

246254
### Specific scenarios
247255

248-
- API server VM shutdown or apiserver crashing
249-
- Results
250-
- unable to stop, update, or start new pods, services, replication controller
251-
- existing pods and services should continue to work normally, unless they depend on the Kubernetes API
252-
- API server backing storage lost
253-
- Results
254-
- the kube-apiserver component fails to start successfully and become healthy
255-
- kubelets will not be able to reach it but will continue to run the same pods and provide the same service proxying
256-
- manual recovery or recreation of apiserver state necessary before apiserver is restarted
257-
- Supporting services (node controller, replication controller manager, scheduler, etc) VM shutdown or crashes
258-
- currently those are colocated with the apiserver, and their unavailability has similar consequences as apiserver
259-
- in future, these will be replicated as well and may not be co-located
260-
- they do not have their own persistent state
261-
- Individual node (VM or physical machine) shuts down
262-
- Results
263-
- pods on that Node stop running
264-
- Network partition
265-
- Results
266-
- partition A thinks the nodes in partition B are down; partition B thinks the apiserver is down. (Assuming the master VM ends up in partition A.)
267-
- Kubelet software fault
268-
- Results
269-
- crashing kubelet cannot start new pods on the node
270-
- kubelet might delete the pods or not
271-
- node marked unhealthy
272-
- replication controllers start new pods elsewhere
273-
- Cluster operator error
274-
- Results
275-
- loss of pods, services, etc
276-
- lost of apiserver backing store
277-
- users unable to read API
278-
- etc.
256+
- API server VM shutdown or apiserver crashing
257+
- Results
258+
- unable to stop, update, or start new pods, services, replication controller
259+
- existing pods and services should continue to work normally, unless they depend on the Kubernetes API
260+
- API server backing storage lost
261+
- Results
262+
- the kube-apiserver component fails to start successfully and become healthy
263+
- kubelets will not be able to reach it but will continue to run the same pods and provide the same service proxying
264+
- manual recovery or recreation of apiserver state necessary before apiserver is restarted
265+
- Supporting services (node controller, replication controller manager, scheduler, etc) VM shutdown or crashes
266+
- currently those are colocated with the apiserver, and their unavailability has similar consequences as apiserver
267+
- in future, these will be replicated as well and may not be co-located
268+
- they do not have their own persistent state
269+
- Individual node (VM or physical machine) shuts down
270+
- Results
271+
- pods on that Node stop running
272+
- Network partition
273+
- Results
274+
- partition A thinks the nodes in partition B are down; partition B thinks the apiserver is down.
275+
(Assuming the master VM ends up in partition A.)
276+
- Kubelet software fault
277+
- Results
278+
- crashing kubelet cannot start new pods on the node
279+
- kubelet might delete the pods or not
280+
- node marked unhealthy
281+
- replication controllers start new pods elsewhere
282+
- Cluster operator error
283+
- Results
284+
- loss of pods, services, etc
285+
- lost of apiserver backing store
286+
- users unable to read API
287+
- etc.
279288

280289
### Mitigations
281290

@@ -308,9 +317,13 @@ This is an incomplete list of things that could go wrong, and how to adjust your
308317

309318
## {{% heading "whatsnext" %}}
310319

311-
* Learn about the metrics available in the [Resource Metrics Pipeline](resource-metrics-pipeline)
312-
* Discover additional tools for [monitoring resource usage](resource-usage-monitoring)
313-
* Use Node Problem Detector to [monitor node health](monitor-node-health)
314-
* Use `crictl` to [debug Kubernetes nodes](crictl)
315-
* Get more information about [Kubernetes auditing](audit)
316-
* Use `telepresence` to [develop and debug services locally](local-debugging)
320+
* Learn about the metrics available in the
321+
[Resource Metrics Pipeline](/docs/tasks/debug/debug-cluster/resource-metrics-pipeline/)
322+
* Discover additional tools for
323+
[monitoring resource usage](/docs/tasks/debug/debug-cluster/resource-usage-monitoring/)
324+
* Use Node Problem Detector to
325+
[monitor node health](/docs/tasks/debug/debug-cluster/monitor-node-health/)
326+
* Use `crictl` to [debug Kubernetes nodes](/docs/tasks/debug/debug-cluster/crictl/)
327+
* Get more information about [Kubernetes auditing](/docs/tasks/debug/debug-cluster/audit/)
328+
* Use `telepresence` to [develop and debug services locally](/docs/tasks/debug/debug-cluster/local-debugging/)
329+

content/en/docs/tasks/debug/debug-cluster/windows.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ content_type: concept
1717
1. My Pods are stuck at "Container Creating" or restarting over and over
1818

1919
Ensure that your pause image is compatible with your Windows OS version.
20-
See [Pause container](/docs/setup/production-environment/windows/intro-windows-in-kubernetes#pause-container)
20+
See [Pause container](/docs/concepts/windows/intro/#pause-container)
2121
to see the latest / recommended pause image and/or get more information.
2222

2323
{{< note >}}
@@ -32,7 +32,7 @@ content_type: concept
3232
Windows Node.
3333

3434
More information on how to specify a compatible node for your Pod can be found in
35-
[this guide](/docs/setup/production-environment/windows/user-guide-windows-containers/#ensuring-os-specific-workloads-land-on-the-appropriate-container-host).
35+
[this guide](/docs/concepts/windows/user-guide/#ensuring-os-specific-workloads-land-on-the-appropriate-container-host).
3636

3737
## Network troubleshooting {#troubleshooting-network}
3838

@@ -102,8 +102,8 @@ content_type: concept
102102
Get-NetAdapter | ? Name -Like "vEthernet (Ethernet*"
103103
```
104104

105-
Often it is worthwhile to modify the [InterfaceName](https://github.com/microsoft/SDN/blob/master/Kubernetes/flannel/start.ps1#L7) parameter of the `start.ps1` script,
106-
in cases where the host's network adapter isn't "Ethernet".
105+
Often it is worthwhile to modify the [InterfaceName](https://github.com/microsoft/SDN/blob/master/Kubernetes/flannel/start.ps1#L7)
106+
parameter of the `start.ps1` script, in cases where the host's network adapter isn't "Ethernet".
107107
Otherwise, consult the output of the `start-kubelet.ps1` script to see if there are errors during virtual network creation.
108108

109109
1. DNS resolution is not properly working
@@ -112,9 +112,11 @@ content_type: concept
112112

113113
1. `kubectl port-forward` fails with "unable to do port forwarding: wincat not found"
114114

115-
This was implemented in Kubernetes 1.15 by including `wincat.exe` in the pause infrastructure container `mcr.microsoft.com/oss/kubernetes/pause:3.6`.
115+
This was implemented in Kubernetes 1.15 by including `wincat.exe` in the pause infrastructure container
116+
`mcr.microsoft.com/oss/kubernetes/pause:3.6`.
116117
Be sure to use a supported version of Kubernetes.
117-
If you would like to build your own pause infrastructure container be sure to include [wincat](https://github.com/kubernetes/kubernetes/tree/master/build/pause/windows/wincat).
118+
If you would like to build your own pause infrastructure container be sure to include
119+
[wincat](https://github.com/kubernetes/kubernetes/tree/master/build/pause/windows/wincat).
118120

119121
1. My Kubernetes installation is failing because my Windows Server node is behind a proxy
120122

@@ -170,4 +172,5 @@ If these steps don't resolve your problem, you can get help running Windows cont
170172

171173
* StackOverflow [Windows Server Container](https://stackoverflow.com/questions/tagged/windows-server-container) topic
172174
* Kubernetes Official Forum [discuss.kubernetes.io](https://discuss.kubernetes.io/)
173-
* Kubernetes Slack [#SIG-Windows Channel](https://kubernetes.slack.com/messages/sig-windows)
175+
* Kubernetes Slack [#SIG-Windows Channel](https://kubernetes.slack.com/messages/sig-windows)
176+

0 commit comments

Comments
 (0)