107 lines
5.2 KiB
Markdown
107 lines
5.2 KiB
Markdown
---
|
|
reviewers:
|
|
- brendandburns
|
|
- davidopp
|
|
content_type: concept
|
|
title: Troubleshooting
|
|
---
|
|
|
|
<!-- overview -->
|
|
|
|
Sometimes things go wrong. This guide is aimed at making them right. It has
|
|
two sections:
|
|
|
|
* [Troubleshooting your application](/docs/tasks/debug-application-cluster/debug-application/) - Useful
|
|
for users who are deploying code into Kubernetes and wondering why it is not working.
|
|
* [Troubleshooting your cluster](/docs/tasks/debug-application-cluster/debug-cluster/) - Useful
|
|
for cluster administrators and people whose Kubernetes cluster is unhappy.
|
|
|
|
You should also check the known issues for the [release](https://github.com/kubernetes/kubernetes/releases)
|
|
you're using.
|
|
|
|
<!-- body -->
|
|
|
|
## Getting help
|
|
|
|
If your problem isn't answered by any of the guides above, there are variety of
|
|
ways for you to get help from the Kubernetes community.
|
|
|
|
### Questions
|
|
|
|
The documentation on this site has been structured to provide answers to a wide
|
|
range of questions. [Concepts](/docs/concepts/) explain the Kubernetes
|
|
architecture and how each component works, while [Setup](/docs/setup/) provides
|
|
practical instructions for getting started. [Tasks](/docs/tasks/) show how to
|
|
accomplish commonly used tasks, and [Tutorials](/docs/tutorials/) are more
|
|
comprehensive walkthroughs of real-world, industry-specific, or end-to-end
|
|
development scenarios. The [Reference](/docs/reference/) section provides
|
|
detailed documentation on the [Kubernetes API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
|
|
and command-line interfaces (CLIs), such as [`kubectl`](/docs/reference/kubectl/overview/).
|
|
|
|
## Help! My question isn't covered! I need help now!
|
|
|
|
### Stack Overflow
|
|
|
|
Someone else from the community may have already asked a similar question or may
|
|
be able to help with your problem. The Kubernetes team will also monitor
|
|
[posts tagged Kubernetes](https://stackoverflow.com/questions/tagged/kubernetes).
|
|
If there aren't any existing questions that help, please
|
|
[ask a new one](https://stackoverflow.com/questions/ask?tags=kubernetes)!
|
|
|
|
### Slack
|
|
|
|
Many people from the Kubernetes community hang out on Kubernetes Slack in the `#kubernetes-users` channel.
|
|
Slack requires registration; you can [request an invitation](https://slack.kubernetes.io),
|
|
and registration is open to everyone). Feel free to come and ask any and all questions.
|
|
Once registered, access the [Kubernetes organisation in Slack](https://kubernetes.slack.com)
|
|
via your web browser or via Slack's own dedicated app.
|
|
|
|
Once you are registered, browse the growing list of channels for various subjects of
|
|
interest. For example, people new to Kubernetes may also want to join the
|
|
[`#kubernetes-novice`](https://kubernetes.slack.com/messages/kubernetes-novice) channel. As another example, developers should join the
|
|
[`#kubernetes-dev`](https://kubernetes.slack.com/messages/kubernetes-dev) channel.
|
|
|
|
There are also many country specific / local language channels. Feel free to join
|
|
these channels for localized support and info:
|
|
|
|
{{< table caption="Country / language specific Slack channels" >}}
|
|
Country | Channels
|
|
:---------|:------------
|
|
China | [`#cn-users`](https://kubernetes.slack.com/messages/cn-users), [`#cn-events`](https://kubernetes.slack.com/messages/cn-events)
|
|
Finland | [`#fi-users`](https://kubernetes.slack.com/messages/fi-users)
|
|
France | [`#fr-users`](https://kubernetes.slack.com/messages/fr-users), [`#fr-events`](https://kubernetes.slack.com/messages/fr-events)
|
|
Germany | [`#de-users`](https://kubernetes.slack.com/messages/de-users), [`#de-events`](https://kubernetes.slack.com/messages/de-events)
|
|
India | [`#in-users`](https://kubernetes.slack.com/messages/in-users), [`#in-events`](https://kubernetes.slack.com/messages/in-events)
|
|
Italy | [`#it-users`](https://kubernetes.slack.com/messages/it-users), [`#it-events`](https://kubernetes.slack.com/messages/it-events)
|
|
Japan | [`#jp-users`](https://kubernetes.slack.com/messages/jp-users), [`#jp-events`](https://kubernetes.slack.com/messages/jp-events)
|
|
Korea | [`#kr-users`](https://kubernetes.slack.com/messages/kr-users)
|
|
Netherlands | [`#nl-users`](https://kubernetes.slack.com/messages/nl-users)
|
|
Norway | [`#norw-users`](https://kubernetes.slack.com/messages/norw-users)
|
|
Poland | [`#pl-users`](https://kubernetes.slack.com/messages/pl-users)
|
|
Russia | [`#ru-users`](https://kubernetes.slack.com/messages/ru-users)
|
|
Spain | [`#es-users`](https://kubernetes.slack.com/messages/es-users)
|
|
Sweden | [`#se-users`](https://kubernetes.slack.com/messages/se-users)
|
|
Turkey | [`#tr-users`](https://kubernetes.slack.com/messages/tr-users), [`#tr-events`](https://kubernetes.slack.com/messages/tr-events)
|
|
{{< /table >}}
|
|
|
|
### Forum
|
|
|
|
You're welcome to join the official Kubernetes Forum: [discuss.kubernetes.io](https://discuss.kubernetes.io).
|
|
|
|
### Bugs and feature requests
|
|
|
|
If you have what looks like a bug, or you would like to make a feature request,
|
|
please use the [GitHub issue tracking system](https://github.com/kubernetes/kubernetes/issues).
|
|
|
|
Before you file an issue, please search existing issues to see if your issue is
|
|
already covered.
|
|
|
|
If filing a bug, please include detailed information about how to reproduce the
|
|
problem, such as:
|
|
|
|
* Kubernetes version: `kubectl version`
|
|
* Cloud provider, OS distro, network configuration, and Docker version
|
|
* Steps to reproduce the problem
|
|
|
|
|